Package com.vaadin.event

See:
Description

Interface Summary

Action.Container	Interface implemented by all components where actions can be registered.
Action.Handler	Interface implemented by classes who wish to handle actions.
Action.Listener	An Action that implements this interface can be added to an Action.Notifier (or NotifierProxy) via the addAction() -method, which in many cases is easier than implementing the Action.Handler interface.
Action.Notifier	Action.Containers implementing this support an easier way of adding single Actions than the more involved Action.Handler.
Action.ShortcutNotifier
ComponentEventListener
FieldEvents	Interface that serves as a wrapper for Field related events.
FieldEvents.BlurListener	BlurListener interface for listening for BlurEvent fired by a Field.
FieldEvents.BlurNotifier	The interface for adding and removing BlurEvent listeners.
FieldEvents.FocusListener	FocusListener interface for listening for FocusEvent fired by a Field.
FieldEvents.FocusNotifier	The interface for adding and removing FocusEvent listeners.
FieldEvents.TextChangeListener	A listener for FieldEvents.TextChangeEvents.
FieldEvents.TextChangeNotifier	An interface implemented by a Field supporting FieldEvents.TextChangeEvents.
ItemClickEvent.ItemClickListener
ItemClickEvent.ItemClickNotifier	The interface for adding and removing ItemClickEvent listeners.
ItemClickEvent.ItemClickSource	Deprecated. Use ItemClickEvent.ItemClickNotifier instead.
LayoutEvents
LayoutEvents.LayoutClickListener
LayoutEvents.LayoutClickNotifier	The interface for adding and removing LayoutClickEvent listeners.
MethodEventSource	Interface for classes supporting registration of methods as event receivers.
MouseEvents	Interface that serves as a wrapper for mouse related events.
MouseEvents.ClickListener	Interface for listening for a MouseEvents.ClickEvent fired by a Component.
MouseEvents.DoubleClickListener	Interface for listening for a MouseEvents.DoubleClickEvent fired by a Component.
ShortcutAction.KeyCode	Key codes that can be used for shortcuts
ShortcutAction.ModifierKey	Modifier key constants
Transferable	Transferable wraps the data that is to be imported into another component.

Class Summary

Action	Implements the action framework.
ActionManager	Javadoc TODO Notes:
DataBoundTransferable	Parent class for Transferable implementations that have a Vaadin container as a data source.
EventRouter	EventRouter class implementing the inheritable event listening model.
FieldEvents.BlurEvent	BlurEvent class for holding additional event information.
FieldEvents.FocusEvent	FocusEvent class for holding additional event information.
FieldEvents.TextChangeEvent	TextChangeEvents are fired when the user is editing the text content of a field.
ItemClickEvent	Click event fired by a Component implementing Container interface.
LayoutEvents.LayoutClickEvent	An event fired when the layout has been clicked.
ListenerMethod	One registered event listener.
MouseEvents.ClickEvent	Class for holding information about a mouse click event.
MouseEvents.DoubleClickEvent	Class for holding additional event information for DoubleClick events.
ShortcutAction	Shortcuts are a special type of Actions used to create keyboard shortcuts.
ShortcutListener
TransferableImpl	TODO Javadoc!

Exception Summary

Package com.vaadin.event Description

Provides classes and interfaces for the inheritable event model. The model supports inheritable events and a flexible way of registering and unregistering event listeners. It's a fundamental building block of Vaadin, and as it is included in AbstractComponent, all UI components automatically support it.

Package Specification

The core of the event model is the inheritable event class hierarchy, and the EventRouter which provide a simple, ubiquitous mechanism to transport events to all interested parties.

The power of the event inheritance arises from the possibility of receiving not only the events of the registered type, but also the ones which are inherited from it. For example, let's assume that there are the events GeneralEvent and SpecializedEvent so that the latter inherits the former. Furthermore we have an object A which registers to receive GeneralEvent type events from the object B. A would of course receive all GeneralEvents generated by B, but in addition to this, A would also receive all SpecializedEvents generated by B. However, if B generates some other events that do not have GeneralEvent as an ancestor, A would not receive them unless it registers to listen for them, too.

The interface to attaching and detaching listeners to and from an object works with methods. One specifies the event that should trigger the listener, the trigger method that should be called when a suitable event occurs and the object owning the method. From these a new listener is constructed and added to the event router of the specified component.

The interface is defined in MethodEventSource, and a straightforward implementation of it is defined in EventRouter which also includes a method to actually fire the events.

All fired events are passed to all registered listeners, which are of type ListenerMethod. The listener then checks if the event type matches with the specified event type and calls the specified trigger method if it does.