javax.faces.event

## Class ComponentSystemEvent

- java.lang.Object
- - java.util.EventObject
  - - javax.faces.event.SystemEvent
    - - javax.faces.event.ComponentSystemEvent

- All Implemented Interfaces:
    Serializable
  Direct Known Subclasses:
    PostAddToViewEvent, PostConstructViewMapEvent, PostRestoreStateEvent, PostValidateEvent, PreDestroyViewMapEvent, PreRemoveFromViewEvent, PreRenderComponentEvent, PreRenderViewEvent, PreValidateEvent

      public abstract class ComponentSystemEvent
      extends SystemEvent

  ComponentSystemEvent is the base class for `SystemEvent`s that are specific to a `UIComponent` instance.

  Since:
    2.0
  See Also:
    Serialized Form

- - ### Field Summary

    - ### Fields inherited from class java.util.EventObject

      `source`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `ComponentSystemEvent(UIComponent component)` Pass the argument `component` to the superclass constructor.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `UIComponent` | `getComponent()` the source `UIComponent` that sent this event.
    `boolean` | `isAppropriateListener(FacesListener listener)` Return `true` if the argument `FacesListener` is an instance of the appropriate listener class that this event supports.
    `void` | `processListener(FacesListener listener)` Broadcast this event instance to the specified `FacesListener` by calling the superclass's `processListener()` implementation.

    - ### Methods inherited from class java.util.EventObject

      `getSource, toString`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Constructor Detail

    - #### ComponentSystemEvent

          public ComponentSystemEvent(UIComponent component)

      Pass the argument `component` to the superclass constructor.

      Parameters:
        `component` - the `UIComponent` reference to be passed to the superclass constructor.
      Throws:
        ``IllegalArgumentException`` - if the argument is `null`.
      Since:
        2.0

  - ### Method Detail

    - #### isAppropriateListener

          public boolean isAppropriateListener(FacesListener listener)

      Return `true` if the argument `FacesListener` is an instance of the appropriate listener class that this event supports. The default implementation returns true if the listener is a `ComponentSystemEventListener` or if `super.isAppropriateListener()` returns true.

      Overrides:
        `isAppropriateListener` in class `SystemEvent`
      Parameters:
        `listener` - `FacesListener` to evaluate
      Since:
        2.2

    - #### processListener

          public void processListener(FacesListener listener)

      Broadcast this event instance to the specified `FacesListener` by calling the superclass's `processListener()` implementation.

      Overrides:
        `processListener` in class `SystemEvent`
      Parameters:
        `listener` - `FacesListener` to evaluate
      Since:
        2.2

    - #### getComponent

          public UIComponent getComponent()

      the source `UIComponent` that sent this event.

      Since:
        2.0

Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.