jakarta.faces.event (Jakarta EE Platform API)

インターフェースのサマリー
インターフェース	説明
ActionListener	`ActionEvent` を受信するためのリスナーインターフェース。
AjaxBehaviorListener	このクラスを実装することにより、オブジェクトは、それが 1 種類以上の `BehaviorEvent` のリスナーであることを示します。
BehaviorListener	さまざまな型の `BehaviorEvent` のイベントリスナーの汎用基本インターフェース。
ComponentSystemEventListener	このクラスのインプリメンターは特定のコンポーネントインスタンスにのみインストールされるため、`isListenerForSource()` メソッドは必要ありません。`isListenerForSource()` メソッドは暗黙的です。
FacesListener	さまざまな型の `FacesEvent` のイベントリスナーの汎用基本インターフェース。
PhaseListener	リクエスト処理ライフサイクルの各標準フェーズの処理の開始時と終了時に通知されることを希望するオブジェクトによって実装されるインターフェース。
SystemEventListener	このクラスを実装することにより、オブジェクトは、それが 1 種類以上の `SystemEvent` のリスナーであることを示します。
SystemEventListenerHolder	このインターフェースを実装するクラスは、生成できる `SystemEvent` の種類ごとに `SystemEventListener` インスタンスのリストを維持することに同意します。
ValueChangeListener	`ValueChangeEvent` を受信するためのリスナーインターフェース。
ViewMapListener	ビューマップが作成された（`PostConstructViewMapEvent`、または破棄された（`PreDestroyViewMapEvent`）ことを示す `SystemEvent` のマーカーインターフェース。

