原文：http://zetcode.com/java/requestdispatcher/

Java RequestDispatcher教程显示了如何使用 Java RequestDispatcher将请求分派到资源。

RequestDispatcher

RequestDispatcher从客户端接收请求，并将其发送到服务器上的资源（例如 Servlet，HTML 文件，JSP 文件，FreeMarker 或 Thymeleaf 模板）。

RequestDispatcher方法

RequestDispatcher有两种方法：

  • forward() - 将请求从 Servlet 转发到另一个资源
  • include() - 在响应中包含资源的内容

两种方法之间的区别在于，forward()方法将在调用后关闭输出流，而include()方法将打开输出流。 include()方法从另一个资源获取内容，并将其包含在 Servlet 中。 forward()方法将请求发送到另一个资源。

获取RequestDispatcher

RequestDispatcher可以从请求对象或 servlet 上下文中获得。

  1. RequestDispatcher dispatcher = request.getRequestDispatcher("greet.jsp");
  2. dispatcher.forward(request, response);

我们可以使用getRequestDispatcher()方法从请求对象中获取RequestDispatcher。

  1. RequestDispatcher dispatcher = getServletContext().getRequestDispatcher("/greet.jsp");
  2. dispatcher.forward(request, response);

在这里，我们从 servlet 上下文中获取RequestDispatcher。 在这种情况下，路径必须以斜杠字符开头。

Java RequestDispatcher转发到 JSP

以下示例将来自客户端的请求发送到 JSP 页面。

index.html

  1. <!DOCTYPE html>
  2. <html>
  3.     <head>
  4.         <title>Start Page</title>
  5.         <meta charset="UTF-8">
  6.     </head>
  7.     <body>
  8.         <form action="MyServlet">
  10.             <label>Enter your name:
  11.                 <input type="text" name="name">
  12.             </label>
  14.             <button type="submit">Submit</button>
  16.         </form>
  17.     </body>
  18. </html>

在主页中，我们有一个简单的形式：它从用户那里获取一个值，并将其作为请求参数发送到MyServlet。

MyServlet.java

  1. package com.zetcode.web;
  3. import java.io.IOException;
  4. import javax.servlet.ServletException;
  5. import javax.servlet.annotation.WebServlet;
  6. import javax.servlet.http.HttpServlet;
  7. import javax.servlet.http.HttpServletRequest;
  8. import javax.servlet.http.HttpServletResponse;
  10. @WebServlet(name = "MyServlet", urlPatterns = {"/MyServlet"})
  11. public class MyServlet extends HttpServlet {
  13.     @Override
  14.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
  15.             throws ServletException, IOException {
  17.         response.setContentType("text/html;charset=UTF-8");
  19.         request.getRequestDispatcher("greet.jsp").forward(request, response);
  20.     }
  21. }

在MyServlet中，我们使用RequestDispatcher转发到greet.jsp页面。

greet.jsp

  1. <%@page contentType="text/html" pageEncoding="UTF-8"%>
  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.         <meta charset="UTF-8">
  6.         <title>JSP Page</title>
  7.     </head>
  8.     <body>
  9.         <p>Hello ${param.name}!</p>
  10.     </body>
  11. </html>

在greet.jsp页面中，我们显示name参数，该参数由用户在表单中设置。

Java RequestDispatcher转发到 Servlet

以下示例将来自客户端的请求发送到 Servlet，该 Servlet 将处理转发到另一个 Servlet。

index.html

  1. <!DOCTYPE html>
  2. <html>
  3.     <head>
  4.         <title>Start Page</title>
  5.         <meta charset="UTF-8">
  6.     </head>
  7.     <body>
  8.         <p>
  9.             <a href="MyServlet">Call servlet</a>
  10.         </p>
  11.     </body>
  12. </html>

主页包含一个调用MyServlet的链接。

MyServlet.java

  1. package com.zetcode.web;
  3. import java.io.IOException;
  4. import java.time.Instant;
  5. import javax.servlet.ServletException;
  6. import javax.servlet.annotation.WebServlet;
  7. import javax.servlet.http.HttpServlet;
  8. import javax.servlet.http.HttpServletRequest;
  9. import javax.servlet.http.HttpServletResponse;
  11. @WebServlet(name = "MyServlet", urlPatterns = {"/MyServlet"})
  12. public class MyServlet extends HttpServlet {
  14.     @Override
  15.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
  16.             throws ServletException, IOException {
  18.         response.setContentType("text/html;charset=UTF-8");
  20.         request.setAttribute("now", Instant.now());
  22.         request.getRequestDispatcher("AnotherServlet").forward(request, response);
  23.     }
  24. }

该请求首先到达MyServlet。

  1. request.setAttribute("now", Instant.now());

我们为请求设置一个属性； 这是当前时间。

  1. request.getRequestDispatcher("AnotherServlet").forward(request, response);

包括新属性的请求被发送到AnotherServlet。

AnotherServlet.java

  1. package com.zetcode.web;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  5. import java.time.Instant;
  6. import java.time.ZoneId;
  7. import java.time.format.DateTimeFormatter;
  8. import java.time.format.FormatStyle;
  9. import java.util.Locale;
  10. import javax.servlet.ServletException;
  11. import javax.servlet.annotation.WebServlet;
  12. import javax.servlet.http.HttpServlet;
  13. import javax.servlet.http.HttpServletRequest;
  14. import javax.servlet.http.HttpServletResponse;
  16. @WebServlet(name = "AnotherServlet", urlPatterns = {"/AnotherServlet"})
  17. public class AnotherServlet extends HttpServlet {
  19.     @Override
  20.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
  21.             throws ServletException, IOException {
  23.         response.setContentType("text/plain;charset=UTF-8");
  25.         PrintWriter out = response.getWriter();
  27.         DateTimeFormatter formatter
  28.                 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT)
  29.                         .withLocale(Locale.ENGLISH)
  30.                         .withZone(ZoneId.of("UTC"));
  32.         Instant now = (Instant) request.getAttribute("now");
  34.         String output = formatter.format(now);
  35.         out.println(output);
  36.     }
  37. }

AnotherServlet将即时对象格式化为简短的英语日期时间格式，并将其打印到输出流中。

  1. DateTimeFormatter formatter
  2.         = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT)
  3.                 .withLocale(Locale.ENGLISH)
  4.                 .withZone(ZoneId.of("UTC"));

我们使用DateTimeFormatter类格式化日期时间。

  1. Instant now = (Instant) request.getAttribute("now");

我们使用getAttribute()方法从请求中检索属性。

  1. String output = formatter.format(now);
  2. out.println(output);

即时被格式化并打印到输出中。

Java RequestDispatcher包括

下一个示例包括从另一个 servlet 到调用 servlet 的输出。

index.html

  1. <!DOCTYPE html>
  2. <html>
  3.     <head>
  4.         <title>Start Page</title>
  5.         <meta charset="UTF-8">
  6.     </head>
  7.     <body>
  8.         <p>
  9.             <a href="MyServlet">Call servlet</a>
  10.         </p>
  11.     </body>
  12. </html>

主页包含一个调用MyServlet的链接。

MyServlet.java

  1. package com.zetcode.web;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  5. import javax.servlet.ServletException;
  6. import javax.servlet.annotation.WebServlet;
  7. import javax.servlet.http.HttpServlet;
  8. import javax.servlet.http.HttpServletRequest;
  9. import javax.servlet.http.HttpServletResponse;
  11. @WebServlet(name = "MyServlet", urlPatterns = {"/MyServlet"})
  12. public class MyServlet extends HttpServlet {
  14.     @Override
  15.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
  16.             throws ServletException, IOException {
  18.         response.setContentType("text/plain;charset=UTF-8");
  20.         PrintWriter out = response.getWriter();
  21.         out.println("Hello from MyServlet");
  23.         request.getRequestDispatcher("AnotherServlet").include(request, response);
  24.     }
  25. }

MyServlet将数据打印到输出流并转发到AnotherServlet。

AnotherServlet.java

  1. package com.zetcode.web;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  5. import javax.servlet.ServletException;
  6. import javax.servlet.annotation.WebServlet;
  7. import javax.servlet.http.HttpServlet;
  8. import javax.servlet.http.HttpServletRequest;
  9. import javax.servlet.http.HttpServletResponse;
  11. @WebServlet(name = "AnotherServlet", urlPatterns = {"/AnotherServlet"})
  12. public class AnotherServlet extends HttpServlet {
  14.     @Override
  15.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
  16.             throws ServletException, IOException {
  18.         response.setContentType("text/plain;charset=UTF-8");
  20.         PrintWriter out = response.getWriter();
  22.         out.println("Hello from AnotherServlet");
  23.     }
  24. }

AnotherServlet还将数据打印到输出流。 最后，我们将两条消息都写入输出流并发送给客户端。

在本教程中，我们介绍了 Java RequestDispatcher。 我们已经介绍了RequestDispatcher，forward和include()方法。 您可能还需要查看相关的教程： Java servlet JSON 教程，从 Java servlet ， Java servlet 复选框教程，提供纯文本 Java Servlet 图像教程， Java Servlet HTTP 标头或 Java 教程，