oracle.cabo.ui.data.bind
Class MailToBoundValue

java.lang.Object
  |
  +--oracle.cabo.ui.data.bind.MailToBoundValue

All Implemented Interfaces:

BoundValue

public class MailToBoundValue

extends java.lang.Object

implements BoundValue

A BoundValue class that creates "mailto:" URLs. This BoundValue supports creating URLs containing the following fields:

• "to": Sets the "to" address. Multiple addresses can be included, and should be comma separated. This value is required, and may not be omitted. When databound, the return value can be an array of strings.
• "cc": Sets the "cc" address. Multiple addresses can be included, and should be comma separated. When databound, the return value can be an array of strings.
• "subject": Sets the subject of the mail message.
• "body": Sets the body of the mail message.

All of these values can be databound using the "binding" methods. Also, these values do not need any special URL encoding - MailToBoundValue and the rest of UIX will ensure that all characters are correctly encoded (including carriage-returns in the body). However, browsers and mail readers have extremely poor NLS support for the mailto: protocol. Developers that need to send correctly localized messages should use server-side SMTP mail code, not the mailto: protocol. Furthermore, mailto: messages are just as limited by URL length as any other protocol, so it is not possible to pre-fill the body of a mail message with even a moderate amount of text.

Constructor Summary

MailToBoundValue()
Creates a MailToBoundValue.

Method Summary

java.lang.String	getBody() Returns the message body.
java.lang.String	getCc() Returns the "cc" address.
java.lang.String	getSubject() Returns the message subject.
java.lang.String	getTo() Returns the "to" address.
java.lang.Object	getValue(RenderingContext context) Returns the full URL.
void	setBody(java.lang.String body) Sets the message body.
void	setBodyBinding(BoundValue bodyBinding) Binds the message body to be dynamically computed.
void	setCc(java.lang.String cc) Sets the "cc" address.
void	setCcBinding(BoundValue ccBinding) Binds the "cc" address to be dynamically computed.
void	setSubject(java.lang.String subject) Sets the message subject.
void	setSubjectBinding(BoundValue subjectBinding) Binds the message subject to be dynamically computed.
void	setTo(java.lang.String to) Sets the "to" address.
void	setToBinding(BoundValue toBinding) Binds the "to" address to be dynamically computed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MailToBoundValue

public MailToBoundValue()

Creates a MailToBoundValue.

Method Detail

getTo

public java.lang.String getTo()

Returns the "to" address.

setTo

public void setTo(java.lang.String to)

Sets the "to" address. This value is required, and may not be omitted.

setToBinding

public void setToBinding(BoundValue toBinding)

Binds the "to" address to be dynamically computed. The BoundValue can return either a single String or an array of Strings.

getCc

public java.lang.String getCc()

Returns the "cc" address.

setCc

public void setCc(java.lang.String cc)

Sets the "cc" address.

setCcBinding

public void setCcBinding(BoundValue ccBinding)

Binds the "cc" address to be dynamically computed. The BoundValue can return either a single String or an array of Strings.

getSubject

public java.lang.String getSubject()

Returns the message subject.

setSubject

public void setSubject(java.lang.String subject)

Sets the message subject.

setSubjectBinding

public void setSubjectBinding(BoundValue subjectBinding)

Binds the message subject to be dynamically computed. The BoundValue should return a String.

getBody

public java.lang.String getBody()

Returns the message body.

setBody

public void setBody(java.lang.String body)

Sets the message body.

setBodyBinding

public void setBodyBinding(BoundValue bodyBinding)

Binds the message body to be dynamically computed. The BoundValue should return a String.

getValue

public java.lang.Object getValue(RenderingContext context)

Returns the full URL.

Specified by:

getValue in interface BoundValue

Following copied from interface: oracle.cabo.ui.data.BoundValue

Parameters:

context - the rendering context