oracle.sdp.messaging
Interface MessagingObject

All Superinterfaces:

Serializable

All Known Subinterfaces:

AccessPoint, Address, Message, Status, Status

public interface MessagingObject
extends Serializable

This is the base type for all primary messaging related object types, namely Message, Status and Address. It defines methods to set and get meta data name-value pairs that can be associated with a concrete messaging object. The meta data is used in varying contexts depending on the type. For instance, rule-based preference facts set by applications as meta data in the Message object are used by the Messaging engine and Notification Preferences server for rule-based message delivery. Meta data are stored in one or multiple namespaces. A namespace hosts meta data name-value pairs. The namespace is NOT case sensitive. Meta data name IS case sensitive.

Namespaces starting with 'UMS' and 'SDPM' are reserved by the User Messaging Service.
Namespaces starting with 'NP' are reserved by the Notification Preferences.
The pre-defined constants NAMESPACE_UMS, NAMESPACE_SDPM and NAMESPACE_NOTIFICATION_PREFERENCES are available for convenience to avoid hard dependency on the actual value.

Since:

11.0.0

Field Summary

static java.lang.String	METADATA_APPLICATION_NAME The pre-defined metadata name for Application Name.
static java.lang.String	NAMESPACE_NOTIFICATION_PREFERENCES The pre-defined namespace for Rule-driven Notification Preferences.
static java.lang.String	NAMESPACE_SDPM A pre-defined namespace for UMS.
static java.lang.String	NAMESPACE_UMS A pre-defined namespace for UMS.

Method Summary

Set<java.lang.String>	getAllNamespaces() Get all namespaces.
java.lang.String	getMetaData(java.lang.String namespace, java.lang.String name) Get meta data value by name.
Set<java.lang.String>	getMetaDataNames(java.lang.String namespace) Get all meta data names.
void	setMetaData(java.lang.String namespace, java.lang.String name, java.lang.String value) Set meta data value by name.

Field Detail

NAMESPACE_UMS

static final java.lang.String NAMESPACE_UMS

A pre-defined namespace for UMS.

See Also:

Constant Field Values

NAMESPACE_SDPM

static final java.lang.String NAMESPACE_SDPM

A pre-defined namespace for UMS.

See Also:

Constant Field Values

NAMESPACE_NOTIFICATION_PREFERENCES

static final java.lang.String NAMESPACE_NOTIFICATION_PREFERENCES

The pre-defined namespace for Rule-driven Notification Preferences.

See Also:

Constant Field Values

METADATA_APPLICATION_NAME

static final java.lang.String METADATA_APPLICATION_NAME

The pre-defined metadata name for Application Name.

See Also:

Constant Field Values

Method Detail

setMetaData

void setMetaData(java.lang.String namespace,
                 java.lang.String name,
                 java.lang.String value)

Set meta data value by name.

Parameters:

namespace - namespace is NOT case sensitive and cannot be null. 'foo', 'Foo' and 'FOO' are refering to the namespace.

name - name IS case sensitive and cannot be null. 'foo', 'Foo' and 'FOO' are refering to different meta data names.

value - the value of the meta data.

getMetaData

java.lang.String getMetaData(java.lang.String namespace,
                             java.lang.String name)

Get meta data value by name.

Parameters:

namespace - namespace is NOT case sensitive and cannot be null. 'foo', 'Foo' and 'FOO' are refering to the namespace.

name - name IS case sensitive and cannot be null. 'foo', 'Foo' and 'FOO' are refering to different meta data names.

Returns:

value of the meta data name.

getMetaDataNames

Set<java.lang.String> getMetaDataNames(java.lang.String namespace)

Get all meta data names.

Parameters:

namespace - namespace is NOT case sensitive and cannot be null. 'foo', 'Foo' and 'FOO' are refering to the namespace.

Returns:

all names of meta data of the current object.

getAllNamespaces

Set<java.lang.String> getAllNamespaces()

Get all namespaces.

Returns:

all namespaces (in upper case) of meta data of the current object