パッケージ jakarta.faces.lifecycle

クラス LifecycleFactory

java.lang.ObjectSE
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 final StringSE
    DEFAULT_LIFECYCLE
    この Jakarta Faces 実装のデフォルト Lifecycle インスタンスのライフサイクル ID。

  • コンストラクターの概要

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

  • 方法の概要

    修飾子と型
    メソッド
    説明
    abstract void
    addLifecycle(StringSE lifecycleId, Lifecycle lifecycle)
    この LifecycleFactory でサポートされる、指定された lifecycleId に関連付けられた新しい Lifecycle インスタンスを登録します。
    abstract Lifecycle
    getLifecycle(StringSE lifecycleId)
    （必要に応じて）指定されたライフサイクル識別子の Lifecycle インスタンスを作成して返します。
    abstract IteratorSE<StringSE>
    getLifecycleIds()
    このファクトリでサポートされているライフサイクル識別子のセットに対して Iterator を返します。
    LifecycleFactory
    getWrapped()
    このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。

    クラス java.lang.ObjectSE から継承されたメソッド

    clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE

  • フィールドの詳細

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

    • 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