Class SystemEvent
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
ComponentSystemEvent
,ExceptionQueuedEvent
,PostConstructApplicationEvent
,PostConstructCustomScopeEvent
,PostKeepFlashValueEvent
,PostPutFlashValueEvent
,PreClearFlashEvent
,PreDestroyApplicationEvent
,PreDestroyCustomScopeEvent
,PreRemoveFlashValueEvent
public abstract class SystemEvent extends EventObject
SystemEvent is the base class for non-application specific events that can be fired by arbitrary objects.
- Since:
- 2.0
- See Also:
- Serialized Form
-
Field Summary
-
Constructor Summary
Constructors Constructor Description SystemEvent(FacesContext facesContext, Object source)
Pass the argumentsource
to the superclass constructor.SystemEvent(Object source)
Pass the argumentsource
to the superclass constructor. -
Method Summary
Modifier and Type Method Description FacesContext
getFacesContext()
Get the Faces context.boolean
isAppropriateListener(FacesListener listener)
Returntrue
if thisFacesListener
is an instance of a the appropriate listener class that this event supports.void
processListener(FacesListener listener)
Broadcast this event instance to the specifiedFacesListener
, by whatever mechanism is appropriate.
-
Constructor Details
-
SystemEvent
Pass the argument
source
to the superclass constructor.- Parameters:
source
- thesource
reference to be passed to the superclass constructor.- Throws:
IllegalArgumentException
- if the argument isnull
.
-
SystemEvent
Pass the argument
source
to the superclass constructor.- Parameters:
facesContext
- the Faces context.source
- thesource
reference to be passed to the superclass constructor.- Throws:
IllegalArgumentException
- if the argument isnull
.
-
-
Method Details
-
getFacesContext
Get the Faces context.
If the constructor was passed a FacesContext we return it, otherwise we call FacesContext.getCurrentInstance() and return it.
- Returns:
- the Faces context.
- Since:
- 2.3
-
isAppropriateListener
Return
true
if thisFacesListener
is an instance of a the appropriate listener class that this event supports. The default implementation returns true if the listener is aComponentSystemEventListener
.- Parameters:
listener
-FacesListener
to evaluate- Returns:
- the result as specified above
-
processListener
Broadcast this event instance to the specified
FacesListener
, by whatever mechanism is appropriate. Typically, this will be accomplished by calling an event processing method, and passing this instance as a parameter.- Parameters:
listener
-FacesListener
to send thisFacesEvent
to- Throws:
AbortProcessingException
- Signal the Jakarta Server Faces implementation that no further processing on the current event should be performed
-