クラス PostAddToViewEvent
- java.lang.ObjectSE
-
- java.util.EventObjectSE
-
- jakarta.faces.event.SystemEvent
-
- jakarta.faces.event.ComponentSystemEvent
-
- jakarta.faces.event.PostAddToViewEvent
- 実装済みのインターフェース一覧:
SerializableSE
public class PostAddToViewEvent extends ComponentSystemEvent
このイベントのインスタンスが
SystemEventListener.processEvent(jakarta.faces.event.SystemEvent)またはComponentSystemEventListener.processEvent(jakarta.faces.event.ComponentSystemEvent)に渡されると 、リスナーの実装では、このイベントインスタンスのsourceがUIComponentインスタンスと、そのインスタンスまたはそのインスタンスの祖先のいずれかがちょうどビューに追加されたことと仮定することができます。実装では、UIComponent.getParent()、UIComponent.getClientId()、ビューに追加されるコンポーネントインスタンスに依存するその他のメソッドを呼び出しても安全であると想定する場合があります。FacesContext.getCurrentPhaseId()がPhaseId.RESTORE_VIEWを 返すと同時にResponseStateManager.isPostback(jakarta.faces.context.FacesContext)がtrueを返す場合を除いて、UIComponentインスタンスがビュー階層に追加された直後に、Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)が呼び出されることを実装は保証する必要があります。これらの条件が両方とも満たされた場合、Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)を呼び出さないでください。実装は、
Application.publishEvent(jakarta.faces.context.FacesContext, java.lang.Class<? extends jakarta.faces.event.SystemEvent>, java.lang.Object)が以下の場合に呼び出されることを保証する必要があります。ビューの初期構築時、各インスタンスがビューに追加されたとき。
ビューの非初期レンダリングで、
c:if、ui:includeなどの VDL タグ、動的に実行されるその他のタグによって参照される Jakarta Expression Language 式の評価結果の変更の結果として、ビュー宣言言語の実装によってコンポーネントがビューに追加された場合ビューのアセンブリに影響を与えます。コンポーネントが Java API を直接使用してプログラムによってビューに追加された場合。例: ユーザーコードは
comp.getChildren().add()を使用して手動で子を追加します。compはUIComponentです。
- 導入:
- 2.0
- 関連事項:
- 連載形式
フィールド概要
クラス java.util.EventObjectSE から継承されたフィールド
sourceSE
コンストラクター概要
コンストラクター コンストラクター 説明 PostAddToViewEvent(UIComponent component)引数componentがビューに追加されたばかりであることを示す新しいPostAddToViewEventをインスタンス化します。PostAddToViewEvent(FacesContext facesContext, UIComponent component)引数componentがビューに追加されたばかりであることを示す新しいPostAddToViewEventをインスタンス化します。
方法の概要
すべてのメソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 booleanisAppropriateListener(FacesListener listener)クラス jakarta.faces.event.ComponentSystemEvent から継承されたメソッド
getComponent, processListener
クラス jakarta.faces.event.SystemEvent から継承されたメソッド
getFacesContext
クラス java.util.EventObjectSE から継承されたメソッド
getSource, toString
コンストラクターの詳細
PostAddToViewEvent
public PostAddToViewEvent(UIComponent component)
引数
componentがビューに追加されたばかりであることを示す新しいPostAddToViewEventをインスタンス化します。- パラメーター:
component- ビューに追加されたばかりのUIComponent- 例外:
IllegalArgumentExceptionSE- 引数がnullの場合。
PostAddToViewEvent
public PostAddToViewEvent(FacesContext facesContext, UIComponent component)
引数
componentがビューに追加されたばかりであることを示す新しいPostAddToViewEventをインスタンス化します。- パラメーター:
facesContext- Faces コンテキスト。component- ビューに追加されたばかりのUIComponent- 例外:
IllegalArgumentExceptionSE- 引数がnullの場合。
メソッドの詳細
isAppropriateListener
public boolean isAppropriateListener(FacesListener listener)
引数
listenerがSystemEventListenerのインスタンスである場合に限り、trueを返します。- オーバーライド:
- クラス
ComponentSystemEventのisAppropriateListener - パラメーター:
listener- Faces リスナー。- 戻り値:
- 適切なリスナーの場合は true、それ以外の場合は false。