Интерфейс EventDispatcher

public interface EventDispatcher

Объект EventDispatcher представляет собой сущность для диспетчеризации и обработки событий. Он используется, когда необходимо отправить событие Event ассоциированному EventTarget через EventDispatchChain, указанный целевым объектом. Каждый EventDispatcher в цепочке может влиять на путь события и само событие. Один 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;

}