パッケージ jakarta.enterprise.inject.spi

インターフェース ProcessObserverMethod<T,​X>

  • 型パラメーター:
    T - 監視されているイベントの型
    X - オブザーバーメソッドを含む Bean 型
    すべての既知のサブインターフェース:
    ProcessSyntheticObserverMethod<T,​X>
    public interface ProcessObserverMethod<T,​X>

    コンテナーは、ObserverMethod オブジェクトを登録する前に、有効な Bean ごとのオブザーバーメソッドごとにこの型のイベントを発生させます。

    ObserverMethod のカスタム実装の場合、コンテナーは ProcessSyntheticObserverMethod 型のイベントを発生させる必要があります。

    このイベントのオブザーバーは、setObserverMethod(ObserverMethod) または configureObserverMethod() のいずれかを呼び出すことにより、ObserverMethod をラップまたは置換することができます。両方のメソッドがオブザーバー通知内で呼び出されると、IllegalStateExceptionSE がスローされます。コンテナーは、すべてのオブザーバーが呼び出された後、このプロパティの最終値を使用する必要があります。コンテナーは、すべてのオブザーバーが呼び出された後、オブザーバー解決を実行するたびに、このプロパティの最終値を使用する必要があります。

    ProcessObserverMethod イベントのオブザーバーメソッドが例外をスローした場合、その例外はコンテナーによって定義エラーとして扱われます。

    CDI Lite の実装は、Portable Extensions のサポートを提供する必要はありません。

    作成者:
    Gavin King, David Allen, Antoine Sabot-Durand
    関連事項:
    ObserverMethod

    • メソッドの詳細

      • getObserverMethod

        ObserverMethod<T> getObserverMethod()
        一致するイベントが発生したときにオブザーバーを呼び出すためにコンテナーによって使用される ObserverMethod オブジェクト。
        戻り値:
        オブザーバーメソッドを呼び出すためにコンテナーによって使用される ObserverMethod オブジェクト
        例外:
        IllegalStateExceptionSE - オブザーバーメソッド呼び出し以外で呼び出された場合

      • addDefinitionError

        void addDefinitionError​(ThrowableSE t)
        定義エラーをコンテナーに登録し、Bean ディスカバリの完了後にコンテナーがデプロイをアボートするようにします。
        パラメーター:
        t - 定義エラーを表す ThrowableSE
        例外:
        IllegalStateExceptionSE - オブザーバーメソッド呼び出し以外で呼び出された場合

      • setObserverMethod

        void setObserverMethod​(ObserverMethod<T> observerMethod)
        ObserverMethod を置き換えます。
        パラメーター:
        observerMethod - 使用する新しい ObserverMethod オブジェクト
        例外:
        IllegalStateExceptionSE - オブザーバーメソッド呼び出し以外で呼び出された場合
        導入:
        2.0

      • configureObserverMethod

        ObserverMethodConfigurator<T> configureObserverMethod()
        このイベントによって処理された ObserverMethod で初期化された ObserverMethodConfigurator を返し、オブザーバー呼び出しの最後に元の ObserverMethod を置き換える新しい ObserverMethod を構成します。各呼び出しは同じ ObserverMethodConfigurator を返します
        戻り値:
        再利用できない ObserverMethodConfigurator で、置換 ObserverMethod を構成する
        例外:
        IllegalStateExceptionSE - オブザーバーメソッド呼び出し以外で呼び出された場合
        導入:
        2.0

      • veto

        void veto()
        コンテナーにオブザーバーメソッドを無視させる。
        例外:
        IllegalStateExceptionSE - オブザーバーメソッド呼び出し以外で呼び出された場合
        導入:
        2.0