javax.faces.event
Class PostAddToViewEvent

java.lang.Object
  java.util.EventObject
      javax.faces.event.SystemEvent
          javax.faces.event.ComponentSystemEvent
              javax.faces.event.PostAddToViewEvent

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

PostAddToViewNonPDLEvent

public class PostAddToViewEvent
extends ComponentSystemEvent

When an instance of this event is passed to SystemEventListener#processEvent or ComponentSystemEventListener#processEvent, the listener implementation may assume that the source of this event instance is a UIComponent instance and that either that instance or an ancestor of that instance was just added to the view. Therefore, the implementation may assume it is safe to call UIComponent#getParent, UIComponent#getClientId, and other methods that depend upon the component instance being added into the view.

The implementation must guarantee that Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class, java.lang.Object) is called, immediately after any UIComponent instance is added to the view hierarchy except in the case where ResponseStateManager.isPostback(javax.faces.context.FacesContext) returns true at the same time as FacesContext.getCurrentPhaseId() returns PhaseId.RESTORE_VIEW. When both of those conditions are met, Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class, java.lang.Object) must not be called.

Since:

2.0

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

PostAddToViewEvent(UIComponent component)

Instantiate a new PostAddToViewEvent that indicates the argument component was just added to the view.

Method Summary

boolean

isAppropriateListener(FacesListener listener) Returns true if and only if the argument listener is an instance of SystemEventListener.

Methods inherited from class javax.faces.event.ComponentSystemEvent

getComponent

Methods inherited from class javax.faces.event.SystemEvent

processListener

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PostAddToViewEvent

public PostAddToViewEvent(UIComponent component)

Instantiate a new PostAddToViewEvent that indicates the argument component was just added to the view.

Parameters:

component - the UIComponent that has just been added to the view.

Throws:

IllegalArgumentException - if the argument is null.

Method Detail

isAppropriateListener

public boolean isAppropriateListener(FacesListener listener)

Returns true if and only if the argument listener is an instance of SystemEventListener.

Overrides:

isAppropriateListener in class SystemEvent

Parameters:

listener -