パッケージ jakarta.faces.lifecycle

クラス Lifecycle

  • 既知の直属サブクラス
    LifecycleWrapper

    public abstract class Lifecycle
    extends ObjectSE

    ライフサイクルは、特定の Jakarta Faces リクエストのライフサイクル全体の処理を管理します。各フェーズの実行中に発生したアクティビティによって別段の指示がない限り、Jakarta Faces Specification によって定義されたすべてのフェーズを指定された順序で実行する責任があります。

    Lifecycle のインスタンスは、指定されたライフサイクル ID に対して LifecycleFactory の getLifecycle() メソッドを呼び出すことによって作成されます。このインスタンスは複数の同時リクエスト間で共有されるため、スレッドセーフな方法で実装する必要があります。

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

      • Lifecycle

        public Lifecycle()
    • メソッドの詳細

      • addPhaseListener

        public abstract void addPhaseListener​(PhaseListener listener)

        リクエスト処理ライフサイクルの標準フェーズの処理の前後に通知されることに関心のある新しい PhaseListener インスタンスを登録します。

        パラメーター:
        listener - 登録する PhaseListener
        例外:
        NullPointerExceptionSE - listener が null の場合
      • execute

        public abstract void execute​(FacesContext context)
                              throws FacesException

        Jakarta Faces Specification Document のセクション 2「リクエスト処理ライフサイクル」に従って、Render Response フェーズまでのリクエスト処理ライフサイクルのすべてのフェーズを指定された順序で実行します。処理フローは、現在のリクエストに関連付けられた FacesContext インスタンスの renderResponse() または responseComplete() メソッドの呼び出しによって (アプリケーション、コンポーネント、イベントリスナーによって) 影響を受ける可能性があります。

        パラメーター:
        context - 処理するリクエストの FacesContext
        例外:
        FacesException - リクエスト処理ライフサイクルの実行中にスローされた場合
        NullPointerExceptionSE - context が null の場合
      • getPhaseListeners

        public abstract PhaseListener[] getPhaseListeners()

        この Lifecycle インスタンスに登録されている PhaseListener のセットを返します。登録済みのリスナーがない場合は、長さ 0 の配列が返されます。

        戻り値:
        登録された PhaseListener のセット
      • removePhaseListener

        public abstract void removePhaseListener​(PhaseListener listener)

        リクエスト処理ライフサイクルの標準フェーズの処理の前後に通知されることに関心がなくなった既存の PhaseListener インスタンスの登録を解除します。そのようなリスナーインスタンスが登録されていない場合、アクションは実行されません。

        パラメーター:
        listener - 登録解除する PhaseListener
        例外:
        NullPointerExceptionSE - listener が null の場合
      • render

        public abstract void render​(FacesContext context)
                             throws FacesException

        現在のリクエストに関連付けられている FacesContext インスタンスで responseComplete() メソッドが呼び出されていない限り、リクエスト処理ライフサイクルのレスポンスレンダリングフェーズを実行します。

        パラメーター:
        context - 処理中のリクエストの FacesContext
        例外:
        FacesException - リクエスト処理ライフサイクルの実行中に例外がスローされた場合
        NullPointerExceptionSE - context が null の場合