com.sun.javafx.event

Class EventHandlerManager

java.lang.Object

com.sun.javafx.event.BasicEventDispatcher

com.sun.javafx.event.EventHandlerManager

All Implemented Interfaces:

EventDispatcher

public class EventHandlerManager
extends BasicEventDispatcher

An EventDispatcher which allows user event handler / filter registration and when used in an event dispatch chain it forwards received events to the appropriate registered handlers / filters.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<EventType<? extends Event>,CompositeEventHandler<? extends Event>>	eventHandlerMap
private java.lang.Object	eventSource

Constructor Summary

Constructors

Constructor and Description
EventHandlerManager(java.lang.Object eventSource)

Method Summary

Modifier and Type	Method and Description
<T extends Event> void	addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter) Registers an event filter in EventHandlerManager.
<T extends Event> void	addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler) Registers an event handler in EventHandlerManager.
private <T extends Event> CompositeEventHandler<T>	createGetCompositeEventHandler(EventType<T> eventType)
Event	dispatchBubblingEvent(Event event)
private Event	dispatchBubblingEvent(EventType<? extends Event> handlerType, Event event)
Event	dispatchCapturingEvent(Event event)
private Event	dispatchCapturingEvent(EventType<? extends Event> handlerType, Event event)
private static Event	fixEventSource(Event event, java.lang.Object eventSource)
<T extends Event> EventHandler<? super T>	getEventHandler(EventType<T> eventType)
protected java.lang.Object	getEventSource()
<T extends Event> void	removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter) Unregisters a previously registered event filter.
<T extends Event> void	removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler) Unregisters a previously registered event handler.
<T extends Event> void	setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler) Sets the specified singleton handler.
private static void	validateEventFilter(EventHandler<?> eventFilter)
private static void	validateEventHandler(EventHandler<?> eventHandler)
private static void	validateEventType(EventType<?> eventType)

Methods inherited from class com.sun.javafx.event.BasicEventDispatcher

dispatchEvent, getNextDispatcher, getPreviousDispatcher, insertNextDispatcher

Methods inherited from class java.lang.Object

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

Field Detail

eventHandlerMap

private final java.util.Map<EventType<? extends Event>,CompositeEventHandler<? extends Event>> eventHandlerMap

eventSource

private final java.lang.Object eventSource

Constructor Detail

EventHandlerManager

public EventHandlerManager(java.lang.Object eventSource)

Method Detail

addEventHandler

public final <T extends Event> void addEventHandler(EventType<T> eventType,
                                                    EventHandler<? super T> eventHandler)

Registers an event handler in EventHandlerManager.

Type Parameters:

T - the specific event class of the handler

Parameters:

eventType - the type of the events to receive by the handler

eventHandler - the handler to register

Throws:

java.lang.NullPointerException - if the event type or handler is null

removeEventHandler

public final <T extends Event> void removeEventHandler(EventType<T> eventType,
                                                       EventHandler<? super T> eventHandler)

Unregisters a previously registered event handler.

Type Parameters:

T - the specific event class of the handler

Parameters:

eventType - the event type from which to unregister

eventHandler - the handler to unregister

Throws:

java.lang.NullPointerException - if the event type or handler is null

addEventFilter

public final <T extends Event> void addEventFilter(EventType<T> eventType,
                                                   EventHandler<? super T> eventFilter)

Registers an event filter in EventHandlerManager.

Type Parameters:

T - the specific event class of the filter

Parameters:

eventType - the type of the events to receive by the filter

eventFilter - the filter to register

Throws:

java.lang.NullPointerException - if the event type or filter is null

removeEventFilter

public final <T extends Event> void removeEventFilter(EventType<T> eventType,
                                                      EventHandler<? super T> eventFilter)

Unregisters a previously registered event filter.

Type Parameters:

T - the specific event class of the filter

Parameters:

eventType - the event type from which to unregister

eventFilter - the filter to unregister

Throws:

java.lang.NullPointerException - if the event type or filter is null

setEventHandler

public final <T extends Event> void setEventHandler(EventType<T> eventType,
                                                    EventHandler<? super T> eventHandler)

Sets the specified singleton handler. There can only be one such handler specified at a time.

Type Parameters:

T - the specific event class of the handler

Parameters:

eventType - the event type to associate with the given eventHandler

eventHandler - the handler to register, or null to unregister

Throws:

java.lang.NullPointerException - if the event type is null

getEventHandler

public final <T extends Event> EventHandler<? super T> getEventHandler(EventType<T> eventType)

dispatchCapturingEvent

public final Event dispatchCapturingEvent(Event event)

Overrides:

dispatchCapturingEvent in class BasicEventDispatcher

dispatchBubblingEvent

public final Event dispatchBubblingEvent(Event event)

Overrides:

dispatchBubblingEvent in class BasicEventDispatcher

createGetCompositeEventHandler

private <T extends Event> CompositeEventHandler<T> createGetCompositeEventHandler(EventType<T> eventType)

getEventSource

protected java.lang.Object getEventSource()

dispatchCapturingEvent

private Event dispatchCapturingEvent(EventType<? extends Event> handlerType,
                                     Event event)

dispatchBubblingEvent

private Event dispatchBubblingEvent(EventType<? extends Event> handlerType,
                                    Event event)

fixEventSource

private static Event fixEventSource(Event event,
                                    java.lang.Object eventSource)

validateEventType

private static void validateEventType(EventType<?> eventType)

validateEventHandler

private static void validateEventHandler(EventHandler<?> eventHandler)

validateEventFilter

private static void validateEventFilter(EventHandler<?> eventFilter)