- java.lang.Object
-
- javax.faces.event.MethodExpressionValueChangeListener
-
- All Implemented Interfaces:
- EventListener, StateHolder, FacesListener, ValueChangeListener
public class MethodExpressionValueChangeListener extends Object implements ValueChangeListener, StateHolder
MethodExpressionValueChangeListener is a
ValueChangeListenerthat wraps aMethodExpression. When it receives aValueChangeEvent, it executes a method on an object identified by theMethodExpression.
-
-
Constructor Summary
Constructors Constructor and Description MethodExpressionValueChangeListener()MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg)Construct aValueChangeListenerthat contains aMethodExpression.To accomodate method expression targets that take no arguments instead of taking aValueChangeEventargument, the implementation of this class must take the argumentmethodExpressionOneArg, extract its expression string, and create anotherMethodExpressionwhose expected param types match those of a zero argument method.MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)Construct aValueChangeListenerthat contains aMethodExpression.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description booleanisTransient()If true, the Object implementing this interface must not participate in state saving or restoring.voidprocessValueChange(ValueChangeEvent valueChangeEvent)Call through to theMethodExpressionpassed in our constructor.voidrestoreState(FacesContext context, Object state)Both
MethodExpressioninstances described in the constructor must be restored.ObjectsaveState(FacesContext context)Both
MethodExpressioninstances described in the constructor must be saved.voidsetTransient(boolean newTransientValue)Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
-
-
-
Constructor Detail
-
MethodExpressionValueChangeListener
public MethodExpressionValueChangeListener()
-
MethodExpressionValueChangeListener
public MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg)
Construct a
ValueChangeListenerthat contains aMethodExpression.To accomodate method expression targets that take no arguments instead of taking aValueChangeEventargument, the implementation of this class must take the argumentmethodExpressionOneArg, extract its expression string, and create anotherMethodExpressionwhose expected param types match those of a zero argument method. The usage requirements for both of theseMethodExpressioninstances are described inprocessValueChange(javax.faces.event.ValueChangeEvent).- Parameters:
methodExpressionOneArg- aMethodExpressionthat points to a method that returnsvoidand takes a single argument of typeValueChangeEvent.
-
MethodExpressionValueChangeListener
public MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)
Construct a
ValueChangeListenerthat contains aMethodExpression.
-
-
Method Detail
-
processValueChange
public void processValueChange(ValueChangeEvent valueChangeEvent) throws AbortProcessingException
Call through to the
MethodExpressionpassed in our constructor. First, try to invoke theMethodExpressionpassed to the constructor of this instance, passing the argumentValueChangeEventas the argument. If aMethodNotFoundExceptionis thrown, call to the zero argumentMethodExpressionderived from theMethodExpressionpassed to the constructor of this instance.If that fails for any reason, throw anAbortProcessingException, including the cause of the failure.- Specified by:
processValueChangein interfaceValueChangeListener- Parameters:
valueChangeEvent- TheValueChangeEventthat has occurred- Throws:
NullPointerException- if the argument valueChangeEvent is null.AbortProcessingException- Signal the JavaServer Faces implementation that no further processing on the current event should be performed
-
saveState
public Object saveState(FacesContext context)
Both
MethodExpressioninstances described in the constructor must be saved.- Specified by:
saveStatein interfaceStateHolder
-
restoreState
public void restoreState(FacesContext context, Object state)
Both
MethodExpressioninstances described in the constructor must be restored.- Specified by:
restoreStatein interfaceStateHolder
-
isTransient
public boolean isTransient()
Description copied from interface:StateHolderIf true, the Object implementing this interface must not participate in state saving or restoring.
- Specified by:
isTransientin interfaceStateHolder
-
setTransient
public void setTransient(boolean newTransientValue)
Description copied from interface:StateHolderDenotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
- Specified by:
setTransientin interfaceStateHolder- Parameters:
newTransientValue- boolean passtrueif this Object will not participate in state saving or restoring, otherwise passfalse.
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/faces/event/MethodExpressionValueChangeListener.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.