<html>
<head>
<title>&lt;jsp:forward&gt;</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">&lt;jsp:forward&gt;</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="description">


<p>The <span class="LITERAL">&lt;jsp:forward&gt;</span> action passes the
request-processing control to another JSP page or servlet in the same
web application. The execution of the current page is terminated,
giving the target resource full control over the request.
</p>

<p>When the <span class="LITERAL">&lt;jsp:forward&gt;</span> action is executed,
the buffer is cleared of any response content. If the response has
already been committed (i.e., partly sent to the browser), the
forwarding fails with an <span class="LITERAL">IllegalStateException</span>.
</p>

<p>The action adjusts the URI path information available through the
implicit <span class="LITERAL">request</span> object to reflect the URI path
information for the target resource. All other request information is
left untouched, so the target resource has access to all the original
parameters and headers passed with the request. Additional parameters
can be passed to the target resource through
<span class="LITERAL">&lt;jsp:param&gt;</span> elements in the
<span class="LITERAL">&lt;jsp:forward&gt;</span> element's body.
</p>
<p>Example:</p>

<span class="PROGRAMLISTING"><pre>&lt;jsp:forward page="list.jsp" /&gt;</pre></span>

</td></tr>
</table>
</div>

<div id="page">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">page</td>
<td valign="top" class="COMPATIBILITY"><span class="LITERAL">String</span></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">Request-time value accepted: yes</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Mandatory. A page- or context-relative URI path to which the resource will forward users.
</p></td>
</tr>
</table>
</div>
</body>
</html>