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: |
|
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 viagetRequestDispatcher( )
, theServletRequest
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
orServletResponseWrapper
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.