public abstract class Lifecycle extends ObjectSE
ライフサイクルは、特定の Jakarta Server Faces リクエストのライフサイクル全体の処理を管理します。各フェーズの実行中に発生したアクティビティによって別段の指示がない限り、Jakarta Server Faces Specification によって定義されたすべてのフェーズを指定された順序で実行する責任があります。
Lifecycle のインスタンスは、指定されたライフサイクル ID に対して LifecycleFactory の getLifecycle() メソッドを呼び出すことによって作成されます。このインスタンスは複数の同時リクエスト間で共有されるため、スレッドセーフな方法で実装する必要があります。
| コンストラクターと説明 |
|---|
Lifecycle() |
| 修飾子と型 | メソッドと説明 |
|---|---|
abstract void | addPhaseListener(PhaseListener listener) リクエスト処理ライフサイクルの標準フェーズの処理の前後に通知されることに関心のある新しい PhaseListener インスタンスを登録します。 |
void | attachWindow(FacesContext context) ライフサイクル全体でこの実行の |
abstract void | execute(FacesContext context) リクエスト処理ライフサイクルのすべてのフェーズを、Jakarta Server Faces Specification に従って、Render Response フェーズまで(指定された順序で)実行します。 |
abstract PhaseListener[] | getPhaseListeners() この Lifecycle インスタンスに登録されている PhaseListener のセットを返します。 |
abstract void | removePhaseListener(PhaseListener listener) リクエスト処理ライフサイクルの標準フェーズの処理の前後に通知される必要がなくなった既存の PhaseListener インスタンスを登録解除します。 |
abstract void | render(FacesContext context) 現在のリクエストに関連付けられている FacesContext インスタンスで responseComplete() メソッドが呼び出されていない限り、リクエスト処理ライフサイクルのレスポンスのレンダリングフェーズを実行します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic abstract void addPhaseListener(PhaseListener listener)
リクエスト処理ライフサイクルの標準フェーズの処理の前後に通知されることに関心のある新しい PhaseListener インスタンスを登録します。
listener - 登録する PhaseListenerNullPointerExceptionSE - listener が null の場合 public abstract void execute(FacesContext context) throws FacesException
Jakarta Server Faces Specification に従って、レンダリングレスポンスフェーズまでの、リクエスト処理ライフサイクルのすべてのフェーズを指定された順序で実行します。処理フローは、現在のリクエストに関連付けられた FacesContext インスタンスの renderResponse() または responseComplete() メソッドへの呼び出しによって、(アプリケーション、コンポーネント、イベントリスナーによって)影響を受ける可能性があります。
context - 処理するリクエストの FacesContextFacesException - リクエスト処理ライフサイクルの実行中にスローされた場合 NullPointerExceptionSE - context が null の場合 public void attachWindow(FacesContext context)
ライフサイクル全体でこの実行の UIViewRoot を表示するために使用する ClientWindow を作成または復元します。機能の概要については、ClientWindow のクラスドキュメントを参照してください。ExternalContext.getClientWindow() が null を返す場合は、ClientWindowFactory を使用して ClientWindow の新しいインスタンスを作成します。結果が null でない場合は、ClientWindow.decode(jakarta.faces.context.FacesContext) を呼び出します。ExternalContext.setClientWindow(jakarta.faces.lifecycle.ClientWindow) を呼び出して、新しい ClientWindow を保存します。
context - このリクエストの FacesContextpublic abstract PhaseListener[] getPhaseListeners()
この Lifecycle インスタンスに登録されている PhaseListener のセットを返します。登録済みのリスナーがない場合は、長さ 0 の配列が返されます。
PhaseListener のセット public abstract void removePhaseListener(PhaseListener listener)
リクエスト処理ライフサイクルの標準フェーズの処理の前後に通知されることに関心がなくなった既存の PhaseListener インスタンスの登録を解除します。そのようなリスナーインスタンスが登録されていない場合、アクションは実行されません。
listener - 登録解除する PhaseListenerNullPointerExceptionSE - listener が null の場合 public abstract void render(FacesContext context) throws FacesException
現在のリクエストに関連付けられている FacesContext インスタンスで responseComplete() メソッドが呼び出されていない限り、リクエスト処理ライフサイクルのレスポンスのレンダリングフェーズを実行します。
context - 処理中のリクエストの FacesContextFacesException - リクエスト処理ライフサイクルの実行中に例外がスローされた場合 NullPointerExceptionSE - context が null の場合 Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.