public interface EventDispatchChain
EventをディスパッチできるEventDispatcherオブジェクトのチェーンを表します。 イベントは、チェーン内の1つのEventDispatcherから次へと、チェーンの最後に到達するまで渡されることによってディスパッチされます。 チェーン内の各EventDispatcherは、イベント・パスおよびイベント自体に影響を及ぼすことができます。 チェーンは、通常、ルートからイベント・ターゲットへの親子階層に従い、発生したすべてのEventDispatcherオブジェクトをチェーンに追加することによって形成されます。 | 修飾子と型 | メソッドと説明 |
|---|---|
EventDispatchChain |
append(EventDispatcher eventDispatcher)
指定された
EventDispatcherをこのチェーンに追加します。 |
Event |
dispatchEvent(Event event)
指定されたイベントをこの
EventDispatchChainを介してディスパッチします。 |
EventDispatchChain |
prepend(EventDispatcher eventDispatcher)
指定された
EventDispatcherをこのチェーンの先頭に追加します。 |
EventDispatchChain append(EventDispatcher eventDispatcher)
EventDispatcherをこのチェーンに追加します。 追加された要素を含むチェーンへの参照を返します。
呼出し元は、このEventDispatchChainが変更されないと想定することも、返された値が呼出し後に異なるチェーンを参照すると想定することもできません。 これはすべて、EventDispatchChainの実装によって異なります。
そのため、呼出しは常に次の形式で実行する必要があります。chain = chain.append(eventDispatcher);
eventDispatcher - チェーンに追加するEventDispatcherEventDispatchChain prepend(EventDispatcher eventDispatcher)
EventDispatcherをこのチェーンの先頭に追加します。 先頭に追加された要素を含むチェーンへの参照を返します。
呼出し元は、このEventDispatchChainが変更されないと想定することも、返された値が呼出し後に異なるチェーンを参照すると想定することもできません。 これはすべて、EventDispatchChainの実装によって異なります。
そのため、呼出しは常に次の形式で実行する必要があります。chain = chain.prepend(eventDispatcher);
eventDispatcher - チェーンの先頭に追加するEventDispatcherEvent dispatchEvent(Event event)
EventDispatchChainを介してディスパッチします。 戻り値は、チェーンによって処理が実行された後のイベントを表します。 呼出し後に後続処理を実行する必要がある場合は、元のイベントではなく、戻り値が参照するイベントを使用する必要があります。 イベントがチェーンで完全に処理/消費された場合、戻り値はnullになり、そのイベントには後続処理を実行できません。 event - ディスパッチするイベントnullCopyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.