org.eclipse.osgi.framework.eventmgr

Interface EventDispatcher<K,V,E>

All Known Implementing Classes:

BundleContextImpl, MRUBundleFileList, StartLevelManager

public interface EventDispatcher<K,V,E>

The EventDispatcher interface contains the method that is called by the Event Manager to complete the event delivery to the event listener.

Clients may implement this interface.

Since:

3.1

Method Summary

Methods

Modifier and Type	Method and Description
void	dispatchEvent(K eventListener, V listenerObject, int eventAction, E eventObject) This method is called once for each listener.

Method Detail

dispatchEvent

void dispatchEvent(K eventListener,
                 V listenerObject,
                 int eventAction,
                 E eventObject)

This method is called once for each listener. This method must cast the event listener object to the appropriate listener class for the event type and call the appropriate listener method.

The method should properly log/handle any exceptions thrown by the called listener. The EventManager will ignore any Throwable thrown by this method in order to continue delivery of the event to the next listener.

Parameters:

eventListener - This is the key in the Map.Entry for the listener. The implementation of this method must cast it to the appropriate listener class for the event to be delivered and the appropriate listener method must then be called.

listenerObject - This is the value in the Map.Entry for the listener.

eventAction - This value was passed to the ListenerQueue object via one of its dispatchEvent* method calls. It can provide information (such as which listener method to call) so that the EventDispatcher can complete the delivery of the event to the listener.

eventObject - This object was passed to the ListenerQueue object via one of its dispatchEvent* method calls. This object was created by the event source and is passed to this method. It should contain all the necessary information (such as what event object to pass) so that this method can complete the delivery of the event to the listener. This is typically the actual event object.