Интерфейс 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;