ValidatorELTag. The remainder of the functionality, namely, the
binding facility and the implementation of the createValidator() method, is now an implementation detail.public class ValidatorTag extends TagSupport
ValidatorTag is a base class for all Jakarta Server Pages custom actions
that create and register a Validator instance on the
EditableValueHolder associated with our most immediate surrounding instance
of a tag whose implementation class is a subclass of UIComponentTag.
To avoid creating duplicate instances when a page is redisplayed,
creation and registration of a Validator occurs
only if the corresponding UIComponent was
created (by the owning UIComponentTag) during the execution of the
current page.
This class may be used directly to implement a generic validator
registration tag (based on the validator-id specified by the
id attribute), or as a base class for tag instances that
support specific Validator subclasses. This id
attribute must refer to one of the well known validator-ids, or a
custom validator-id as defined in a faces-config.xml
file.
Subclasses of this class must implement the
createValidator() method, which creates and returns a
Validator instance. Any configuration properties that specify
the limits to be enforced by this Validator must have been
set by the createValidator() method. Generally, this occurs
by copying corresponding attribute values on the tag instance.
This tag creates no output to the page currently being created. It
is used solely for the side effect of Validator creation.
id, pageContextEVAL_BODY_AGAINEVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE| Constructor and Description |
|---|
ValidatorTag()
Deprecated.
|
| Modifier and Type | Method and Description |
|---|---|
protected Validator |
createValidator()
Deprecated.
Create and return a new
Validator to be registered
on our surrounding UIComponent. |
int |
doStartTag()
Deprecated.
Create a new instance of the specified
Validator
class, and register it with the UIComponent instance associated
with our most immediately surrounding UIComponentTag instance, if
the UIComponent instance was created by this execution of the
containing Jakarta Server Pages page. |
void |
release()
Deprecated.
Release references to any acquired resources.
|
void |
setBinding(java.lang.String binding)
Deprecated.
Set the expression that will be used to create a
ValueExpression
that references a backing bean property of the Validator instance to
be created. |
void |
setValidatorId(java.lang.String validatorId)
Deprecated.
Set the identifer of the
Validator instance to be created. |
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValuepublic void setValidatorId(java.lang.String validatorId)
Set the identifer of the Validator instance to be created.
validatorId - The new identifier of the validator instance to be
created.public void setBinding(java.lang.String binding)
throws JspException
Set the expression that will be used to create a ValueExpression
that references a backing bean property of the Validator instance to
be created.
binding - The new expressionJspException - if a Jakarta Server Pages error occurspublic int doStartTag()
throws JspException
Create a new instance of the specified Validator
class, and register it with the UIComponent instance associated
with our most immediately surrounding UIComponentTag instance, if
the UIComponent instance was created by this execution of the
containing Jakarta Server Pages page.
doStartTag in interface TagdoStartTag in class TagSupportJspException - if a Jakarta Server Pages error occursTag.doStartTag()public void release()
Release references to any acquired resources.
release in interface Tagrelease in class TagSupportTag.release()protected Validator createValidator() throws JspException
Create and return a new Validator to be registered
on our surrounding UIComponent.
ValidatorJspException - if a new instance cannot be created