RequestDispatcher实现请求转发

￡神魔★判官ぃ 2024-03-29 15:13 13阅读 0赞

当一个 Web 资源收到客户端的请求后，如果希望服务器通知另外一个资源处理请求，那么这时可以通过 RequestDispatcher 接口的实例对象实现。ServletRequest 接口中定义了一个获取 RequestDispatcher 对象的方法，如表 1 所示。

<table> 
 <thead> 
  <tr> 
   <th>方法声明</th> 
   <th>功能描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>RequestDispatcher getRequestDispatcher (String path)</td> 
   <td>返回封装了某条路径所指定资源的 RequestDispatcher 对象。其中，参数 path 必须以“/”开头，用于表示当前 Web 应用的根目录。需要注意的是，WEB-INF 目录中的内容对 RequestDispatcher 对象也是可见的。因此，传递给 getRequestDispatcher(String path) 方法的资源可以是 WEB-INF 目录中的文件</td> 
  </tr> 
 </tbody> 
</table>

获取到 RequestDispatcher 对象后，最重要的工作就是通知其他 Web 资源处理当前的 Servlet 请求，为此，RequestDispatcher 接口定义了两个相关方法，如表 2 所示。

<table> 
 <thead> 
  <tr> 
   <th>方法声明</th> 
   <th>功能描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>forward(ServletRequest request,ServletResponse response)</td> 
   <td>该方法用于将请求从一个 Servlet 传递给另一个 Web 资源。在 Servlet 中，可以对请求做一个初步处理，然后通过调用这个方法，将请求传递给其他资源进行响应。需要注意的是，该方法必须在响应提交给客户端之前被调用，否则将抛出 IllegalStateException 异常</td> 
  </tr> 
  <tr> 
   <td>include(ServletRequest request,ServletResponse response)</td> 
   <td>该方法用于将其他的资源作为当前响应内容包含进来</td> 
  </tr> 
 </tbody> 
</table>

### 请求转发 ###

在 RequestDispatcher 接口中，forward() 方法可以实现请求转发，include() 方法可以实现请求包含，本节将以请求转发为例，讲解 forward() 方法的使用。

在 Servlet 中，如果当前 Web 资源不想处理请求，则可以通过 forward() 方法将当前请求传递给其他的 Web 资源进行处理，这种方式称为请求转发。请求转发的工作原理如图 1 所示。

从图 1 中可以看出，当客户端访问 Servlet1 时，可以通过 forward() 方法将请求转发给其他 Web 资源，其他 Web 资源处理完请求后，直接将响应结果返回到客户端。

了解了 forward() 方法的工作原理后，下面通过案例演示 forward() 方法的使用。在 servletDemo02 项目的 com.mengma.request 包中创建一个名为 RequestForwardServlet 的 Servlet 类，该类使用 forword() 方法将请求转发到一个新的 Servlet 页面，如下所示。

![c33f22258f9a1352570ad9fce9228ed4.png][]

图 1 forward() 方法的工作原理

> 1.  `package com.mengma.servlet;`
> 2.  
> 3.  `import java.io.IOException;`
> 4.  `import javax.servlet.*;`
> 5.  `import javax.servlet.http.*;`
> 6.  
> 7.  `public class RequestForwardServlet extends HttpServlet {`
> 8.  
> 9.  `public void doGet(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {`
> 10. `response.setContentType("text/html;charset=utf-8");`
> 11. `request.setAttribute("username", "张三"); // 将数据存储到request对象中`
> 12. `RequestDispatcher dispatcher = request.getRequestDispatcher("/ResultServlet");`
> 13. `dispatcher.forward(request,response);`
> 14. `}`
> 15. 
> 16. `public void doPost(HttpServletRequest request,HttpServletResponse response)throws ServletException,IOException {`
> 17. `doGet(request,response);`
> 18. `}`
> 19. `}`

在 RequestForwardServlet 中，通过使用 forward() 方法，将当前 Servlet 的请求转发到 ResultServlet 页面，在 com.mengma.request 包中编写一个名为 ResultServlet 的 Servlet 类，该类用于获取 RequestForwardServlet 类中存储在 request 对象中的数据并输出，ResultServlet 类的代码实现如下所示。

> 1.  `package com.mengma.servlet;`
> 2.  
> 3.  `import java.io.IOException;`
> 4.  `import java.io.PrintWriter;`
> 5.  `import javax.servlet.ServletException;`
> 6.  `import javax.servlet.http.HttpServlet;`
> 7.  `import javax.servlet.http.HttpServletRequest;`
> 8.  `import javax.servlet.http.HttpServletResponse;`
> 9.  
> 10. `public class ResultServlet extends HttpServlet {`
> 11. 
> 12. `public void doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {`
> 13. `response.setContentType("text/html;charset=utf-8");`
> 14. `PrintWriter out = response.getWriter();`
> 15. `String username = (String) request.getAttribute("username");`
> 16. `if (username != null) {`
> 17. `out.println("用户名：" + username + "<br/>");`
> 18. `}`
> 19. `}`
> 20. 
> 21. `public void doPost(HttpServletRequest request, HttpServletResponse response)`
> 22. `throws ServletException, IOException {`
> 23. `doGet(request, response);`
> 24. `}`
> 25. `}`

启动 Tomcat 服务器，在浏览器的地址栏中输入地址 http://localhost:8080/servletDemo02/RequestForwardServlet 访问 RequestForwardServlet，浏览器的显示结果如图 2 所示。

![b60babb9ddf04680df1ec495498e2028.png][]

图 2 运行结果

从图 2 中可以看出，地址栏中显示的仍然是 RequestForwardServlet 的请求路径，但是浏览器却显示出了 ResultServlet 中要输出的内容。这是因为请求转发是发生在服务器内部的行为，从 RequestForwardServlet 到 ResultServlet 属于一次请求，在一次请求中是可以使用 request 属性进行数据共享的。

[c33f22258f9a1352570ad9fce9228ed4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/d3cecf74239a4bf9a70555557554bccb.png
[b60babb9ddf04680df1ec495498e2028.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/4e2e82b43f5f4156918a35577a375671.png