- java.lang.Object
-
- javax.faces.event.MethodExpressionActionListener
-
- All Implemented Interfaces:
- EventListener, StateHolder, ActionListener, FacesListener
public class MethodExpressionActionListener extends Object implements ActionListener, StateHolder
MethodExpressionActionListener is an
ActionListenerthat wraps aMethodExpression. When it receives aActionEvent, it executes a method on an object identified by theMethodExpression.
-
-
Field Summary
-
Fields inherited from interface javax.faces.event.ActionListener
TO_FLOW_DOCUMENT_ID_ATTR_NAME
-
-
Constructor Summary
Constructors Constructor and Description MethodExpressionActionListener()MethodExpressionActionListener(MethodExpression methodExpressionOneArg)Construct aValueChangeListenerthat contains aMethodExpression.MethodExpressionActionListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)
-
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.voidprocessAction(ActionEvent actionEvent)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
-
MethodExpressionActionListener
public MethodExpressionActionListener()
-
MethodExpressionActionListener
public MethodExpressionActionListener(MethodExpression methodExpressionOneArg)
Construct a
ValueChangeListenerthat contains aMethodExpression. To accomodate method expression targets that take no arguments instead of taking anActionEventargument, 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 inprocessAction(javax.faces.event.ActionEvent).- Parameters:
methodExpressionOneArg- aMethodExpressionthat points to a method that returnsvoidand takes a single argument of typeActionEvent.
-
MethodExpressionActionListener
public MethodExpressionActionListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)
-
-
Method Detail
-
processAction
public void processAction(ActionEvent actionEvent) throws AbortProcessingException
Call through to the
MethodExpressionpassed in our constructor. First, try to invoke theMethodExpressionpassed to the constructor of this instance, passing the argumentActionEventas 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:
processActionin interfaceActionListener- Parameters:
actionEvent- TheActionEventthat has occurred- Throws:
NullPointerExceptionAbortProcessingException- 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/MethodExpressionActionListener.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.