org.apache.beehive.controls.api.events
Interface EventDispatcher

All Known Subinterfaces:

ControlContainerContext

All Known Implementing Classes:

ControlContainerContext, ControlTestContainerContext, EventDispatchHelper, ServletBeanContext

public interface EventDispatcher

The EventDispatcher interface defines the method signature that a container supporting the external dispatch of Control events would implement.

dispatchEvent

Object dispatchEvent(ControlHandle target,
                     EventRef event,
                     Object[] args)
                     throws IllegalAccessException,
                            IllegalArgumentException,
                            InvocationTargetException

Dispatches a Control event to a target control.

Parameters:

target - the target control

event - the event to deliver to the control

args - the parameters to the control event

Throws:

IllegalAccessException - the underlying event method is not accessible due to access control.

IllegalArgumentException - the target is not valid, the event is not a valid event type for the requested target, or the argument types do not match the event signature.

InvocationTargetException - wraps any exception thrown by the underlying event handler.