Package org.apache.tapestry.listener

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

See: Description

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 org.apache.tapestry.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()