Download PDF Home History |  | API Search Feedback FAQ

> ## Transferring Control to Another Web Component

> The mechanism for transferring control to another Web component from a JSP page uses the functionality provided by the Java Servlet API as described in Transferring Control to Another Web Component. You access this functionality from a JSP page by using the `jsp:forward` element:

>     <jsp:forward page="/main.jsp" />

> Note that if any data has already been returned to a client, the `jsp:forward` element will fail with an `IllegalStateException`.

> ### jsp:param Element

> When an `include` or `forward` element is invoked, the original request object is provided to the target page. If you wish to provide additional data to that page, you can append parameters to the request object by using the `jsp:param` element:

>     <jsp:include page="..." >
>       <jsp:param name="param1" value="value1"/>
>     </jsp:include>

> When `jsp:include` or `jsp:forward` is executed, the included page or forwarded page will see the original request object, with the original parameters augmented with the new parameters and new values taking precedence over existing values when applicable. For example, if the request has a parameter `A=foo` and a parameter `A=bar` is specified for forward, the forwarded request will have `A=bar,foo`. Note that the new parameter has precedence.

> The scope of the new parameters is the `jsp:include` or `jsp:forward` call; that is, in the case of an `jsp:include` the new parameters (and values) will not apply after the include.

Download PDF Home History |  | API Search Feedback FAQ

All of the material in The J2EE(TM) 1.4 Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.