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 SystemEvents 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

ComponentSystemEvent(UIComponent component)

Pass the argument component to the superclass constructor.

Method Summary

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