Servlet 中的 RequestDispatcher

2025年3月17日 | 阅读 3 分钟

RequestDispatcher 接口
RequestDispatcher 接口的方法
1. forward 方法
2. include 方法
如何获取 RequestDispatcher 对象
RequestDispatcher 接口的例子

RequestDispatcher 接口提供了将请求分派到另一个资源（可以是 html、servlet 或 jsp）的功能。此接口还可用于包含另一个资源的内容。这是 servlet 协作的一种方式。

RequestDispatcher 接口中定义了两个方法。

RequestDispatcher 接口的方法

RequestDispatcher 接口提供两种方法。它们是

public void forward(ServletRequest request,ServletResponse response)throws ServletException,java.io.IOException:将来自 servlet 的请求转发到服务器上的另一个资源（servlet、JSP 文件或 HTML 文件）。
public void include(ServletRequest request,ServletResponse response)throws ServletException,java.io.IOException:在响应中包含资源（servlet、JSP 页面或 HTML 文件）的内容。

forward() method of RequestDispatcher interface

如上图所示，第二个 servlet 的响应被发送到客户端。第一个 servlet 的响应未显示给用户。

include() method of RequestDispatcher interface

如上图所示，第二个 servlet 的响应包含在发送到客户端的第一个 servlet 的响应中。

如何获取 RequestDispatcher 对象

ServletRequest 接口的 getRequestDispatcher() 方法返回 RequestDispatcher 对象。语法

getRequestDispatcher 方法的语法

使用 getRequestDispatcher 方法的示例

RequestDispatcher rd=request.getRequestDispatcher("servlet2");
//servlet2 is the url-pattern of the second servlet

rd.forward(request, response);//method may be include or forward

RequestDispatcher 接口的例子

在本例中，我们正在验证用户输入的密码。如果密码是 servlet，它将把请求转发到 WelcomeServlet，否则将显示错误消息：sorry username or password error!。在此程序中，我们正在检查硬编码的信息。但你也可以将其检查到数据库，我们将在开发章节中看到。在本例中，我们创建了以下文件

index.html 文件：用于从用户获取输入。
Login.java 文件：一个 servlet 类，用于处理响应。如果密码是 servet，它将把请求转发到欢迎 servlet。
WelcomeServlet.java 文件：一个 servlet 类，用于显示欢迎消息。
web.xml 文件：一个部署描述符文件，其中包含有关 servlet 的信息。

RequestDispatcher interface

index.html

<form action="servlet1" method="post">
Name:<input type="text" name="userName"/><br/>
Password:<input type="password" name="userPass"/><br/>
<input type="submit" value="login"/>
</form>

Login.java

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;


public class Login extends HttpServlet {

public void doPost(HttpServletRequest request, HttpServletResponse response)
		throws ServletException, IOException {

	response.setContentType("text/html");
	PrintWriter out = response.getWriter();
		
	String n=request.getParameter("userName");
	String p=request.getParameter("userPass");
		
	if(p.equals("servlet"){
		RequestDispatcher rd=request.getRequestDispatcher("servlet2");
		rd.forward(request, response);
	}
	else{
		out.print("Sorry UserName or Password Error!");
		RequestDispatcher rd=request.getRequestDispatcher("/index.html");
		rd.include(request, response);
					
		}
	}

}

WelcomeServlet.java

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class WelcomeServlet extends HttpServlet {

	public void doPost(HttpServletRequest request, HttpServletResponse response)
		throws ServletException, IOException {

	response.setContentType("text/html");
	PrintWriter out = response.getWriter();
		
	String n=request.getParameter("userName");
	out.print("Welcome "+n);
	}

}

web.xml

<web-app>
 <servlet>
    <servlet-name>Login</servlet-name>
    <servlet-class>Login</servlet-class>
  </servlet>
  <servlet>
    <servlet-name>WelcomeServlet</servlet-name>
    <servlet-class>WelcomeServlet</servlet-class>
  </servlet>


  <servlet-mapping>
    <servlet-name>Login</servlet-name>
    <url-pattern>/servlet1</url-pattern>
  </servlet-mapping>
  <servlet-mapping>
    <servlet-name>WelcomeServlet</servlet-name>
    <url-pattern>/servlet2</url-pattern>
  </servlet-mapping>

  <welcome-file-list>
   <welcome-file>index.html</welcome-file>
  </welcome-file-list>
</web-app>

下载此示例
下载此示例（在 Myeclipse IDE 中开发）
下载此示例（在 eclipse IDE 中开发）
下载此示例（在 netbeans IDE 中开发）