Class ConverterELTag
- All Implemented Interfaces:
Serializable
,IterationTag
,JspTag
,Tag
ConverterELTag 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 UIComponentClassicTagBase
. 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 as a base class for tag instances that
support specific Converter
subclasses.
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 abstract Converter
Create and return a newConverter
to be registered on our surroundingUIComponent
.int
Create a new instance of the specifiedConverter
class, and register it with theUIComponent
instance associated with our most immediately surroundingUIComponentClassicTagBase
instance, if theUIComponent
instance was created by this execution of the containing JSP page.Methods inherited from class javax.servlet.jsp.tagext.TagSupport
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, release, removeValue, setId, setPageContext, setParent, setValue
-
Constructor Details
-
ConverterELTag
public ConverterELTag()
-
-
Method Details
-
doStartTag
Create a new instance of the specified
Converter
class, and register it with theUIComponent
instance associated with our most immediately surroundingUIComponentClassicTagBase
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:
-
createConverter
Create and return a new
Converter
to be registered on our surroundingUIComponent
.- Throws:
JspException
- if a new instance cannot be created
-