public abstract class FacesEvent extends EventObject
FacesEvent is the base class for user interface and
application events that can be fired by UIComponent
s. Concrete
event classes must subclass FacesEvent
in order to be supported
by the request processing lifecycle.
source
Constructor and Description |
---|
FacesEvent(UIComponent component)
Construct a new event object from the specified source component.
|
Modifier and Type | Method and Description |
---|---|
UIComponent |
getComponent()
Return the source
UIComponent that sent this event. |
PhaseId |
getPhaseId()
Return the identifier of the request processing phase during
which this event should be delivered.
|
abstract boolean |
isAppropriateListener(FacesListener listener)
Return
true if this FacesListener is an instance
of a listener class that this event supports. |
abstract void |
processListener(FacesListener listener)
Broadcast this
FacesEvent to the specified
FacesListener , by whatever mechanism is appropriate. |
void |
queue()
Convenience method to queue this event for broadcast at the end
of the current request processing lifecycle phase.
|
void |
setPhaseId(PhaseId phaseId)
Set the
PhaseId during which this event will be
delivered. |
getSource, toString
public FacesEvent(UIComponent component)
Construct a new event object from the specified source component.
component
- Source UIComponent
for this eventIllegalArgumentException
- if component
is
null
public UIComponent getComponent()
Return the source UIComponent
that sent this event.
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.
public void setPhaseId(PhaseId phaseId)
Set the PhaseId
during which this event will be
delivered.
IllegalArgumentException
- phaseId is null.public void queue()
Convenience method to queue this event for broadcast at the end of the current request processing lifecycle phase.
IllegalStateException
- if the source component for this
event is not a descendant of a UIViewRoot
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.
listener
- FacesListener
to evaluatepublic 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.
listener
- FacesListener
to send this FacesEvent
toAbortProcessingException
- Signal the JavaServer Faces
implementation that no further processing on the current event
should be performedCopyright © 2017 JBoss by Red Hat. All rights reserved.