All Implemented Interfaces:
All Known Implementing Classes:
Simple Tag Handlers differ from Classic Tag Handlers in that instead
SimpleTag interface provides a simple
doTag() method, which is called once and only once for any
given tag invocation. All tag logic, iteration, body evaluations, etc.
are to be performed in this single method. Thus, simple tag handlers
have the equivalent power of
BodyTag, but with a much
simpler lifecycle and interface.
To support body content, the
method is provided. The container invokes the
method with a
JspFragment object encapsulating the body of
the tag. The tag handler implementation can call
invoke() on that fragment to evaluate the body as
many times as it needs.
A SimpleTag handler must have a public no-args constructor. Most SimpleTag handlers should extend SimpleTagSupport.
The following is a non-normative, brief overview of the SimpleTag lifecycle. Refer to the JSP Specification for details.
setParent()methods are called by the container. The
setParent()method is only called if the element is nested within another tag invocation.
setJspBody()method is called by the container to set the body of this tag, as a
JspFragment. If the action element is empty in the page, this method is not called at all.
doTag()method is called by the container. All tag logic, iteration, body evaluations, etc. occur in this method.
doTag()method returns and all variables are synchronized.
|Method from javax.servlet.jsp.tagext.SimpleTag Summary:|
|doTag, getParent, setJspBody, setJspContext, setParent|
|Method from javax.servlet.jsp.tagext.SimpleTag Detail:|
public void doTag() throws JspException, IOException
The JSP container will resynchronize any AT_BEGIN and AT_END variables (defined by the associated tag file, TagExtraInfo, or TLD) after the invocation of doTag().
public JspTag getParent()
public void setJspBody(JspFragment jspBody)
This method is invoked by the JSP page implementation
object prior to
public void setJspContext(JspContext pc)
public void setParent(JspTag parent)
The container invokes this method only if this tag invocation is nested within another tag invocation.