EE4J Web API 10.0.0 · jakarta.faces.event.MethodExpressionActionListener

Modifier and Type	Field and Description
private static final Class<T>[]	ACTION_LISTENER_ZEROARG_SIG
private boolean	isTransient
private static final Logger	LOGGER
private MethodExpression	methodExpressionOneArg
private MethodExpression	methodExpressionZeroArg

Constructor Summary

Access	Constructor and Description
public	MethodExpressionActionListener()
public	MethodExpressionActionListener(MethodExpression a `MethodExpression` that points to a method that returns `void` and takes a single argument of type `ActionEvent`. methodExpressionOneArg) Construct a `ValueChangeListener` that contains a `MethodExpression`.
public	MethodExpressionActionListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)

Method Summary

Modifier and Type	Method and Description
public boolean	isTransient() Implements jakarta.faces.component.StateHolder.isTransient. If true, the Object implementing this interface must not participate in state saving or restoring.
public void	processAction(ActionEvent The `ActionEvent` that has occurred actionEvent) Implements jakarta.faces.event.ActionListener.processAction. Call through to the `MethodExpression` passed in our constructor.
public void	restoreState(FacesContext the Faces context. context, Object the state. state) Implements jakarta.faces.component.StateHolder.restoreState. Both `MethodExpression` instances described in the constructor must be restored.
public Object	saveState(FacesContext the Faces context. context) Implements jakarta.faces.component.StateHolder.saveState. Both `MethodExpression` instances described in the constructor must be saved.
public void	setTransient(boolean boolean pass `true` if this Object will not participate in state saving or restoring, otherwise pass `false`. newTransientValue) Implements jakarta.faces.component.StateHolder.setTransient. Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ACTION_LISTENER_ZEROARG_SIG	back to summary
private static final Class<T>[] ACTION_LISTENER_ZEROARG_SIG

isTransient	back to summary
private boolean isTransient

LOGGER	back to summary
private static final Logger LOGGER

methodExpressionOneArg	back to summary
private MethodExpression methodExpressionOneArg

methodExpressionZeroArg	back to summary
private MethodExpression methodExpressionZeroArg

Constructor Detail

MethodExpressionActionListener	back to summary
public MethodExpressionActionListener()

MethodExpressionActionListener back to summary

MethodExpressionActionListener	back to summary
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`. Parameters methodExpressionOneArg:MethodExpression a `MethodExpression` that points to a method that returns `void` and takes a single argument of type `ActionEvent`.

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.

Parameters

methodExpressionOneArg:MethodExpression: a MethodExpression that points to a method that returns void and takes a single argument of type ActionEvent.

MethodExpressionActionListener	back to summary
public MethodExpressionActionListener(MethodExpression methodExpressionOneArg, MethodExpression methodExpressionZeroArg)

Method Detail

isTransient back to summary

isTransient	back to summary
public boolean isTransient() Implements jakarta.faces.component.StateHolder.isTransient. Doc from jakarta.faces.component.StateHolder.isTransient. If true, the Object implementing this interface must not participate in state saving or restoring. Returns:boolean `true` if transient, `false` otherwise. Annotations @Override

public boolean isTransient()

Implements jakarta.faces.component.StateHolder.isTransient.

Doc from jakarta.faces.component.StateHolder.isTransient.

If true, the Object implementing this interface must not participate in state saving or restoring.

Returns:boolean

true if transient, false otherwise.

Annotations

@Override

processAction back to summary

processAction	back to summary
public void processAction(ActionEvent actionEvent) throws AbortProcessingException Implements jakarta.faces.event.ActionListener.processAction. 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. Parameters actionEvent:ActionEvent Doc from jakarta.faces.event.ActionListener.processAction. The `ActionEvent` that has occurred Annotations @Override Exceptions AbortProcessingException: Signal the Jakarta Faces implementation that no further processing on the current event should be performed NullPointerException

public void processAction(ActionEvent actionEvent) throws AbortProcessingException

Implements jakarta.faces.event.ActionListener.processAction.

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.

Parameters

actionEvent:ActionEvent

Doc from jakarta.faces.event.ActionListener.processAction.

The ActionEvent that has occurred

Annotations

@Override

Exceptions

AbortProcessingException:: Signal the Jakarta Faces implementation that no further processing on the current event should be performed
NullPointerException

restoreState back to summary

restoreState	back to summary
public void restoreState(FacesContext context, Object state) Implements jakarta.faces.component.StateHolder.restoreState. Both `MethodExpression` instances described in the constructor must be restored. Parameters context:FacesContext Doc from jakarta.faces.component.StateHolder.restoreState. the Faces context. state:Object Doc from jakarta.faces.component.StateHolder.restoreState. the state. Annotations @Override

public void restoreState(FacesContext context, Object state)

Implements jakarta.faces.component.StateHolder.restoreState.

Both MethodExpression instances described in the constructor must be restored.

Parameters

context:FacesContext

Doc from jakarta.faces.component.StateHolder.restoreState.

the Faces context.

state:Object

Doc from jakarta.faces.component.StateHolder.restoreState.

the state.

Annotations

@Override

saveState back to summary

saveState	back to summary
public Object saveState(FacesContext context) Implements jakarta.faces.component.StateHolder.saveState. Both `MethodExpression` instances described in the constructor must be saved. Parameters context:FacesContext Doc from jakarta.faces.component.StateHolder.saveState. the Faces context. Returns:Object Doc from jakarta.faces.component.StateHolder.saveState. the saved state. Annotations @Override

public Object saveState(FacesContext context)

Implements jakarta.faces.component.StateHolder.saveState.

Both MethodExpression instances described in the constructor must be saved.

Parameters

context:FacesContext

Doc from jakarta.faces.component.StateHolder.saveState.

the Faces context.

Returns:Object

Doc from jakarta.faces.component.StateHolder.saveState.

the saved state.

Annotations

@Override

setTransient back to summary

setTransient	back to summary
public void setTransient(boolean newTransientValue) Implements jakarta.faces.component.StateHolder.setTransient. Doc from jakarta.faces.component.StateHolder.setTransient. Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring. Parameters newTransientValue:boolean boolean pass `true` if this Object will not participate in state saving or restoring, otherwise pass `false`. Annotations @Override

public void setTransient(boolean newTransientValue)

Implements jakarta.faces.component.StateHolder.setTransient.

Doc from jakarta.faces.component.StateHolder.setTransient.

Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.

Parameters

newTransientValue:boolean: boolean pass true if this Object will not participate in state saving or restoring, otherwise pass false.

Annotations

@Override

public Class MethodExpressionActionListener

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail