public class MethodExpressionActionListener extends java.lang.Object implements ActionListener, StateHolder
MethodExpressionActionListener
is an ActionListener that wraps a MethodExpression. When it receives a ActionEvent, it
executes a method on an object identified by the MethodExpression.
TO_FLOW_DOCUMENT_ID_ATTR_NAME| Constructor and Description |
|---|
MethodExpressionActionListener() |
MethodExpressionActionListener(MethodExpression methodExpressionOneArg)
Construct a
ValueChangeListener that
contains a MethodExpression. |
MethodExpressionActionListener(MethodExpression methodExpressionOneArg,
MethodExpression methodExpressionZeroArg) |
| Modifier and Type | Method and Description |
|---|---|
boolean |
isTransient()
If true, the Object implementing this interface must not
participate in state saving or restoring.
|
void |
processAction(ActionEvent actionEvent)
Call through to the
MethodExpression passed in our constructor. |
void |
restoreState(FacesContext context,
java.lang.Object state)
Both |
java.lang.Object |
saveState(FacesContext context)
Both |
void |
setTransient(boolean newTransientValue)
Denotes
whether or not the Object implementing this interface must or
must not participate in state saving or restoring.
|
public MethodExpressionActionListener()
public MethodExpressionActionListener(MethodExpression methodExpressionOneArg)
Construct a ValueChangeListener that
contains a MethodExpression. To accomodate method expression targets
that take no arguments instead of taking an ActionEvent
argument, the implementation of this class must take the
argument methodExpressionOneArg, extract its
expression string, and create another
MethodExpression whose expected param types match
those of a zero argument method. The usage requirements for both
of these MethodExpression instances are described in
processAction(javax.faces.event.ActionEvent).
methodExpressionOneArg - a MethodExpression
that points to a method that returns void and takes
a single argument of type ActionEvent.public MethodExpressionActionListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)
public void processAction(ActionEvent actionEvent) throws AbortProcessingException
Call through to the MethodExpression passed in our constructor. First, try to invoke the
MethodExpression passed to the constructor of this
instance, passing the argument ActionEvent as the
argument. If a MethodNotFoundException is thrown, call
to the zero argument MethodExpression derived from
the MethodExpression passed to the constructor of
this instance. If that
fails for any reason, throw an AbortProcessingException,
including the cause of the failure.
processAction in interface ActionListeneractionEvent - The ActionEvent that has occurredjava.lang.NullPointerExceptionAbortProcessingException - Signal the Jakarta Server Faces
implementation that no further processing on the current event
should be performedpublic java.lang.Object saveState(FacesContext context)
Both MethodExpression
instances described in the constructor must be saved.
saveState in interface StateHoldercontext - the Faces context.public void restoreState(FacesContext context, java.lang.Object state)
Both MethodExpression
instances described in the constructor must be restored.
restoreState in interface StateHoldercontext - the Faces context.state - the state.public boolean isTransient()
StateHolderIf true, the Object implementing this interface must not participate in state saving or restoring.
isTransient in interface StateHoldertrue if transient, false otherwise.public void setTransient(boolean newTransientValue)
StateHolderDenotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
setTransient in interface StateHoldernewTransientValue - boolean pass true if this
Object will not
participate in state saving or restoring, otherwise pass
false.