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 jakarta.faces.application.Application#publishEvent is called,
immediately after any UIComponent instance is added to the view hierarchy except in the
case where jakarta.faces.render.ResponseStateManager#isPostback returns true at the same
time as jakarta.faces.context.FacesContext#getCurrentPhaseId returns
jakarta.faces.event.PhaseId#RESTORE_VIEW. When both of those conditions are met,
jakarta.faces.application.Application#publishEvent must not be called.
The implementation must guarantee that jakarta.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
implementation as a result of changes in evaluation result of Jakarta Expression Language 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 jakarta.
Returns |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID Hides jakarta. | |
| 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 jakarta.
Returns
| |