|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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(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(SubscriptionInterface sub,
EventDispatcherListenerInterface li)
cancels the subscriptions, posted by li, whose subscripton sub' is covered by subscripiton p. |
Method Detail |
public void publish(EventInterface evnt) throws DispatcherException
DispatcherException
Event
public 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.server.core.EventDispatcherListenerInterface)
public 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.server.core.EventDispatcherListenerInterface)
public void unsubscribe(EventDispatcherListenerInterface li) throws DispatcherException
li
- is the subscriber
DispatcherException
subscribe(edu.uci.isr.yancees.SubscriptionInterface, edu.uci.isr.yancees.server.core.EventDispatcherListenerInterface)
public void suspendDispatcher(EventDispatcherListenerInterface li) throws DispatcherException
li
.
li
- subscriber to be suspended
DispatcherException
public void resumeDispatcher(EventDispatcherListenerInterface li) throws DispatcherException
n
.
DispatcherException
public void shutdownDispatcher() throws DispatcherException
DispatcherException
public 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 |