Class ValidatorTag
- java.lang.Object
-
- javax.servlet.jsp.tagext.TagSupport
-
- javax.faces.webapp.ValidatorTag
-
- All Implemented Interfaces:
java.io.Serializable
,javax.servlet.jsp.tagext.IterationTag
,javax.servlet.jsp.tagext.JspTag
,javax.servlet.jsp.tagext.Tag
public class ValidatorTag extends javax.servlet.jsp.tagext.TagSupport
Deprecated.This has been partially replaced byValidatorELTag
. The remainder of the functionality, namely, the binding facility and the implementation of thecreateValidator()
method, is now an implementation detail.ValidatorTag is a base class for all JSP custom actions that create and register a
Validator
instance on theEditableValueHolder
associated with our most immediate surrounding instance of a tag whose implementation class is a subclass ofUIComponentTag
. To avoid creating duplicate instances when a page is redisplayed, creation and registration of aValidator
occurs only if the correspondingUIComponent
was created (by the owningUIComponentTag
) 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 specificValidator
subclasses. Thisid
attribute must refer to one of the well known validator-ids, or a custom validator-id as defined in afaces-config.xml
file.Subclasses of this class must implement the
createValidator()
method, which creates and returns aValidator
instance. Any configuration properties that specify the limits to be enforced by thisValidator
must have been set by thecreateValidator()
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.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description ValidatorTag()
Deprecated.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected Validator
createValidator()
Deprecated.Create and return a newValidator
to be registered on our surroundingUIComponent
.int
doStartTag()
Deprecated.Create a new instance of the specifiedValidator
class, and register it with theUIComponent
instance associated with our most immediately surroundingUIComponentTag
instance, if theUIComponent
instance was created by this execution of the containing JSP 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 aValueExpression
that references a backing bean property of theValidator
instance to be created.void
setValidatorId(java.lang.String validatorId)
Deprecated.Set the identifer of theValidator
instance to be created.
-
-
-
Method Detail
-
setValidatorId
public void setValidatorId(java.lang.String validatorId)
Deprecated.Set the identifer of the
Validator
instance to be created.- Parameters:
validatorId
- The new identifier of the validator instance to be created.
-
setBinding
public void setBinding(java.lang.String binding) throws javax.servlet.jsp.JspException
Deprecated.Set the expression that will be used to create a
ValueExpression
that references a backing bean property of theValidator
instance to be created.- Parameters:
binding
- The new expression- Throws:
javax.servlet.jsp.JspException
- if a JSP error occurs
-
doStartTag
public int doStartTag() throws javax.servlet.jsp.JspException
Deprecated.Create a new instance of the specified
Validator
class, and register it with theUIComponent
instance associated with our most immediately surroundingUIComponentTag
instance, if theUIComponent
instance was created by this execution of the containing JSP page.- Specified by:
doStartTag
in interfacejavax.servlet.jsp.tagext.Tag
- Overrides:
doStartTag
in classjavax.servlet.jsp.tagext.TagSupport
- Throws:
javax.servlet.jsp.JspException
- if a JSP error occurs
-
release
public void release()
Deprecated.Release references to any acquired resources.
- Specified by:
release
in interfacejavax.servlet.jsp.tagext.Tag
- Overrides:
release
in classjavax.servlet.jsp.tagext.TagSupport
-
createValidator
protected Validator createValidator() throws javax.servlet.jsp.JspException
Deprecated.Create and return a new
Validator
to be registered on our surroundingUIComponent
.- Throws:
javax.servlet.jsp.JspException
- if a new instance cannot be created
-
-