クラス 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
をインスタンス化します。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 boolean
isAppropriateListener(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。