ValidatorELTag
. The remainder of the functionality, namely,
the binding facility and the implementation of the createValidator()
method, is now an implementation detail.@Deprecated 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, pageContext
EVAL_BODY_AGAIN
EVAL_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, setValue
public 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 Tag
doStartTag
in class TagSupport
JspException
- if a Jakarta Server Pages error occursTag.doStartTag()
public void release()
Release references to any acquired resources.
release
in interface Tag
release
in class TagSupport
Tag.release()
protected Validator createValidator() throws JspException
Create and return a new Validator
to be registered on our surrounding UIComponent
.
Validator
JspException
- if a new instance cannot be created