public class MethodExpressionValidator extends java.lang.Object implements Validator, StateHolder
MethodExpressionValidator
is a Validator
that wraps a MethodExpression
, and it
performs validation by executing a method on an object identified by
the MethodExpression
.
NOT_IN_RANGE_MESSAGE_ID
Constructor and Description |
---|
MethodExpressionValidator() |
MethodExpressionValidator(MethodExpression methodExpression)
Construct a
Validator 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 |
restoreState(FacesContext context,
java.lang.Object state)
Perform any
processing required to restore the state from the entries in the
state Object.
|
java.lang.Object |
saveState(FacesContext context)
Gets the state of the instance as a
Serializable Object. |
void |
setTransient(boolean transientValue)
Denotes
whether or not the Object implementing this interface must or
must not participate in state saving or restoring.
|
void |
validate(FacesContext context,
UIComponent component,
java.lang.Object value)
|
public MethodExpressionValidator()
public MethodExpressionValidator(MethodExpression methodExpression)
Construct a Validator
that contains a MethodExpression
.
methodExpression
- the expression to wrappublic void validate(FacesContext context, UIComponent component, java.lang.Object value) throws ValidatorException
Validator
Perform the
correctness checks implemented by this Validator
against
the specified UIComponent
. If any violations are found,
a ValidatorException
will be thrown containing the FacesMessage
describing the failure.
For a validator to be fully compliant with Version 2 and later
of the specification, it must not fail validation on
null
or empty values unless it is specifically
intended to address null
or empty values. An
application-wide <context-param>
is provided
to allow validators designed for Jakarta Server Faces 1.2 to work
with Jakarta Server Faces 2 and later.
The javax.faces.VALIDATE_EMPTY_FIELDS
<context-param>
must be set to
false
to enable this backwards compatibility
behavior.
validate
in interface Validator
context
- FacesContext for the request we are processingcomponent
- UIComponent we are checking for correctnessvalue
- the value to validatejava.lang.NullPointerException
- if context
or component
is null
ValidatorException
- if validation failspublic java.lang.Object saveState(FacesContext context)
StateHolder
Gets the state of the instance as a
Serializable
Object.
If the class that implements this interface has references to
instances that implement StateHolder (such as a
UIComponent
with event handlers, validators, etc.)
this method must call the StateHolder.saveState(javax.faces.context.FacesContext)
method on all those
instances as well. This method must not save the state
of children and facets. That is done via the StateManager
This method must not alter the state of the implementing object. In other words, after executing this code:
Object state = component.saveState(facesContext);
component
should be the same as before executing
it.
The return from this method must be Serializable
saveState
in interface StateHolder
context
- the Faces context.public void restoreState(FacesContext context, java.lang.Object state)
StateHolder
Perform any processing required to restore the state from the entries in the state Object.
If the class that implements this interface has references to
instances that also implement StateHolder (such as a
UIComponent
with event handlers, validators, etc.)
this method must call the StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object)
method on all those
instances as well.
If the state
argument is null
, take no action and return.
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 transientValue)
StateHolder
Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
setTransient
in interface StateHolder
transientValue
- boolean pass true
if this
Object will not
participate in state saving or restoring, otherwise pass
false
.