<html>
<head>
<title>Tag Interface</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div id="Description">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">Tag Interface</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Interface name:</td>
</tr>
<tr>
<td colspan="2" class="description">

<p><span class="LITERAL">javax.servlet.jsp.tagext.Tag</span></p>

</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Extends:</td>
</tr>
<tr>
<td colspan="2" class="description">

<p>None</p>

</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Implemented by:</td>
</tr>
<tr>
<td colspan="2" class="description">

<p>Custom action tag handler classes and
<span class="LITERAL">javax.servlet.jsp.tagext.TagSupport</span>
</p>

</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">

<p>The <span class="LITERAL">Tag</span> interface should be implemented by tag
handler classes that do not need access to the body contents of the
corresponding custom action element and do not need to iterate over
the body of a custom action element.
</p>

</td>
</tr>
</table>
</div>
<div id="doEndTag">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">doEndTag()</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"> </td>
</tr>
<tr>
<td valign="top" colspan="2" class="usage"><span class="LITERAL">public int doEndTag() throws JspException</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Performs actions when the end tag is encountered. If this method returns <span class="LITERAL">SKIP_PAGE</span>, execution of the rest of the page is aborted and the <span class="LITERAL">_jspService()</span> method of JSP page implementation class returns. If <span class="LITERAL">EVAL_PAGE</span> is returned, the code following the custom action in the <span class="LITERAL">_jspService()</span> method is executed.
</p></td>
</tr>
</table>
</div>
<div id="doStartTag">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">doStartTag()</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"> </td>
</tr>
<tr>
<td valign="top" colspan="2" class="usage"><span class="LITERAL">public int doStartTag() throws JspException</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Performs actions when the start tag is encountered. This method is called by the web container after all property setter methods have been called. The return value controls how the action's body, if any, is handled. If it returns <span class="LITERAL">EVAL_BODY_INCLUDE</span>, the web container evaluates the body and processes possible JSP elements. The result of the evaluation is added to the response. If <span class="LITERAL">SKIP_BODY</span> is returned, the body is ignored.
</p>
<p>
A tag handler class that implements the <span class="LITERAL">BodyTag</span> interface (extending the <span class="LITERAL">Tag</span> interface) can return <span class="LITERAL">EVAL_BODY_TAG</span> instead of <span class="LITERAL">EVAL_BODY_INCLUDE</span>. The web container then creates a <span class="LITERAL">BodyContent</span> instance and makes it available to the tag handler for special processing.
</p></td>
</tr>
</table>
</div>
<div id="getParent">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">getParent()</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"> </td>
</tr>
<tr>
<td valign="top" colspan="2" class="usage"><span class="LITERAL">public Tag getParent()</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns the tag handler's parent (the <span class="LITERAL">Tag</span> instance for the enclosing action element, if any) or <span class="LITERAL">null</span> if the tag handler doesn't have a parent.
</p></td>
</tr>
</table>
</div>
<div id="release">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">release()</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"> </td>
</tr>
<tr>
<td valign="top" colspan="2" class="usage"><span class="LITERAL">public void release()</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Removes the references to all objects held by this instance.
</p></td>
</tr>
</table>
</div>
<div id="setPageContext">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">setPageContext()</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"> </td>
</tr>
<tr>
<td valign="top" colspan="2" class="usage"><span class="LITERAL">public void setPageContext(PageContext pc)</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Saves a reference to the current <span class="LITERAL">PageContext</span>.
</p></td>
</tr>
</table>
</div>
<div id="setParent">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">setParent()</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"> </td>
</tr>
<tr>
<td valign="top" colspan="2" class="usage"><span class="LITERAL">public void setParent(Tag t)</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Saves a reference to the tag handler's parent (the <span class="LITERAL">Tag</span> instance for the enclosing action element).
</p></td>
</tr>
</table>
</div>
</body>
</html>