public abstract class ValidatorELTag extends TagSupport
ValidatorELTag 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 UIComponentTagBase
) during the execution of the
current page.
This class must be used as a base class for tag instances that
support specific Validator
subclasses.
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 |
---|
ValidatorELTag() |
Modifier and Type | Method and Description |
---|---|
protected abstract Validator |
createValidator()
Create and return a new
Validator to be registered
on our surrounding UIComponent . |
int |
doStartTag()
Create a new instance of the specified
Validator
class, and register it with the UIComponent instance associated
with our most immediately surrounding UIComponentTagBase instance, if
the UIComponent instance was created by this execution of the
containing Jakarta Server Pages page. |
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, release, removeValue, setId, setPageContext, setParent, setValue
public 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 UIComponentTagBase
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()
protected abstract 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