net.sf.mmm.util.event.api

Interface EventSource<E extends Event,L extends EventListener<E>>

Type Parameters:

E - is the templated type of the events to send.

L - is the templated type of the listeners that can be registered here and that will receive the events.

All Known Subinterfaces:

TransactionExecutor

All Known Implementing Classes:

AbstractEventSource, AbstractMultiThreadedEventSource, AbstractSynchronizedEventSource, AbstractTransactionExecutor, JpaTransactionExecutor, JtaTransactionExecutor, NoTransactionExecutor, SpringTransactionExecutor

public interface EventSource<E extends Event,L extends EventListener<E>>

This interface allows listeners to be registered and unregistered.
NOTE:
For event base communication between loosely coupled components we recommend to use EventBus.

Since:

1.0.1

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Method Summary

Modifier and Type	Method and Description
void	addListener(L listener) This method registers a listener that is interested in Events.
boolean	removeListener(L listener) This method removes a listener.

Method Detail

addListener

void addListener(L listener)

This method registers a listener that is interested in Events.

Parameters:

listener - is the listener to add.

removeListener

boolean removeListener(L listener)

This method removes a listener. If the listener was not registered before this method does not do any change.

Parameters:

listener - is the listener to remove.

Returns:

true if the given listener has successfully been removed, false if the listener was NOT registered.