クラスのサマリー
クラス	説明
ActionEvent	`ActionEvent` は、ユーザーインターフェースコンポーネント（`UICommand` など）のアクティブ化を表します。
ActionListenerWrapper	既存の `ActionListener` インスタンスに特別な動作を提供したい開発者がサブクラス化できる `ActionListener` の簡単な実装を提供します。
AjaxBehaviorEvent	AjaxBehaviorEvent は、`Ajax` に固有のコンポーネントの動作を表します）。
BehaviorEvent	BehaviorEvent は、コンポーネント `Behavior` から生成できるイベントです。
ComponentSystemEvent	ComponentSystemEvent は、`UIComponent` インスタンスに固有の `SystemEvent` の基本クラスです。
ExceptionQueuedEvent	システムイベントファシリティは、`systemEventClass` 引数として `ExceptionQueuedEvent.class` を指定して `Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)` が呼び出されるたびに、このクラスのインスタンスを作成します。
ExceptionQueuedEventContext	このヘルパークラスは、`ExceptionQueuedEvent` が発生した時点でのシステムの状態に関する `ExceptionQueuedEvent` へのコンテキストを提供し、`SystemEventListener` を実装することによって `ExceptionQueuedEvent` を `ExceptionHandler` にリンクします。
FacesEvent	FacesEvent は、`UIComponent` によって起動できるユーザーインターフェースとアプリケーションイベントの基本クラスです。
MethodExpressionActionListener	MethodExpressionActionListener は、`MethodExpression` をラップする `ActionListener` です。
MethodExpressionValueChangeListener	MethodExpressionValueChangeListener は、`MethodExpression` をラップする `ValueChangeListener` です。
PhaseEvent	PhaseEvent は、指定された `FacesContext` によってカプセル化されたリクエストの、リクエスト処理ライフサイクルの特定のフェーズの処理の開始または終了を表します。
PhaseId	`FacesEvent` インターフェースの `getPhaseId()` メソッドによって返されることができる有効な値の型保証列挙。
PostAddToViewEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装では、このイベントインスタンスの `source` が `UIComponent` インスタンスと、そのインスタンスまたはそのインスタンスの祖先のいずれかがちょうどビューに追加されたことと仮定することができます。
PostConstructApplicationEvent	このイベントは、すべての構成リソースが解析および処理された後に、ランタイムによって発行される必要があります。
PostConstructCustomScopeEvent	このクラスは、アプリケーションがスコープの開始を認識できるようにするために他のスコープが行うのと同じ方法で、カスタムスコープが「ポストコンストラクト」イベントを発行できるようにするために提供されています。
PostConstructViewMapEvent	このイベントは、ビューマップが最初に作成されたときに、{jakarta.faces.application.Application#publishEvent} を呼び出して公開する必要があります。
PostKeepFlashValueEvent	このイベントは、値がフラッシュに保持されているときに、`Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)` を呼び出して発行する必要があります。
PostPutFlashValueEvent	このイベントは、値がフラッシュに保存されているときに `Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)` を呼び出すことによって発行する必要があります。
PostRenderViewEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装は、このイベントインスタンスの `source` が、レンダリングされたばかりの `UIViewRoot` インスタンスであると想定する場合があります。
PostRestoreStateEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装は、このイベントインスタンスの `source` が、状態が復元されたばかりのツリーにあると想定する場合があります。
PostValidateEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナー実装は、このイベントインスタンスの `source` が、検証されたばかりの `UIComponent` インスタンスであると想定する場合があります。
PreClearFlashEvent	このイベントは、フラッシュがクリアされる前に、`Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)` を呼び出して発行する必要があります。
PreDestroyApplicationEvent	このイベントは、この `Application` に関連付けられたファクトリがリリースされる前に、ランタイムによって発行される必要があります。
PreDestroyCustomScopeEvent	このクラスは、アプリケーションがスコープの始まりを認識できるようにするために他のスコープが行うのと同じ方法で、カスタムスコープが「事前構成」イベントを発行できるようにするために提供されています。
PreDestroyViewMapEvent	このイベントは、`UIViewRoot.getViewMap()` から返されたマップで `clear` メソッドが呼び出されたときに、`Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)` を呼び出して発行する必要があります。
PreRemoveFlashValueEvent	このイベントは、フラッシュから値が削除されたときに `Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)` を呼び出して発行する必要があります。
PreRemoveFromViewEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装は、このイベントインスタンスの `source` がビューから削除されようとしている `UIComponent` インスタンスであると想定する場合があります。
PreRenderComponentEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装は、このイベントインスタンスの `source` がレンダリングされる `UIComponent` インスタンスであり、`UIComponent.getParent()`、`UIComponent.getClientId()`、その他のメソッドを呼び出しても安全であると想定する場合があります。ビューにあるコンポーネントインスタンスに依存します。
PreRenderViewEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装は、このイベントインスタンスの `source` が、これからレンダリングされる `UIViewRoot` インスタンスであると想定する場合があります。
PreValidateEvent	このイベントのインスタンスが `SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)` または `ComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)` に渡されると、リスナーの実装は、このイベントインスタンスの `source` が検証される `UIComponent` インスタンスであると想定する場合があります。
ScopeContext	スコープの名前と `Map<String, Object>` として公開されるスコープ自体を含む構造。
SystemEvent	SystemEvent は、任意のオブジェクトによって起動できる非アプリケーション固有のイベントの基本クラスです。
ValueChangeEvent	`ValueChangeEvent` は、ユーザーインターフェースアクティビティの結果として、ソースコンポーネントのローカル値が変更されたという通知です。
WebsocketEvent	この Web ソケットイベントは、新しい `<f:websocket>` が `@WebsocketEvent.Opened` または `@WebsocketEvent.Closed` になったときに発生します。

例外のサマリー
例外説明
AbortProcessingException
現在のイベントの処理を終了するためにイベントリスナーによってスローされる例外。

例外のサマリー
例外	説明
AbortProcessingException	現在のイベントの処理を終了するためにイベントリスナーによってスローされる例外。

アノテーション型のサマリー
アノテーション型	説明
ListenerFor	このアノテーションでタグ付けされたクラスは、メソッド `Application.subscribeToEvent(java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Class<?>, jakarta.faces.event.SystemEventListener)` または `UIComponent.subscribeToEvent(java.lang.Class<? extends jakarta.faces.event.SystemEvent>, jakarta.faces.event.ComponentSystemEventListener)`（状況に応じて、以下で説明）を使用してリスナーとしてインストールされます。
ListenersFor	単一のクラスに複数の `ListenerFor` アノテーションを指定するためのコンテナーアノテーション。
NamedEvent	クラスにこのアノテーションが存在すると、ページ内の `<f:event />` タグで使用する `ComponentSystemEvent` としてクラスがランタイムに自動的に登録されます。
WebsocketEvent.Closed	`<f:websocket>` が閉じたことを示します。
WebsocketEvent.Opened	`<f:websocket>` が開いたことを示します。

パッケージ jakarta.faces.event