Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface EventDispatchChain
EventDispatcher
objects, which can dispatch
an Event
. The event is dispatched by passing it from one
EventDispatcher
to the next in the chain until the end of chain is
reached. Each EventDispatcher
in the chain can influence the event
path and the event itself. The chain is usually formed by following some
parent - child hierarchy from the root to the event target and appending
all EventDispatcher
objects encountered to the chain.Modifier and Type | Method and Description |
---|---|
EventDispatchChain |
append(EventDispatcher eventDispatcher)
Appends the specified
EventDispatcher to this chain. |
Event |
dispatchEvent(Event event)
Dispatches the specified event through this
EventDispatchChain . |
EventDispatchChain |
prepend(EventDispatcher eventDispatcher)
Prepends the specified
EventDispatcher to this chain. |
EventDispatchChain append(EventDispatcher eventDispatcher)
EventDispatcher
to this chain. Returns a
reference to the chain with the appended element.
The caller shouldn't assume that this EventDispatchChain
remains
unchanged nor that the returned value will reference a different chain
after the call. All this depends on the EventDispatchChain
implementation.
So the call should be always done in the following form:
chain = chain.append(eventDispatcher);
eventDispatcher
- the EventDispatcher
to append to the
chainEventDispatchChain prepend(EventDispatcher eventDispatcher)
EventDispatcher
to this chain. Returns a
reference to the chain with the prepended element.
The caller shouldn't assume that this EventDispatchChain
remains
unchanged nor that the returned value will reference a different chain
after the call. All this depends on the EventDispatchChain
implementation.
So the call should be always done in the following form:
chain = chain.prepend(eventDispatcher);
eventDispatcher
- the EventDispatcher
to prepend to the
chainEvent dispatchEvent(Event event)
EventDispatchChain
.
The return value represents the event after processing done by the chain.
If further processing is to be done after the call the event referenced
by the return value should be used instead of the original event. In the
case the event is fully handled / consumed in the chain the returned
value is null
and no further processing should be done with that
event.event
- the event to dispatchnull
if the event had been fully
handled / consumedCopyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved. Use is subject to