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 javax.faces.application.Application#publishEvent is called,
immediately after any UIComponent instance is added to
the view hierarchy except in the case where javax.faces.render.ResponseStateManager#isPostback returns
true at the same time as javax.faces.context.FacesContext#getCurrentPhaseId returns javax.faces.event.PhaseId#RESTORE_VIEW. When both of those
conditions are met, javax.faces.application.Application#publishEvent must not be called.
The implementation must guarantee that javax.faces.application.Application#publishEvent is called in the
following cases.
Upon the initial construction of the view, when each instance is added to the view.
On a non-initial rendering of the view, if a component
is added to the view by the View Declaration Language
implememtation as a result of changes in evaluation result of
EL expressions referenced by VDL tags such as
c:if, ui:include, and other tags
that dynamically influence the assembly of the view.
If a component is programmatically added to the view
using the Java API directly. For example, user code manually
adds children using comp.getChildren().add(),
where comp is a UIComponent.
| Modifier and Type | Field and Description |
|---|---|
| private static final long |
| Access | Constructor and Description |
|---|---|
| public | PostAddToViewEvent(UIComponent
the component)UIComponent that has just been
added to the view.Instantiate a new
|
| public | PostAddToViewEvent(FacesContext
the Faces context. facesContext, UIComponent the component)UIComponent that has just been
added to the view.Instantiate a new
|
| Modifier and Type | Method and Description |
|---|---|
| public boolean | Returns: true if it is an appropriate listener, false otherwise.the faces listener. listener)Overrides javax. Returns |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID Hides javax. | |
| PostAddToViewEvent | back to summary |
|---|---|
| public PostAddToViewEvent(UIComponent component) Instantiate a new
| |
| PostAddToViewEvent | back to summary |
|---|---|
| public PostAddToViewEvent(FacesContext facesContext, UIComponent component) Instantiate a new
| |
| isAppropriateListener | back to summary |
|---|---|
| public boolean isAppropriateListener(FacesListener listener) Overrides javax. Returns
| |