com.sapportals.wcm.service.notificator
Interface INotificatorService

[contained in: com.sap.netweaver.bc.rf.service.par - bc.rf.global.service.notificator_api.jar]

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

Method Summary

java.util.Collection	getChannels() Get a list of available channels for this notificator.
java.lang.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

ENCODING_DEFAULT

public static final java.lang.String ENCODING_DEFAULT

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

SUBSCRIPTION_NOTIFICATION

public static final java.lang.String SUBSCRIPTION_NOTIFICATION

id for SUBSCRIPTION notificiation: a subscription generated an event.

SUBSCRIPTIONBUNDLED_NOTIFICATION

public static final java.lang.String SUBSCRIPTIONBUNDLED_NOTIFICATION

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

SUBSCRIPTIONADMIN_NOTIFICATION

public static final java.lang.String SUBSCRIPTIONADMIN_NOTIFICATION

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

WORKFLOW_NOTIFICATION

public static final java.lang.String WORKFLOW_NOTIFICATION

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

WORKFLOWRESULT_NOTIFICATION

public static final java.lang.String WORKFLOWRESULT_NOTIFICATION

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

Method Detail

getChannels

public java.util.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

getDefaultFromAddress

public java.lang.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