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 です。
sourceSE| コンストラクターと説明 |
|---|
PostAddToViewEvent(FacesContext facesContext, UIComponent component) 引数 |
PostAddToViewEvent(UIComponent component) 引数 |
| 修飾子と型 | メソッドと説明 |
|---|---|
boolean | isAppropriateListener(FacesListener listener) 引数 |
getComponent, processListenergetFacesContextgetSourceSE, toStringSEcloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, waitSE, waitSE, waitSEpublic PostAddToViewEvent(UIComponent component)
引数 component がビューに追加されたばかりであることを示す新しい PostAddToViewEvent をインスタンス化します。
component - ビューに追加されたばかりの UIComponent IllegalArgumentExceptionSE - 引数が null の場合。public PostAddToViewEvent(FacesContext facesContext, UIComponent component)
引数 component がビューに追加されたばかりであることを示す新しい PostAddToViewEvent をインスタンス化します。
facesContext - Faces コンテキスト。component - ビューに追加されたばかりの UIComponent IllegalArgumentExceptionSE - 引数が null の場合。public boolean isAppropriateListener(FacesListener listener)
引数 listener が SystemEventListener のインスタンスである場合に限り、true を返します。
ComponentSystemEvent の isAppropriateListener listener - Faces リスナー。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.