javax.rad.util
Class EventHandler<L>

java.lang.Object
  javax.rad.util.EventHandler<L>

Type Parameters:

L - the Listener type

Direct Known Subclasses:

ModelEventHandler, RuntimeEventHandler

public class EventHandler<L>
extends Object

Platform and technology independent event handler. It is designed for use with UI elements and non UI elements. There can be used with any Listener Interface. and implicit forwarded to any function. button.eventAction().addListener( new ActionListener() { public void actionPerformed(ActionEvent pEvent) { doSave(); } }); button.eventAction().addListener(this, "doSave");

Constructor Summary

EventHandler(Class<L> pListenerType, Class... pParameterTypes)
Constructs a new EventHandler, the listener type may only have 1 method.

EventHandler(Class<L> pListenerType, String pListenerMethodName, Class... pParameterTypes)
Constructs a new EventHandler.

Method Summary

void	addListener(L pListener) Adds a listener.
void	addListener(Object pListener, String pMethodName) Adds a listener.
L	createListener(Object pListener, String pMethodName) Creates a new listener interface for calling the given method for the given object.
Object	dispatchEvent(Object... pEventParameter) Dispatches the given events to all listeners.
L	getDefaultListener() Gets the default listener.
L[]	getListeners() Gets all listeners.
void	removeAllListeners() Removes all known listeners.
void	removeListener(Object pListener) Removes a listener.
void	setDefaultListener(L pListener) Sets the default listener.
void	setDefaultListener(Object pListener, String pMethodName) Sets the default listener.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EventHandler

public EventHandler(Class<L> pListenerType,
                    Class... pParameterTypes)

Constructs a new EventHandler, the listener type may only have 1 method.

Parameters:

pListenerType - the listener type interface.

pParameterTypes - parameter types to check additional.

EventHandler

public EventHandler(Class<L> pListenerType,
                    String pListenerMethodName,
                    Class... pParameterTypes)

Constructs a new EventHandler.

Parameters:

pListenerType - the listener type interface.

pListenerMethodName - the method to be called inside the interface.

pParameterTypes - parameter types to check additional.

Method Detail

addListener

public void addListener(L pListener)

Adds a listener.

Parameters:

pListener - the listener.

addListener

public void addListener(Object pListener,
                        String pMethodName)

Adds a listener.

Parameters:

pListener - the listener object.

pMethodName - the method name.

removeListener

public void removeListener(Object pListener)

Removes a listener.

Parameters:

pListener - the listener.

removeAllListeners

public void removeAllListeners()

Removes all known listeners.

getListeners

public L[] getListeners()

Gets all listeners.

Returns:

all listeners.

setDefaultListener

public void setDefaultListener(L pListener)

Sets the default listener.

Parameters:

pListener - the listener.

setDefaultListener

public void setDefaultListener(Object pListener,
                               String pMethodName)

Sets the default listener.

Parameters:

pListener - the listener object.

pMethodName - the method name.

getDefaultListener

public L getDefaultListener()

Gets the default listener.

Returns:

the default listener.

dispatchEvent

public Object dispatchEvent(Object... pEventParameter)
                     throws Throwable

Dispatches the given events to all listeners.

Parameters:

pEventParameter - the event parameter.

Returns:

the return value of the deaultListener, if it is called, or null else.

Throws:

Throwable - if an exception occurs.

createListener

public L createListener(Object pListener,
                        String pMethodName)

Creates a new listener interface for calling the given method for the given object.

Parameters:

pListener - the object.

pMethodName - the method.

Returns:

the Interface.