パッケージ jakarta.faces.event

クラス 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
関連事項:

  • コンストラクターの詳細

    • 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。