java.lang.Object javax.servlet.jsp.tagext.TagSupport javax.faces.webapp.ConverterTag
All Implemented Interfaces:
This- has been partially replaced by ConverterELTag . The remainder of the functionality, namely, the binding facility and the implementation of the #createConverter method, is now an implementation detail.
ConverterTag is a base class for all JSP custom actions
that create and register a
Converter instance on the
ValueHolder 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 Converter
occurs only if the corresponding UIComponent was
created (by the owning UIComponentTag ) during the execution of the
This class may be used directly to implement a generic converter
registration tag (based on the converter-id specified by the
converterId attribute), or as a base class for tag
instances that support specific Converter subclasses. This
converterId attribute must refer to one of the well
known converter-ids, or a custom converter-id as defined in a
Subclasses of this class must implement the
createConverter() method, which creates and returns a
Converter instance. Any configuration properties that specify
behavior of this Converter must have been set by the
createConverter() 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 Converter creation.
|Fields inherited from javax.servlet.jsp.tagext.TagSupport:|
|id, pageContext, class$javax$servlet$jsp$tagext$Tag|
|Method from javax.faces.webapp.ConverterTag Summary:|
|createConverter, doStartTag, release, setBinding, setConverterId|
|Methods from javax.servlet.jsp.tagext.TagSupport:|
|class$, doAfterBody, doEndTag, doStartTag, findAncestorWithClass, getId, getParent, getValue, getValues, release, removeValue, setId, setPageContext, setParent, setValue|
|Methods from java.lang.Object:|
|clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait|
|Method from javax.faces.webapp.ConverterTag Detail:|
protected Converter createConverter() throws JspExceptionDeprecated!
Create and return a new Converter to be registered on our surrounding UIComponent .
public int doStartTag() throws JspExceptionDeprecated!
Create a new instance of the specified Converter 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. If the localValue of the UIComponent is a String, attempt to convert it.
public void release()Deprecated!
Release references to any acquired resources.
public void setBinding(String binding) throws JspExceptionDeprecated!
Set the expression that will be used to create a ValueExpression that references a backing bean property of the Converter instance to be created.
public void setConverterId(String converterId)Deprecated!
Set the identifer of the Converter instance to be created.