Class PreRenderViewEvent

All Implemented Interfaces:
Serializable

public class PreRenderViewEvent extends ComponentSystemEvent

When an instance of this event is passed to SystemEventListener.processEvent(javax.faces.event.SystemEvent) or ComponentSystemEventListener.processEvent(javax.faces.event.ComponentSystemEvent), the listener implementation may assume that the source of this event instance is the UIViewRoot instance that is about to be rendered.

It is valid for a listener for this event to change the UIViewRoot in the current FacesContext, but the listener must ensure that the new UIViewRoot was created with a call to ViewHandler.createView(javax.faces.context.FacesContext, java.lang.String), and that the view is fully populated with the children to be traversed during render. The listener implementation may call ViewDeclarationLanguage.buildView(javax.faces.context.FacesContext, javax.faces.component.UIViewRoot) to populate the UIViewRoot.

Since:
2.0
See Also:
  • Constructor Details

    • PreRenderViewEvent

      public PreRenderViewEvent(UIViewRoot root)

      Instantiate a new PreRenderViewEvent that indicates the argument root is about to be rendered.

      Parameters:
      root - the UIViewRoot that is about to be rendered.
      Throws:
      IllegalArgumentException - if the argument is null.
    • PreRenderViewEvent

      public PreRenderViewEvent(FacesContext facesContext, UIViewRoot root)

      Instantiate a new PreRenderViewEvent that indicates the argument root is about to be rendered.

      Parameters:
      facesContext - the Faces context.
      root - the UIViewRoot that is about to be rendered.
      Throws:
      IllegalArgumentException - if the argument is null.