All Implemented Interfaces:

Serializable

public class ValueChangeEvent
extends FacesEvent 

See Also:

Serialized Form

• Field Summary

  • Fields inherited from class java.util.EventObject

    source

• Constructor Summary

  Constructors

  Constructor and Description
  ValueChangeEvent (UIComponent component, Object oldValue, Object newValue) Construct a new event object from the specified source component, old value, and new value.

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  Object	getNewValue () Return the current local value of the source UIComponent.
  Object	getOldValue () Return the previous local value of the source UIComponent.
  boolean	isAppropriateListener (FacesListener listener) Return true if this FacesListener is an instance of a listener class that this event supports.
  void	processListener (FacesListener listener) Broadcast this FacesEvent to the specified FacesListener, by whatever mechanism is appropriate.

  • Methods inherited from class javax.faces.event.FacesEvent

    getComponent, getPhaseId, queue, setPhaseId

  • 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

  • ValueChangeEvent

    public ValueChangeEvent(UIComponent component,
     Object oldValue,
     Object newValue)

    Construct a new event object from the specified source component, old value, and new value.

    The default PhaseId for this event is PhaseId.ANY_PHASE.

    Parameters:

    component - Source UIComponent for this event

    oldValue - The previous local value of this UIComponent

    newValue - The new local value of thie UIComponent

    Throws:

    IllegalArgumentException - if component is null

• Method Detail

  • getOldValue

    public Object getOldValue()

    Return the previous local value of the source UIComponent.

  • getNewValue

    public Object getNewValue()

    Return the current local value of the source UIComponent.

  • isAppropriateListener

    public boolean isAppropriateListener(FacesListener listener)

    Description copied from class: FacesEvent

    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.

    Specified by:

    isAppropriateListener in class FacesEvent

    Parameters:

    listener - FacesListener to evaluate

  • processListener

    public void processListener(FacesListener listener)

    Description copied from class: FacesEvent

    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.

    Specified by:

    processListener in class FacesEvent

    Parameters:

    listener - FacesListener to send this FacesEvent to

    Throws:

    AbortProcessingException - Signal the JavaServer Faces implementation that no further processing on the current event should be performed