|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface EventDispatcherInterface
Title: Yancees Notification Server
Description: Yet ANother Configurable Extensible Event Service
Copyright: Copyright (c) 2003
Company: School of Information and Computer Science - University of California, Irvine
Method Summary | |
---|---|
void |
connect(java.lang.String address)
Connects and initializes the registered dispatchers This method is used by the server-specific adapters |
void |
publish(EventInterface evnt)
|
void |
resumeDispatcher(EventDispatcherListenerInterface li)
resumes the delivery of notifications to the given subscriber n . |
void |
shutdownDispatcher()
closes this Dispatcher service access point. |
void |
subscribe(java.lang.String adapterName,
SubscriptionInterface sub,
EventDispatcherListenerInterface li)
This is a specific subscriber, that sends a message to the specfific adapter installed in the system |
void |
subscribe(SubscriptionInterface sub,
EventDispatcherListenerInterface li)
subscribes for sequences of events matching pattern p. |
void |
suspendDispatcher(EventDispatcherListenerInterface li)
suspends the delivery of notifications to the given subscriber li . |
void |
unsubscribe(EventDispatcherListenerInterface li)
cancels all the subscriptions posted by n. |
void |
unsubscribe(java.lang.String adapterName,
EventDispatcherListenerInterface li)
|
void |
unsubscribe(java.lang.String adapterName,
SubscriptionInterface sub,
EventDispatcherListenerInterface li)
|
void |
unsubscribe(SubscriptionInterface sub,
EventDispatcherListenerInterface li)
cancels the subscriptions, posted by li, whose subscripton sub' is covered by subscripiton p. |
Method Detail |
---|
void publish(EventInterface evnt) throws DispatcherException
evt
- The event to publish.
DispatcherException
Event
void subscribe(SubscriptionInterface sub, EventDispatcherListenerInterface li) throws DispatcherException
Notice that given the distributed nature of some implementations of Dispatcher interface, there exist race conditions that might affect the semantics of subscriptions. A subscriber might miss some notifications published before or while the subscription is processed by Dispatcher.
Also, keep in mind that the current implementation of Dispatcher does not enforce any temporal order for the delivery of notifications. This limitation might affect the recognition of patterns. For example, two notifications x and y, generated at time tx and ty respectively, with tx < ty, in that order matching a pattern P=(fx fy), might in fact reach the subscriber at times Tx and Ty, with Tx > Ty, in which case pattern P would not be matched.
li
- is the subscribersub
- is the subscription pattern
DispatcherException
unsubscribe(edu.uci.isr.yancees.SubscriptionInterface, edu.uci.isr.yancees.dispatcher.EventDispatcherListenerInterface)
void subscribe(java.lang.String adapterName, SubscriptionInterface sub, EventDispatcherListenerInterface li) throws DispatcherException
adapterName
- is the name of the adapter to specifically subscribe tosub
- is the subscriptionli
- is the listener interface
DispatcherException
void unsubscribe(SubscriptionInterface sub, EventDispatcherListenerInterface li) throws DispatcherException
Unsubscriptions might incurr in the same kind of race conditions as subscriptions. Dispatcher will stop sending notifications to the subscriber only after it has completed the processing of the unsubscription. Due to the distributed nature of some implementations of Dispatcher, this might result in some additional ``unsolicited'' notifications.
li
- is the subscriber interface
DispatcherException
subscribe(edu.uci.isr.yancees.SubscriptionInterface, edu.uci.isr.yancees.dispatcher.EventDispatcherListenerInterface)
void unsubscribe(java.lang.String adapterName, SubscriptionInterface sub, EventDispatcherListenerInterface li) throws DispatcherException
adapterName
- sub
- li
-
DispatcherException
void unsubscribe(java.lang.String adapterName, EventDispatcherListenerInterface li) throws DispatcherException
li
-
DispatcherException
void unsubscribe(EventDispatcherListenerInterface li) throws DispatcherException
li
- is the subscriber
DispatcherException
subscribe(edu.uci.isr.yancees.SubscriptionInterface, edu.uci.isr.yancees.dispatcher.EventDispatcherListenerInterface)
void suspendDispatcher(EventDispatcherListenerInterface li) throws DispatcherException
li
.
li
- subscriber to be suspended
DispatcherException
void resumeDispatcher(EventDispatcherListenerInterface li) throws DispatcherException
n
.
n
- subscriber to be resumed
DispatcherException
void shutdownDispatcher() throws DispatcherException
DispatcherException
void connect(java.lang.String address) throws DispatcherException
address
- is the address of the server.
DispatcherException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |