Name

RequestDispatcher

Synopsis

The RequestDispatcher class defines an object that receives requests from the client and sends them to any resource (such as a servlet, HTML file, or JSP file) in the same web container. The container creates the RequestDispatcher object, which is used as a wrapper around a resource located at a particular URI path or identified by a particular name.

Synopsis

Interface name:

javax.servlet.RequestDispatcher

Extends:

None

Implemented by:

Internal container-dependent class.

Methods

public void forward(ServletRequest req, ServletResponse res)

Forwards a request from a servlet to another resource (servlet, JSP file, or HTML file) on the server. For a RequestDispatcher obtained via getRequestDispatcher( ), the ServletRequest object has its path elements and parameters adjusted to match the path of the target resource.

This method must be called before the response has been committed to the client (before response body output has been flushed). If the response has already been committed, this method throws an IllegalStateException. Uncommitted output in the response buffer is automatically cleared before the forward.

The request and response parameters must be the same objects as were passed to the calling servlet’s service method or be subclasses of the ServletRequestWrapper or ServletResponseWrapper classes that wrap them.

public void include(ServletRequest req, ServletResponse res)

Includes the response generated by a resource (servlet, JSP page, ...

Get JavaServer Pages, Second Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.