Class SystemEvent

java.lang.Object
java.util.EventObject
jakarta.faces.event.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
  • Constructor Details

    • SystemEvent

      public SystemEvent​(Object source)

      Pass the argument source to the superclass constructor.

      Parameters:
      source - the source reference to be passed to the superclass constructor.
      Throws:
      IllegalArgumentException - if the argument is null.
    • SystemEvent

      public SystemEvent​(FacesContext facesContext, Object source)

      Pass the argument source to the superclass constructor.

      Parameters:
      facesContext - the Faces context.
      source - the source reference to be passed to the superclass constructor.
      Throws:
      IllegalArgumentException - if the argument is null.
  • Method Details

    • getFacesContext

      public FacesContext 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

      public boolean isAppropriateListener​(FacesListener listener)

      Return true if this FacesListener is an instance of a the appropriate listener class that this event supports. The default implementation returns true if the listener is a ComponentSystemEventListener.

      Parameters:
      listener - FacesListener to evaluate
      Returns:
      the result as specified above
    • processListener

      public void processListener​(FacesListener listener)

      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 this FacesEvent to
      Throws:
      AbortProcessingException - Signal the Jakarta Server Faces implementation that no further processing on the current event should be performed