net.sf.mmm.util.event.api (JavaDocs for mmm-all dev-SNAPSHOT)

Interface Summary
Interface	Description
ChangeEvent	A `ChangeEvent` is an `Event` that informs about something that has been `added`, `updated` or `removed`.
Event	This is the interface for a generic event.
EventBus	This is the interface for an event bus.
EventListener<E>	This is the interface for a generic event listener.
EventSource<E extends Event,L extends EventListener<E>>	This interface allows listeners to be registered and unregistered.

Class Summary
Class Description

EventListenerIgnore
This is an implementation of EventListener that simply ignores all events.
Enum Summary
Enum Description

ChangeType
This enum contains the available types of a ChangeEvent.

Class Summary
Class	Description
EventListenerIgnore	This is an implementation of `EventListener` that simply ignores all events.

Enum Summary
Enum	Description
ChangeType	This enum contains the available `types` of a `ChangeEvent`.

Package net.sf.mmm.util.event.api Description

Provides the API for a generic event-handling.

Event-Util API

It is a common pattern to register a listener for events that notify of a specific situation. This pattern has been re-implemented thousands of times. Java generics allow to stop to re-invent the wheel and implement the pattern once in a generic way. This prevents you from typical mistakes as dead-locks in listeners that want to de-register themselves during event-handling.
Create your custom event by implementing the marker interface Event or if suitable implementing ChangeEvent. Then the producer of the events only needs to extend AbstractEventSource or one of its sub-classes.