public class MethodExpressionValueChangeListener extends java.lang.Object implements ValueChangeListener, StateHolder
MethodExpressionValueChangeListener is a ValueChangeListener
that wraps
a MethodExpression
. When it receives a ValueChangeEvent
, it executes a method on an object identified
by the MethodExpression
.
Constructor and Description |
---|
MethodExpressionValueChangeListener() |
MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg)
Construct a
ValueChangeListener that contains a
MethodExpression .To accommodate method expression targets that take no
arguments instead of taking a ValueChangeEvent 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. |
MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg,
MethodExpression methodExpressionZeroArg)
Construct a
ValueChangeListener that contains a MethodExpression . |
Modifier and Type | Method and Description |
---|---|
boolean |
isTransient()
If true, the Object implementing this interface must not participate in state saving or restoring.
|
void |
processValueChange(ValueChangeEvent valueChangeEvent)
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 MethodExpressionValueChangeListener()
public MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg)
Construct a ValueChangeListener
that contains a
MethodExpression
.To accommodate method expression targets that take no
arguments instead of taking a ValueChangeEvent
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 processValueChange(jakarta.faces.event.ValueChangeEvent)
.
methodExpressionOneArg
- a MethodExpression
that points to a method that returns void
and takes a single argument of type ValueChangeEvent
.public MethodExpressionValueChangeListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)
Construct a ValueChangeListener
that contains a MethodExpression
.
methodExpressionOneArg
- a method expression that takes one argumentmethodExpressionZeroArg
- a method expression that takes zero argumentspublic void processValueChange(ValueChangeEvent valueChangeEvent) 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 ValueChangeEvent
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.
processValueChange
in interface ValueChangeListener
valueChangeEvent
- The ValueChangeEvent
that has occurredjava.lang.NullPointerException
- if the argument valueChangeEvent is null.AbortProcessingException
- 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 StateHolder
context
- 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 StateHolder
context
- the Faces context.state
- the state.public boolean isTransient()
StateHolder
If true, the Object implementing this interface must not participate in state saving or restoring.
isTransient
in interface StateHolder
true
if transient, false
otherwise.public void setTransient(boolean newTransientValue)
StateHolder
Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
setTransient
in interface StateHolder
newTransientValue
- boolean pass true
if this Object will
not participate in state saving or restoring, otherwise pass false
.