|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.servlet.jsp.tagext.TagSupport | +--javax.faces.webapp.ValidatorTag
ValidatorTag is a base class for all JSP 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.
Field Summary |
Fields inherited from class javax.servlet.jsp.tagext.TagSupport |
id, pageContext |
Fields inherited from interface javax.servlet.jsp.tagext.IterationTag |
EVAL_BODY_AGAIN |
Fields inherited from interface javax.servlet.jsp.tagext.Tag |
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE |
Constructor Summary | |
ValidatorTag()
|
Method Summary | |
protected javax.faces.validator.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 UIComponentTag instance, if
the UIComponent instance was created by this execution of the
containing JSP page. |
void |
release()
Release references to any acquired resources. |
void |
setValidatorId(java.lang.String validatorId)
Set the identifer of the Validator instance to be created. |
Methods inherited from class javax.servlet.jsp.tagext.TagSupport |
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public ValidatorTag()
Method Detail |
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 int doStartTag() throws javax.servlet.jsp.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 JSP page.
doStartTag
in interface javax.servlet.jsp.tagext.Tag
doStartTag
in class javax.servlet.jsp.tagext.TagSupport
javax.servlet.jsp.JspException
- if a JSP error occurspublic void release()
Release references to any acquired resources.
release
in interface javax.servlet.jsp.tagext.Tag
release
in class javax.servlet.jsp.tagext.TagSupport
protected javax.faces.validator.Validator createValidator() throws javax.servlet.jsp.JspException
Create and return a new Validator
to be registered
on our surrounding UIComponent
.
javax.servlet.jsp.JspException
- if a new instance cannot be created
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |