public class ValueChangeEvent extends FacesEvent
A ValueChangeEvent is a notification
that the local value of the source component has been change as a result of
user interface activity. It is not fired unless validation of the new value
was completed successfully.
| Constructor and Description |
|---|
ValueChangeEvent(FacesContext facesContext,
UIComponent component,
java.lang.Object oldValue,
java.lang.Object newValue)
Construct a new event object from the Faces context, specified source component, old value and new value. |
ValueChangeEvent(UIComponent component,
java.lang.Object oldValue,
java.lang.Object newValue)
Construct a new event object from the specified source component, old value, and new value. |
| Modifier and Type | Method and Description |
|---|---|
java.lang.Object |
getNewValue()
Return the current local value of the source
UIComponent. |
java.lang.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. |
getComponent, getFacesContext, getPhaseId, queue, setPhaseIdpublic ValueChangeEvent(UIComponent component, java.lang.Object oldValue, java.lang.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.
component - Source UIComponent for this eventoldValue - The previous local value of this UIComponentnewValue - The new local value of thie UIComponentjava.lang.IllegalArgumentException - if component is
nullpublic ValueChangeEvent(FacesContext facesContext, UIComponent component, java.lang.Object oldValue, java.lang.Object newValue)
Construct a new event object from the Faces context, specified source component, old value and new value.
The default PhaseId for this event is PhaseId.ANY_PHASE.
facesContext - the Faces context.component - Source UIComponent for this eventoldValue - The previous local value of this UIComponentnewValue - The new local value of thie UIComponentjava.lang.IllegalArgumentException - if component is
nullpublic java.lang.Object getOldValue()
Return the previous local value of the source UIComponent.
public java.lang.Object getNewValue()
Return the current local value of the source UIComponent.
public boolean isAppropriateListener(FacesListener listener)
FacesEventReturn 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.
isAppropriateListener in class FacesEventlistener - FacesListener to evaluatepublic void processListener(FacesListener listener)
FacesEventBroadcast 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.
processListener in class FacesEventlistener - FacesListener to send this FacesEvent toAbortProcessingException - Signal the Jakarta Server Faces
implementation that no further processing on the current event
should be performed