Class FacesEvent

Constructor Detail

• FacesEvent

  public FacesEvent(UIComponent component)

  Construct a new event object from the specified source component.

  Parameters:

  component - Source UIComponent for this event

  Throws:

  IllegalArgumentException - if component is null

Method Detail

• getComponent

  public UIComponent getComponent()

  Return the source UIComponent that sent this event.

• getPhaseId

  public PhaseId getPhaseId()

  Return the identifier of the request processing phase during which this event should be delivered. Legal values are the singleton instances defined by the PhaseId class, including PhaseId.ANY_PHASE, which is the default value.

• setPhaseId

  public void setPhaseId(PhaseId phaseId)

  Set the PhaseId during which this event will be delivered.

  Throws:

  IllegalArgumentException - phaseId is null.

• queue

  public void queue()

  Convenience method to queue this event for broadcast at the end of the current request processing lifecycle phase.

  Throws:

  IllegalStateException - if the source component for this event is not a descendant of a UIViewRoot

• isAppropriateListener

  public abstract boolean isAppropriateListener(FacesListener listener)

  Return true if this FacesListener is an instance of a listener class that this event supports. Typically, this will be accomplished by an "instanceof" check on the listener class.

  Parameters:

  listener - FacesListener to evaluate

• processListener

  public abstract void processListener(FacesListener listener)

  Broadcast this FacesEvent to the specified FacesListener, by whatever mechanism is appropriate. Typically, this will be accomplished by calling an event processing method, and passing this FacesEvent as a paramter.

  Parameters:

  listener - FacesListener to send this FacesEvent to

  Throws:

  AbortProcessingException - Signal the JavaServer Faces implementation that no further processing on the current event should be performed