パッケージ jakarta.faces.lifecycle

クラス LifecycleFactory

  • 実装されたすべてのインターフェース:
    FacesWrapper<LifecycleFactory>
    public abstract class LifecycleFactory
extends ObjectSE
implements FacesWrapper<LifecycleFactory>

    LifecycleFactory は、（必要に応じて）Lifecycle インスタンスを作成して返すファクトリオブジェクトです。Jakarta Faces の実装は、少なくとも Lifecycle のデフォルトの実装を提供する必要があります。高度な実装（または外部のサードパーティライブラリ）は、リクエストごとにさまざまな型のリクエスト処理を実行するための追加の Lifecycle 実装（ライフサイクル識別子によってキー設定）を提供する場合があります。

    Jakarta Faces を利用する Web アプリケーションごとに 1 つの LifecycleFactory インスタンスが必要です。このインスタンスは、次の呼び出しにより、移植可能な方法で取得できます。

     LifecycleFactory factory = (LifecycleFactory) FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY);

    使用方法: このクラスを継承し、ラップされている実装をコンストラクターにプッシュし、getWrapped() を使用してラップされているインスタンスにアクセスします。

    • フィールドサマリー

      フィールド  
      修飾子と型 フィールド 説明
      static StringSEDEFAULT_LIFECYCLE
      この Jakarta Faces 実装のデフォルト Lifecycle インスタンスのライフサイクル ID。

    • コンストラクターのサマリー

      コンストラクター  
      コンストラクター 説明
      LifecycleFactory()
      使用すべきではありません。
      ラップされている実装を使用する他のコンストラクターを使用します。
      LifecycleFactory​(LifecycleFactory wrapped)
      このファクトリが装飾されている場合、装飾を行う実装は、ラップされている実装をこのコンストラクターにプッシュする必要があります。

    • フィールドの詳細

    • コンストラクターの詳細

      • LifecycleFactory

        @DeprecatedSE
public LifecycleFactory()
        使用すべきではありません。
        ラップされている実装を使用する他のコンストラクターを使用します。

      • LifecycleFactory

        public LifecycleFactory​(LifecycleFactory wrapped)

        このファクトリが装飾されている場合、装飾を行う実装は、ラップされている実装をこのコンストラクターにプッシュする必要があります。getWrapped() は、ラップされている実装を返します。

        パラメーター:
        wrapped - ラップされる実装。

    • メソッドの詳細

      • getWrapped

        public LifecycleFactory getWrapped()

        このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。

        次で指定:
        インターフェース FacesWrapper<LifecycleFactory> の getWrapped 
        戻り値:
        ラップされたインスタンス。
        導入:
        2.0

      • addLifecycle

        public abstract void addLifecycle​(StringSE lifecycleId,
                                  Lifecycle lifecycle)

        この LifecycleFactory でサポートされる、指定された lifecycleId に関連付けられた新しい Lifecycle インスタンスを登録します。このメソッドはいつでも呼び出すことができ、対応する Lifecycle インスタンスをこの Web アプリケーションの残りの存続期間を通じて使用可能にします。

        パラメーター:
        lifecycleId - 新しい Lifecycle の識別子
        lifecycle - 登録している Lifecycle インスタンス
        例外:
        IllegalArgumentExceptionSE - 指定された lifecycleId の Lifecycle がすでに登録されている場合
        NullPointerExceptionSE - lifecycleId または lifecycle が null の場合

      • getLifecycle

        public abstract Lifecycle getLifecycle​(StringSE lifecycleId)

        （必要に応じて）指定されたライフサイクル識別子の Lifecycle インスタンスを作成して返します。使用可能なライフサイクル識別子のセットは、getLifecycleIds() メソッドを介して使用できます。

        同じ Web アプリケーション内からの同じ lifecycleId に対する getLifecycle() の各呼び出しは、同じ Lifecycle インスタンスを返す必要があります。

        パラメーター:
        lifecycleId - リクエストされた Lifecycle インスタンスのライフサイクル識別子
        戻り値:
        Lifecycle インスタンス
        例外:
        IllegalArgumentExceptionSE - 指定された識別子に対して Lifecycle インスタンスを返すことができない場合
        NullPointerExceptionSE - lifecycleId が null の場合

      • getLifecycleIds

        public abstract IteratorSE<StringSE> getLifecycleIds()

        このファクトリでサポートされているライフサイクル識別子のセットに対して Iterator を返します。このセットには、LifecycleFactory.DEFAULT_LIFECYCLE で指定された値が含まれている必要があります。

        戻り値:
        このファクトリでサポートされているライフサイクル識別子のセットに対する Iterator