|
Oracle Fusion Middleware User Messaging Service 11.1.1.6.0 Java API Reference E14011-04 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Address
Address
represents an address in the SDP Messaging. It
has three main attributes - an address type (such as Email, Phone number,
URL, etc.), a delivery type (such as Email, SMS, EMS, MMS, WAP Push, etc.)
and the actual address value. An Address
can have an optional
name which may be used for display purposes.
An Address
can also have a failover Address
-
The failover address is used if message delivery to this address fails or
times out. For example: The home phone number could be the failover address
of the office phone. The home phone number will be called if and only if the
call to the office number is not successful.
To create basic Address objects (with delivery type and address value), use
the MessagingFactory
. Then use the various setters to set additional
information.
Field Summary | |
---|---|
static java.lang.String |
ASSOCIATED_KEY
Pre-defined meta data key name for Associated Key. |
static java.lang.String |
CARRIER
Pre-defined meta data key name for Carrier. |
static java.lang.String |
EMAIL_MODE
Pre-defined meta data key name for Email Mode. |
static java.lang.String |
EMAIL_MODE_BCC
Pre-defined meta data value for Bcc Email Mode. |
static java.lang.String |
EMAIL_MODE_CC
Pre-defined meta data value for Cc Email Mode. |
static java.lang.String |
EMAIL_MODE_TO
Pre-defined meta data value for To Email Mode. |
static java.lang.String |
ENCODING
Pre-defined meta data key name for charset encoding. |
static int |
MAX_ADDRESS_LENGTH
|
static int |
MAX_ASSOCIATED_KEY_LENGTH
|
static int |
MAX_DELIVERY_TYPE_LENGTH
|
static int |
MAX_NAME_LENGTH
|
static java.lang.String |
NAME
Pre-defined meta data key name for Name. |
Fields inherited from interface oracle.sdp.messaging.MessagingObject |
---|
METADATA_APPLICATION_NAME, NAMESPACE_NOTIFICATION_PREFERENCES, NAMESPACE_SDPM, NAMESPACE_UMS |
Method Summary | |
---|---|
java.lang.Object |
clone()
|
AddressType |
getAddressType()
Get the address type. |
java.lang.String |
getCarrier()
Get the address carrier. |
DeliveryType |
getDeliveryType()
Get the delivery type of this address. |
java.lang.String |
getEncoding()
Get the charset encoding for the device of this address. |
Address |
getFailoverAddress()
Get the failover address. |
java.lang.String |
getName()
Get the (optional) name of the address owner. |
java.lang.String |
getNormalizedValue()
Get the normalized address value based on the address type and delivery type of this address. |
StatusType |
getSuccessStatusType()
Get the desired success status type for this address. |
int |
getTimeout()
Get the delivery timeout in seconds. |
java.lang.String |
getValue()
Get the address value. |
void |
setAddressType(AddressType type)
Set the address type. |
void |
setCarrier(java.lang.String carrier)
Set the (optional) address carrier. |
void |
setDeliveryType(DeliveryType deliveryType)
Set the delivery type of this address. |
void |
setEncoding(java.lang.String encoding)
Set the (optional) charset encoding for the device of this address. |
void |
setFailoverAddress(Address addr)
Set failover address. |
void |
setName(java.lang.String name)
Set the (optional) name of the address owner. |
void |
setSuccessStatusType(StatusType successStatusType)
Set the desired success status type for this address. |
void |
setTimeout(int seconds)
Set the delivery timeout in seconds. |
void |
setValue(java.lang.String value)
Set the address value. |
java.lang.String |
toExternalFormat()
Get a string representation of this address, ie. |
Methods inherited from interface oracle.sdp.messaging.MessagingObject |
---|
getAllNamespaces, getMetaData, getMetaDataNames, setMetaData |
Field Detail |
---|
static final java.lang.String ASSOCIATED_KEY
static final java.lang.String CARRIER
static final java.lang.String EMAIL_MODE
static final java.lang.String EMAIL_MODE_BCC
static final java.lang.String EMAIL_MODE_CC
static final java.lang.String EMAIL_MODE_TO
static final java.lang.String ENCODING
static final int MAX_ADDRESS_LENGTH
static final int MAX_ASSOCIATED_KEY_LENGTH
static final int MAX_DELIVERY_TYPE_LENGTH
static final int MAX_NAME_LENGTH
static final java.lang.String NAME
Method Detail |
---|
java.lang.Object clone() throws java.lang.CloneNotSupportedException
java.lang.CloneNotSupportedException
AddressType getAddressType()
java.lang.String getCarrier()
DeliveryType getDeliveryType()
java.lang.String getEncoding()
Address getFailoverAddress()
null
if none is set.java.lang.String getName()
java.lang.String getNormalizedValue()
getValue()
.
StatusType getSuccessStatusType()
int getTimeout()
java.lang.String getValue()
void setAddressType(AddressType type)
AddressType
.
type
- the address type.void setCarrier(java.lang.String carrier)
carrier
- the address carrier.void setDeliveryType(DeliveryType deliveryType)
DeliveryType
.
deliveryType
- the delivery type.void setEncoding(java.lang.String encoding)
encoding
- the charset encoding.void setFailoverAddress(Address addr)
addr
- the failover address.setSuccessStatusType(StatusType)
,
setTimeout(int)
void setName(java.lang.String name)
name
- the optional name of the address owner.void setSuccessStatusType(StatusType successStatusType)
The default success status type used by the system, if not set, is
StatusType.DELIVERY_TO_GATEWAY_SUCCESS
.
If the successStatusType is not set to a "SUCCESS" status type, the system will ignore this value and use the default success status type mentioned above.
successStatusType
- the desired success status type.setTimeout(int)
void setTimeout(int seconds)
setSuccessStatusType(StatusType)
) within the specified
timeout period, the system will failover to the next address in the
failover chain (if available).
Note: If no timeout is set, the system will only perform status-triggered failover as and when a "FAILURE" status at or below the desired "SUCCESS" level is received.
seconds
- the timeout value in seconds.setSuccessStatusType(StatusType)
void setValue(java.lang.String value)
value
- the address value as a string.java.lang.String toExternalFormat()
deliveryType
:address
"
Failover addresses are comma-separated.
|
Oracle Fusion Middleware User Messaging Service 11.1.1.6.0 Java API Reference E14011-04 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |