パッケージ 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
関連事項:

  • 方法の詳細

    • getAnnotatedMethod

      AnnotatedMethod<X> getAnnotatedMethod()
      オブザーバーメソッドを表す AnnotatedMethod。

      ProcessSyntheticObserverMethod イベントで呼び出された場合、移植性のない動作が発生し、戻り値は無視されます。

      戻り値:
      オブザーバーメソッドを表す AnnotatedMethod
      例外:
      IllegalStateExceptionSE - オブザーバーメソッド呼び出し以外で呼び出された場合

    • 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