com.prosyst.util.event

Interface EventCollector

All Known Subinterfaces:

PMPService

public interface EventCollector

The EventCollector receives different kinds of events and delivers them to the registered listeners. It should be used when there cann't be established direct connection between the event source and the event listener (for example if the listener works in a different VM).

The interface is intended to be used by the event sources:

1. The event source first registers at the EventCollector with the addEventSource method.
2. Interested listeners register at the EventCollector for receiving events from this event source, using means not specified here.
3. The event source sends events to the event collector using the event method. The EventCollector then delivers them to the interested listeners.
4. Finally the event source unregisters using the removeEventSource method. The EventCollector notifies all interested listeners for the un-registration.

Method Summary

Modifier and Type	Method and Description
void	addEventSource(java.lang.String eventType) Registers an event type at the event collector.
void	event(java.lang.Object ev, java.lang.String eventType, long bid) Sends an event to the EventCollector
void	removeEventSource(java.lang.String eventType) Unregisters an event type from the event collector.

Method Detail

event

void event(java.lang.Object ev,
           java.lang.String eventType,
           long bid)

Sends an event to the EventCollector

Parameters:

ev - The event

eventType - The event's type

bid - The id of the bundle that the event source belongs to

addEventSource

void addEventSource(java.lang.String eventType)

Registers an event type at the event collector. After an event type has been registered listeners can register for receiving events of this type.

Parameters:

eventType - The event type to register

removeEventSource

void removeEventSource(java.lang.String eventType)

Unregisters an event type from the event collector. All listeners registered for receiving events of this type will receive a notification for this un-registration.

Parameters:

eventType - The event type to unregister.