RequestDispatcher接口提供將請求轉發(fā)送到另一個資源的功能,它可能是html,servlet或jsp等。 此接口也可用于包括另一資源的內容。它是servlet協(xié)作的一種方式。
在RequestDispatcher接口中定義了兩種方法。它們分別是 -
| 編號 | 方法 | 描述 |
|---|---|---|
| 1 | public void forward(ServletRequest request,ServletResponse response)throws ServletException,java.io.IOException |
將servlet的請求轉發(fā)到服務器上的另一個資源(servlet,JSP文件或HTML文件)。 |
| 2 | public void include(ServletRequest request,ServletResponse response)throws ServletException,java.io.IOException |
在響應中包含資源的內容(servlet,JSP頁面或HTML文件)。 |

如上圖所示,第一個servlet轉發(fā)請求到第二個servlet的響應發(fā)送給客戶端。 第一個servlet的響應不會顯示給用戶。

如上圖所示,第二個servlet的響應將包含在發(fā)送給客戶端的第一個servlet的響應中。
如何獲取RequestDispatcher的對象?
ServletRequest接口的getRequestDispatcher()方法返回RequestDispatcher的對象。
getRequestDispatcher方法的語法如下 -
public RequestDispatcher getRequestDispatcher(String resource);
使用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
在這個例子中,驗證用戶輸入的密碼。如果密碼是:mypasswd,它會將請求轉發(fā)到WelcomeServlet,否則會顯示一條錯誤消息:sorry username or password error! 在這個程序中,使用的是硬編碼(即:直接在代碼中指定密碼)。大部分應用中都是在數(shù)據(jù)庫中存儲用戶信息和密碼的,在接下來的教程文章我們也會介紹和學習。在這個例子中,創(chuàng)建了以下幾個文件:
mypasswd,它會將請求轉發(fā)給WelcomeServlet。工作流程,請參考下圖 -

打開Eclipse,創(chuàng)建一個名稱為:ReqDispatcher 的動態(tài)Web項目,其完整的項目結構如下圖所示 -

下面是這個項目中相關文件的代碼實現(xiàn) -
文件:index.html -
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>登錄</title>
</head>
<body>
<div style="text-align:center;">
<form action="/ReqDispatcher/login" method="post">
用戶名:<input type="text" name="userName" /><br />
密碼:<input type="password" name="userPass" /><br />
<input type="submit" value="登錄" />
</form>
</div>
</body>
</html>
文件:Login.java -
package com.yiibai;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
* Servlet implementation class Login
*/
public class Login extends HttpServlet {
private static final long serialVersionUID = 1L;
/**
* @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
* response)
*/
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// TODO Auto-generated method stub
response.setCharacterEncoding("utf-8");//設置服務器端編碼
response.setContentType("text/html;charset=utf-8");
PrintWriter out = response.getWriter();
String name = request.getParameter("userName");
String passwd = request.getParameter("userPass");
// 用戶輸入的密碼是否為:mypasswd
if (passwd.equals("mypasswd") && name.equals("admin")) {
RequestDispatcher rd = request.getRequestDispatcher("welcome");
System.out.println("Username is : "+name);
rd.forward(request, response);
} else {
out.print("Sorry UserName or Password Error!");
RequestDispatcher rd = request.getRequestDispatcher("/index.html");
rd.include(request, response);
}
}
}
文件:WelcomeServlet.java -
package com.yiibai;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
* Servlet implementation class WelcomeServlet
*/
public class WelcomeServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
/**
* @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
* response)
*/
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setCharacterEncoding("utf-8");//設置服務器端編碼
response.setContentType("text/html;charset=utf-8");
String name = request.getParameter("userName");
if(name==null || name=="") {
name = "";
}
PrintWriter out = response.getWriter();
//String chset = response.getCharacterEncoding();
out.print("<!DOCTYPE html>\r\n" +
"<html>\r\n" +
"<head>\r\n" +
"<meta charset=\"UTF-8\">\r\n" +
"<title>登錄成功</title>\r\n" +
"</head>\r\n" +
"<body>");
out.print("<b>登錄成功啦lala ~ </b><hr/>");
out.print("Welcome, " + name);
out.close();
}
}
文件:web.xml -
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
id="WebApp_ID" version="3.1">
<display-name>ReqDispatcher</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>Login</servlet-name>
<servlet-class>com.yiibai.Login</servlet-class>
</servlet>
<servlet>
<servlet-name>WelcomeServlet</servlet-name>
<servlet-class>com.yiibai.WelcomeServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Login</servlet-name>
<url-pattern>/login</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>WelcomeServlet</servlet-name>
<url-pattern>/welcome</url-pattern>
</servlet-mapping>
</web-app>
訪問項目的URL為: http://localhost:8080/ReqDispatcher/ ,如果代碼沒有錯誤,那么應該會看到類似如下的界面 -

當輸入用戶名和密碼分別為:admin 和 mypasswd,然后提交登陸,應該會看到類似如下的界面 -

如果用戶名或密碼錯誤,應該會看到有一條錯誤提示信息: Sorry UserName or Password Error!