com.sapportals.wcm.service.notificator

Interface INotificatorService

All Superinterfaces:

IService

public interface INotificatorService

extends IService

Interface to the notification service.

A notificator allows the sending of notification s to a recipient via a given channel .
A notification represents some kind of message (e.g. a html-text). A recipient is a destination (e.g. a person) to send the message to. The channel specifies the transport mechanism to use (e.g. eMail).

Copyright 2004 SAP AG

Field Summary

static String	ENCODING_DEFAULT default encoding to use, when transforming Streams into Strings.
static String	NOTIFICATOR_SERVICE Service ID
static String	SUBSCRIPTION_NOTIFICATION id for SUBSCRIPTION notificiation: a subscription generated an event.
static String	SUBSCRIPTIONADMIN_NOTIFICATION id for SUBSCRIPTIONADMIN notification: a subscription was created/deleted or resources have been added to / removed from a subscription.
static String	SUBSCRIPTIONBUNDLED_NOTIFICATION id for SUBSCRIPTIONBUNDLED notificiation: a polling event trigged one or more notifications.
static String	WORKFLOW_NOTIFICATION id for WORKFLOW notification: a document state changed and someone has to do something (a workflow task is started)...
static String	WORKFLOWRESULT_NOTIFICATION id for WORKFLOWRESULT notification: someone did something with a workflow document (a workflow task is completed).

Method Summary

Collection	getChannels() Get a list of available channels for this notificator.
String	getDefaultFromAddress(IChannel channel) Get the default from address for a channel.
void	send(IRecipient recipient, IChannel channel, INotification notification) Send a notification to a recipient via the specified channel.
void	send(IRecipientList recipients, IChannel channel, INotification notification)

Methods inherited from interface com.sapportals.wcm.service.IService

getDescription, getDescription, getID

Field Detail

NOTIFICATOR_SERVICE

public static final String NOTIFICATOR_SERVICE

Service ID

See Also:

Constant Field Values

ENCODING_DEFAULT

public static final String ENCODING_DEFAULT

default encoding to use, when transforming Streams into Strings. Used, when the IContent object doesn't specify its encoding

See Also:

Constant Field Values

SUBSCRIPTION_NOTIFICATION

public static final String SUBSCRIPTION_NOTIFICATION

id for SUBSCRIPTION notificiation: a subscription generated an event.

See Also:

Constant Field Values

SUBSCRIPTIONBUNDLED_NOTIFICATION

public static final String SUBSCRIPTIONBUNDLED_NOTIFICATION

id for SUBSCRIPTIONBUNDLED notificiation: a polling event trigged one or more notifications.

See Also:

Constant Field Values

SUBSCRIPTIONADMIN_NOTIFICATION

public static final String SUBSCRIPTIONADMIN_NOTIFICATION

id for SUBSCRIPTIONADMIN notification: a subscription was created/deleted or resources have been added to / removed from a subscription.

See Also:

Constant Field Values

WORKFLOW_NOTIFICATION

public static final String WORKFLOW_NOTIFICATION

id for WORKFLOW notification: a document state changed and someone has to do something (a workflow task is started)...

See Also:

Constant Field Values

WORKFLOWRESULT_NOTIFICATION

public static final String WORKFLOWRESULT_NOTIFICATION

id for WORKFLOWRESULT notification: someone did something with a workflow document (a workflow task is completed).

See Also:

Constant Field Values

Method Detail

getChannels

public Collection getChannels()
                       throws WcmException

Get a list of available channels for this notificator.

Returns:

Collection is a list of IChannel s with the valid channels for this notificator.

Throws:

WcmException - Exception raised in failure situation

WcmException - if the list of channels can't be retrieved.

send

public void send(IRecipient recipient,
                 IChannel channel,
                 INotification notification)
          throws WcmException

Send a notification to a recipient via the specified channel.

Parameters:

recipient - TBD: Description of the incoming method parameter

channel - TBD: Description of the incoming method parameter

notification - TBD: Description of the incoming method parameter

Throws:

WcmException - Exception raised in failure situation

WcmException - if the notification could not be sent.

send

public void send(IRecipientList recipients,
                 IChannel channel,
                 INotification notification)
          throws WcmException

Throws:

WcmException

getDefaultFromAddress

public String getDefaultFromAddress(IChannel channel)
                             throws WcmException

Get the default from address for a channel.

Parameters:

channel - a IChannel to get the address for.

Returns:

a String with the from address for the given channel.

Throws:

WcmException - Exception raised in failure situation