Package org.apache.tapestry.listener

Support classes that allows an object to expose listener methods instead of listener properties.

See:
Description

Class Summary

ListenerMap	Maps a class to a set of listeners based on the public methods of the class.
ListenerMapPropertyAccessor	Exposes IActionListener listeners provided by the ListenerMap as read-only properties of the ListenerMap.

Package org.apache.tapestry.listener Description

Support classes that allows an object to expose listener methods instead of listener properties.

Normally, a listener property must be an object that implement IActionListener. This can be cumbersome, in practice, as it typically involves creating an anonymous inner class.

Using this mechanism, classes can instead implement listener methods. A listener method takes the form:

public void method-name(IRequestCycle cycle) 
throws ApplicationRuntimeException

The throws clause is optional, but may not throw any additional exceptions.

Tapestry will create an appropriate listener object that will invoke the corresponding method.

The methods can be accessed using the property path "listeners.method-name"

Since:

1.0.2

Author:

Howard Lewis Ship hlship@apache.org

See Also:

ListenerMap, AbstractComponent.getListeners(), AbstractEngine.getListeners()