org.eidola.kernel.event
Interface Event

All Known Implementing Classes:

ContainerEvent

public interface Event

Carries information about changes, updates, etc. Events originate from EventBroadcasters, and objects implementing the EventListener interface may register themselves to receive events.

The lifespan of an event typically runs as follows:

• EventListeners register themselves to receive events via EventBroadcaster.addListener(EventListener,EventQueue).
• Some fascinating occurrence causes an object to create a new Event, and call EventBroadcaster.broadcastEvent(Event).
• The broadcaster calls EventQueue.addEvent(Event event, EventListener target) for each registered listener.
• Threads are consuming events from the various queues, and dispatch the events to the appropriate listeners with calls to EventListener.handleEvent(Event).

Subclasses of Event may override the equals and hashCode methods to reduce redundant event broadcasting. See EventQueue for more information.

Version:

[Development version]

Author:

Paul Cantrell

See Also:

EventBroadcaster, EventListener, EventQueue, ContainerEvent