Contents | Prev | Next


<jsp:forward>

Forwards a request to a web resource.

JSP Syntax

<jsp:forward page="{relativeURL | '${' Expression'}' | 	
   <%= expression %>}" { /> | > [<jsp:param name="parameterName" 
value="{parameterValue | '${' Expression '}' | <%= expression %>}" } 
/> ]+ </jsp:forward>}

XML Syntax

<jsp:forward page="{relativeURL | '${' Expression '}' | 	
   %= expression % }" { /> | > [<jsp:param  name="parameterName" 	
   value="{parameterValue | '${' Expression '}' | %= expression %}" }	
/> ]+ </jsp:forward> }

Examples

<jsp:forward page="/servlet/login" />
<jsp:forward page="/servlet/login">	
   <jsp:param name="username" value="jsmith" />	
</jsp:forward>

Description

The jsp:forward element forwards the request object containing the client request information from one JSP page to another resource. The target resource can be an HTML file, another JSP page, or a servlet, as long as it is in the same application context as the forwarding JSP page. The lines in the source JSP page after the jsp:forward element are not processed.

You can pass parameter names and values to the target resource by using a jsp:param clause. An example of this would be passing the parameter name username (with name="username") and the value scott (with value="scott") to a servlet as part of the request. If you use jsp:param, the target resource should be a dynamic resource that can handle the parameters.

Be careful when using jsp:forward with unbuffered output. If you have used the page directive with buffer="none" to specify that the output of your JSP page should not be buffered, and if the JSP page has any data in the out object, using jsp:forward will cause an IllegalStateException.

Attributes

See Also



Contents | Prev | Next

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.