Интерфейс EventDispatcher

public interface EventDispatcher

Представляет собой сущность, отвечающую за рассылку и обработку событий. Используется, когда событие (Event) необходимо разослать связанным объектам (EventTarget) через цепочку (EventDispatchChain), указанную целевым объектом. Каждый элемент в цепочке может влиять на путь события и само событие. Один элемент (EventDispatcher) может присутствовать в нескольких цепочках.

Система определяет две последовательные фазы доставки события. Первая фаза — фаза захвата — происходит, когда событие проходит от первого до последнего элемента цепочки (EventDispatchChain), связанной с целевым объектом. Если целевой объект является частью иерархии, направление события в этой фазе обычно соответствует направлению от корневого элемента иерархии к целевому объекту. Вторая фаза — фаза всплытия — происходит в обратном порядке по сравнению с первой фазой. Таким образом, событие возвращается от последнего элемента цепочки (EventDispatchChain) к первому. Обычно это соответствует направлению от целевого объекта обратно к корню в иерархии целевого объекта.

Каждый элемент (EventDispatcher) в цепочке (EventDispatchChain) отвечает за пересылку события остальным элементам цепочки во время обработки события. Эта пересылка происходит в методе (dispatchEvent) и образует цепочку вложенных вызовов, что позволяет одному объекту (EventDispatcher) видеть событие во время обеих фаз обработки в одном вызове (dispatchEvent).

Шаблон реализации для (dispatchEvent).

public Event dispatchEvent(Event event, EventDispatchChain tail) {
    // capturing phase, can handle / modify / substitute / divert the event

    if (notHandledYet) {
        // forward the event to the rest of the chain
        event = tail.dispatchEvent(event);

        if (event != null) {
            // bubbling phase, can handle / modify / substitute / divert
            // the event
        }
    }

    return notHandledYet ? event : null;

}