Class ConverterTag
- All Implemented Interfaces:
Serializable
,IterationTag
,JspTag
,Tag
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
current page.
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
faces-config.xml
file.
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.
- See Also:
-
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
-
Method Summary
Modifier and TypeMethodDescriptionprotected Converter
Deprecated.Create and return a newConverter
to be registered on our surroundingUIComponent
.int
Deprecated.Create a new instance of the specifiedConverter
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
(String binding) Deprecated.Set the expression that will be used to create aValueExpression
that references a backing bean property of theConverter
instance to be created.void
setConverterId
(String converterId) Deprecated.Set the identifer of theConverter
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
-
Constructor Details
-
ConverterTag
public ConverterTag()Deprecated.
-
-
Method Details
-
setConverterId
Deprecated.Set the identifer of the
Converter
instance to be created.- Parameters:
converterId
- The identifier of the converter instance to be created.
-
setBinding
Deprecated.Set the expression that will be used to create a
ValueExpression
that references a backing bean property of theConverter
instance to be created.- Parameters:
binding
- The new expression- Throws:
JspException
- if a JSP error occurs
-
doStartTag
Deprecated.Create a new instance of the specified
Converter
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. If the localValue of theUIComponent
is a String, attempt to convert it.- Specified by:
doStartTag
in interfaceTag
- Overrides:
doStartTag
in classTagSupport
- Returns:
- SKIP_BODY
- Throws:
JspException
- if a JSP error occurs- See Also:
-
release
public void release()Deprecated.Release references to any acquired resources.
- Specified by:
release
in interfaceTag
- Overrides:
release
in classTagSupport
- See Also:
-
createConverter
Deprecated.Create and return a new
Converter
to be registered on our surroundingUIComponent
.- Throws:
JspException
- if a new instance cannot be created
-
ConverterELTag
. The remainder of the functionality, namely, the binding facility and the implementation of thecreateConverter()
method, is now an implementation detail.