Package org.somda.sdc.dpws.soap.wseventing

Class ActionBasedEventSource

java.lang.Object

com.google.common.util.concurrent.AbstractIdleService

org.somda.sdc.dpws.soap.wseventing.ActionBasedEventSource

All Implemented Interfaces:

com.google.common.util.concurrent.Service, Interceptor, EventSource, EventSourceDialectHandler

public class ActionBasedEventSource
extends com.google.common.util.concurrent.AbstractIdleService
implements EventSource, EventSourceDialectHandler

Interceptor that handles an action-based event source's incoming subscription requests and facilitates sending notifications.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.common.util.concurrent.Service

com.google.common.util.concurrent.Service.Listener, com.google.common.util.concurrent.Service.State

Method Summary

Modifier and Type	Method	Description
Map<String,SubscriptionManager>	getActiveSubscriptions()	Returns all active subscription ids with their SubscriptionManager.
String	getDialect()	This function shall return the handled filter dialect.
void	init(Subscriptions subscriptions)	Called once for a filter dialect handler when the EventSourceInterceptorDispatcher service starts.
void	sendNotification(String action, Object payload)	Sends a notification to all event sinks.
void	setStale(SourceSubscriptionManager subscriptionManager)	Called when a subscription has expired.
protected void	shutDown()
protected void	startUp()
void	subscribe(SourceSubscriptionManager subscriptionManager)	Called on an incoming subscribe request.
void	subscriptionEndToAll(WsEventingStatus status)	Sends a subscription end to all event sinks.
void	unsubscribe(SourceSubscriptionManager subscriptionManager)	Called on an incoming unsubscribe request.

Methods inherited from class com.google.common.util.concurrent.AbstractIdleService

addListener, awaitRunning, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, awaitTerminated, executor, failureCause, isRunning, serviceName, startAsync, state, stopAsync, toString

Methods inherited from class java.lang.Object

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

Method Detail

sendNotification

public void sendNotification(String action,
                             Object payload)

Description copied from interface: EventSource

Sends a notification to all event sinks.

Specified by:

sendNotification in interface EventSource

Parameters:

action - the action URI used for dispatching to event sinks.

payload - a JAXB element or JAXB generated class object to transport.

subscriptionEndToAll

public void subscriptionEndToAll(WsEventingStatus status)

Description copied from interface: EventSource

Sends a subscription end to all event sinks.

Specified by:

subscriptionEndToAll in interface EventSource

Parameters:

status - the subscription end reason.

getActiveSubscriptions

public Map<String,SubscriptionManager> getActiveSubscriptions()

Description copied from interface: EventSource

Returns all active subscription ids with their SubscriptionManager.

Specified by:

getActiveSubscriptions in interface EventSource

Returns:

Map of subscription ids and SubscriptionManagers.

init

public void init(Subscriptions subscriptions)

Description copied from interface: EventSourceDialectHandler

Called once for a filter dialect handler when the EventSourceInterceptorDispatcher service starts.

This function is guaranteed to be called before any other callback of this interface is called.

The subscriptions are managed by the EventSourceInterceptorDispatcher!

Specified by:

init in interface EventSourceDialectHandler

Parameters:

subscriptions - the subscription registry that handles all subscriptions for the filter dialect

subscribe

public void subscribe(SourceSubscriptionManager subscriptionManager)

Description copied from interface: EventSourceDialectHandler

Called on an incoming subscribe request.

Specified by:

subscribe in interface EventSourceDialectHandler

Parameters:

subscriptionManager - the subscription manager for this subscription.

unsubscribe

public void unsubscribe(SourceSubscriptionManager subscriptionManager)

Description copied from interface: EventSourceDialectHandler

Called on an incoming unsubscribe request.

Specified by:

unsubscribe in interface EventSourceDialectHandler

Parameters:

subscriptionManager - the subscription manager for this subscription.

setStale

public void setStale(SourceSubscriptionManager subscriptionManager)

Description copied from interface: EventSourceDialectHandler

Called when a subscription has expired.

Specified by:

setStale in interface EventSourceDialectHandler

Parameters:

subscriptionManager - the subscription manager for this subscription.

getDialect

public String getDialect()

Description copied from interface: EventSourceDialectHandler

This function shall return the handled filter dialect.

It is used by the dispatcher helping to assign subscription activity.

Specified by:

getDialect in interface EventSourceDialectHandler

Returns:

the filter dialect handled by this instance.

startUp

protected void startUp()

Specified by:

startUp in class com.google.common.util.concurrent.AbstractIdleService

shutDown

protected void shutDown()

Specified by:

shutDown in class com.google.common.util.concurrent.AbstractIdleService