インターフェース Context

既知のすべてのサブインターフェース:
AlterableContext

public interface Context

任意のコンテキスト型の特定のスコープを持つコンテキストインスタンスを取得するための操作を提供します。Context のインスタンスは、コンテキストオブジェクトと呼ばれます。

AlterableContext は CDI 1.1 で導入され、アプリケーションによって Bean インスタンスを破棄できるようになりました。拡張機能は Context ではなく AlterableContext を実装する必要があります。

コンテキストオブジェクトは、Contextual の操作を呼び出して、コンテキストインスタンスを作成および破棄します。特に、コンテキストオブジェクトは、インスタンスを Contextual.destroy(Object, CreationalContext) に渡すことによって作成するコンテキストインスタンスを破棄します。破棄されたインスタンスは、その後 get() によって返されてはなりません。コンテキストオブジェクトは、インスタンスの作成時に Contextual.create() に渡したのと同じ CreationalContext のインスタンスを Contextual.destroy() に渡す必要があります。

カスタムコンテキストオブジェクトは、AfterBeanDiscovery.addContext(Context) を使用してコンテナーに登録できます。

作成者:
Gavin King, Pete Muir
  • 方法の概要

    修飾子と型
    メソッド
    説明
    <T> T
    get(Contextual<T> contextual)
    特定のコンテキスト型の既存のインスタンスまたは null 値を返します。
    <T> T
    get(Contextual<T> contextual, CreationalContext<T> creationalContext)
    特定のコンテキスト型の既存のインスタンスを返すか、Contextual.create(CreationalContext) を呼び出して新しいインスタンスを作成し、新しいインスタンスを返します。
    コンテキストオブジェクトのスコープ型を取得します。
    boolean
    コンテキストオブジェクトがアクティブかどうかを決定します。
  • 方法の詳細

    • getScope

      ClassSE<? extends AnnotationSE> getScope()
      コンテキストオブジェクトのスコープ型を取得します。
      戻り値:
      範囲
    • get

      <T> T get(Contextual<T> contextual, CreationalContext<T> creationalContext)
      特定のコンテキスト型の既存のインスタンスを返すか、Contextual.create(CreationalContext) を呼び出して新しいインスタンスを作成し、新しいインスタンスを返します。
      型パラメーター:
      T - コンテキスト型の型
      パラメーター:
      contextual - コンテキスト型
      creationalContext - 新しいインスタンスが作成されるコンテキスト
      戻り値:
      コンテキストインスタンス
      例外:
      ContextNotActiveException - コンテキストがアクティブでない場合
    • get

      <T> T get(Contextual<T> contextual)
      特定のコンテキスト型の既存のインスタンスまたは null 値を返します。
      型パラメーター:
      T - コンテキスト型の型
      パラメーター:
      contextual - コンテキスト型
      戻り値:
      コンテキストインスタンス、または null 値
      例外:
      ContextNotActiveException - コンテキストがアクティブでない場合
    • isActive

      boolean isActive()
      コンテキストオブジェクトがアクティブかどうかを決定します。
      戻り値:
      コンテキストがアクティブな場合は true、それ以外の場合は false。