net.sf.cscc
Interface DataEventObserver

public interface DataEventObserver

extends DataEventBaseObserver

This interface has to be implemented by observers which want to be notified about new data events in the event queue. Implementing this interface causes only the notification, without the delivery of the data event itself. If the corresponding DataEvent object should be delivered with the notification, then use the interface DataEventReceivingObserver.

Author

Silvio Meier (SM)

Copyright

Silvio Meier, Tobias Reinhard, 2003

History

2003-05-09 SM First Version
2003-05-14 SM working on additional methods and events,
correction of some comments.

Version

$Date: 2007/07/02 21:26:17 $, $Author: reode_orm $, $Revision: 1.2 $

Responsibilities

Provides an interface for an data event observer call.

Invariant

-

Method Summary

void	receiveEvent() This interface method is called by objects the DataEventObservable class.

Method Detail

receiveEvent

public void receiveEvent()

This interface method is called by objects the DataEventObservable class. The implenting class has to register at the specific object of the class DataEventObservable to get notifications about new data events in the event queue. This is done by calling the method ServerConnectionManager.addObserver(DataEventBaseObserver o) for observing the incoming event queue of the server respectively the method ClientConnectionManager.addObserver(DataEventBaseObserver o) for the incoming event queue of the client. The implementing class has to get the specific data event by calling the method ServerConnectionManager.getDataEvent() for incoming data event queue of the server, respectively ClientConnectionManager.getDataEvent() for the incoming data event queue of the client. After getting the events, the observer has to take care of the data event removal from the incoming queue by calling the methods ServerConnectionManager.removeDataEvent().
Additional information can also be found at the interface method DataEventReceivingObserver.receiveEvent(DataEvent de).

Pre

true

Post

true

Obligation

The removal of the data event from the incoming event queue has to be done by the observer!

See Also

DataEventReceivingObserver.receiveEvent(DataEvent de)