org.ow2.util.event.api
Interface IEventService

public interface IEventService

Allow to register event dispatchers with an id.
Each listeners are associated with a regexp used to register them on all matching dispatchers.

Author:

missonng

Method Summary

IEventDispatcher	getDispatcher(java.lang.String id) Get the event dispatcher with the given id.
void	registerDispatcher(java.lang.String id, IEventDispatcher dispatcher) Register a new event dispatcher.
void	registerListener(IEventListener listener, java.lang.String regexp) Register a new event listener. The listener will automatically be register with each registered dispatcher matching the given regexp.
void	start() Start the service.
void	stop() Stop the service.
void	unregisterDispatcher(java.lang.String id) Unregister an event dispatcher.
void	unregisterListener(IEventListener listener) Unregister an event listener.

Method Detail

start

void start()

Start the service.

stop

void stop()

Stop the service.

getDispatcher

IEventDispatcher getDispatcher(java.lang.String id)

Get the event dispatcher with the given id.

Parameters:

id - The id of the dispatcher to get.

Returns:

The event dispatcher with the given id.

registerDispatcher

void registerDispatcher(java.lang.String id,
                        IEventDispatcher dispatcher)

Register a new event dispatcher.

Parameters:

id - The id to register the dispatcher with.

dispatcher - The dispatcher to register.

unregisterDispatcher

void unregisterDispatcher(java.lang.String id)

Unregister an event dispatcher.

Parameters:

id - The id to unregister.

registerListener

void registerListener(IEventListener listener,
                      java.lang.String regexp)

Register a new event listener.
The listener will automatically be register with each registered dispatcher matching the given regexp.

Parameters:

listener - The listener to register.

regexp - The regexp to apply.

unregisterListener

void unregisterListener(IEventListener listener)

Unregister an event listener.

Parameters:

listener - The listener to unregister.