HTTP 请求转发、重定向和包含

使Web应用程序如此强大的原因之一是它们彼此链接和聚合信息资源。J2EE 平台为特定URL的 Web组件提供三种相互关联、但是有区别的方式，以便使用其他URL的数据来创建响应。本技巧讨论了如何使用Java Servlet API来实现请求转发、URL重定向和包含。

请求转发

请求转发允许组件发送请求到某个应用程序中的URL，并通过同一应用程序中的不同URL 中的组件来处理该请求。这种技术通常用于Web层控制器servlet，它检查Web请求中的数据，并将请求定向到合适的组件，以便进行处理。

Servlet可以使用javax.servlet.RequestDispatcher.forward方法来转发它所收到的HTTP 请求。接收转发请求的组件能够处理该请求并生成一个响应，或者它还可以将请求转发到另一个组件。最初请求的ServletRequest 和ServletResponse 对象被传递给转发目标组件。这允许目标组件访问整个请求上下文。请求可以只转发给同一应用程序上下文根中的组件，而不在应用程序之间转发。

表单通过POST方法发送给 DispatchDemoServlet，将完成本技巧中三个例子的处理。请求转发由servlet 的doForward 方法处理，代码如下。

protected void doForward(HttpServletRequestreq,

HttpServletResponse res)

throws IOException, ServletException {

String name = req.getParameter("name");

// Look up the site by name

String url = (String)_p.get(name);

if (url == null) {

url = "errorPage.html";

}

// Get the request dispatcher -- request will be

// dispatched to this URL.

RequestDispatcherrd =

req.getRequestDispatcher(url);

// Forward to requested URL

rd.forward(req, res);

}

POST参数“name”指出用户请求的文件的符号名。方法在散列表中查找该文件的URL (散列表从应用归档文件中的属性文件装载) 。然后方法从 HttpServletRequest 对象中获

得 RequestDispatcher 对象。 RequestDispatcher 由Web容器来实现。调用rd.forward指示Web容器调用指定URL的Web组件。请求的结果是该URL的组件返回的任何内容。

URL重定向

URL 重定向类似于请求转发，但也有一些重要的区别。Web组件可以将请求重定向到任一URL，而不仅仅是同一应用上下文中的URL。但最初请求的内容（比如POST参数）丢失了。这是因为服务器与重定向请示的过程无关，这与请求转发的情况是一样的。URL通过使用HTTP META头部的Refresh功能来完成重定向工作。本质上就是，服务器返回一个META标记，告诉浏览器直接去其他地方。这时，最初URL所附带POST数据就会丢失。

URL 重定向可以直接通过操作HTTP 头部来完成，但首选的方式还是使用方法

javax.servlet.ServletResponse.sendRedirect。这个方法的唯一参数就是重定向的目标URL 。

URL 重定向的示例代码使用了示例应用程序中index.html 文件的第二个表单。用户从https://www.360docs.net/doc/8a10192872.html,网站的几个URL中选择一个，然后单击GO。本例子对应于Tip 2 表单中的第2项。

该表单将选定的表单名作为POST方法的参数发送给 DispatchDemoServlet，它再调用方

法doRedirect，代码如下所示：

protected void doRedirect(HttpServletRequestreq,

HttpServletResponse res)

throws IOException, ServletException {

String name = req.getParameter("name");

// Look up the site by name

String url = (String)_p.get(name);

if (url == null) {

url = "errorPage.html";

}

// Redirect request

res.sendRedirect(url);

}

以上是使用doForward 方法来完成请求转发的例子， doRedirect 方法使用用户从表单中选择的符号名来查找重定向的URL。然后doRedirect 方法调用 HttpServletResponse

的 sendRedirect 方法，这就在请求中构造和设置了一个HTTP头部，并立即返回。浏览器将收到空的响应，但因为有META头部，浏览器迅速发出另一个新URL的请求。

虽然servlet产生一个空响应，但如果能在响应中包含一条消息，以解释请求正在重定向，这是一个不错的方法。还有一个好办法是在重定向失败时提供一个到重定向目标的链接。较老的浏览器可能无法实现Refresh功能，或者可能出于安全的原因，该功能已经关闭。链接最好放在例子servlet之外，以简化代码。

包含

到目前为止，您已经学习了响应请求的两种方式：请求转发和URL 重定向。相反，包含允许一个Web组件聚集来自几个其他Web组件的数据，并使用被聚集的数据来创建响应。这种技术通常用于模板处理器。这里一个结构化的模板（通常是JSP 页面）用于控制响应的布局。模板中每个页面区域的内容来自不同的URL，从而组成单个页面。这种技术能够为应该程序提供一致的外观和感觉。

多个Web组件的内容可以被包含在单个响应中。要包含响应中另一个URL的数据，先获得该UML的RequestDispatcher，然后调用 RequestDispatcher的包含方法。

包含的示例代码使用了一组复选框，每个复选框指明一个应用程序归档案中的HTML 文件。每个HTML 文件对应于一种包含在输出中颜色。用户可以通过选中复选框来选择多个文件，然后单击GO。这对应于Tip 2 表单中的第3项。

DispatchDemoServlet 使用了doInclude 方法来处理请求，如下所示：

// Given a list of checked files, include each one of

// them in the output to form a compound document

protected void doInclude(HttpServletRequestreq,

HttpServletResponse res)

throws IOException, ServletException {

String name = req.getParameter("name");

// Get the request dispatcher -- request will be

// dispatched to this URL.

RequestDispatcherrd;

if ((rd = req.getRequestDispatcher("/header.html")) != null) {

rd.include(req, res);

}

if ((rd = req。getRequestDispatcher("/footer。html")) != null) {

rd。include(req， res);

}

String[] names = req.getParameterValues("color");

String url;

for (inti = 0; names != null &&

i

if ((url = (String)_p.get(names[i])) == null) {

continue;

}

if ((rd = req.getRequestDispatcher(url))

!= null) {

rd.include(req, res);

}

}

if ((rd = req.getRequestDispatcher("/footer.html")) != null) {

rd.include(req, res);

}

}

}

注意doInclude方法如何多次调用包含。每次调用包含时，doInclude 必须获得合适URL

的 RequestDispatcher。方法首先包含文件 /header.html。然后获得列表中的复选框的名字，再查找散列表中相应的URL。对于找到的每个URL， doInclude为该URL 获取一

个 RequestDispatcher，然后在输出中包含该URL的内容。对包含方法的调用将该URL的输出写入 HttpServletResponse 对象。最后， doInclude 将URL /footer.html （相对上下文根）的内容写入输出。

请求重定向与请求转发

请求重定向与请求转发

在Servlet程序中,有时需要调用服务器端的另外一个资源来对浏览器的请求进行响应,这可以通

两种方式来实现;其中一种就是调用RequestDispatcher.forward方法与include 方法实现的

请求转发;另外一种则是调用HttpServletResponse.sendRedirect方法实现的请求重定向.

1: RequestDispatcher接口(请求转发)

RequestDispatcher接口中定义了两个方法: forward 方法和include 方法,它们分别用于将请求转发到RequestDispatcher对象封装的资源和将RequestDispatcher对象封装的资

源作为当前响应内容的一部分包含进来.

1) RequestDispatcher对象的获取[通过ServletContext对象]:

ServletContext接口中定义了两个用于获取RequestDispatcher对象的方法

(1) getRequestDispatcher(String param)

(2) getNamedDispatcher(String param)

ServletContextsc = this.getServletContext(); //ServletContext对象的获取

//RequestDispatcher对象的获取

--RequestDispatcher dis = sc.getRequestDispatcher("/servlet2");

--RequestDispatcher dis = sc.getRequestDispatcher("/servlets/targetservlet");

--RequestDispatcher dis =

sc.getRequestDispatcher("/servlets/targetservlet?userName=" + uName);

[注: 传递给该方法的路径字符串必须以"/"开头,这个"/"代表当前WEB应用程序的根目录]

ServletContextsc = this.getServletContext(); //ServletContext对象的获取

//RequestDispatcher对象的获取

--RequestDispatcher dis = sc.getNamedDispatcher("/servlet2");

--RequestDispatcher dis = sc.getNamedDispatcher("/servlets/targetservlet");

--RequestDispatcher dis =

sc.getNamedDispatcher("/servlets/targetservlet?userName=" + uName);

[注: 传递给该方法的参数是在WEB应用程序部署描述符中声明过的Servlet或jsp的

映射名称]

2) RequestDispatcher对象的获取[通过ServletRequest对象]:

在ServletRequest接口中也定义了一个getRequestDispatcher(String param) 方法来

获取

RequestDispatcher对象,它与ServletContext.getRequestDispatcher()方法的区别在于: 传递给这个方法的参数除了可以采用以"/"开头的路径字符串,还可以采用非"/"开头的相

对路径.

(1) getRequestDispatcher(String param)

--RequestDispatcher dis = request.getRequestDispatcher("/servlet2");

--RequestDispatcher dis = request.getRequestDispatcher("servlet2");

--RequestDispatcher dis = request.getRequestDispatcher("servlets/targetservlet");

--RequestDispatcher dis =

request.getRequestDispatcher("servlets/targetservlet?userName=" + uName);

3) 用forward方法实现请求转发

dis.forward(request, response); //[两个页面中的request与response是相同的]

4) 用include方法实现资源包含

dis.include(request, response); //[两个页面中的request与response是相同的]

2: HttpServletResponse接口(请求重定向)

HttpServletResponse接口中定义了一些用于将请求再次定向到新的资源下的方法,最主

要的是

(1) sendRedirect(String url)

该方法不仅可以重定向到当前应用程序中的其他资源,它还可以重定向到同一个站点上的

其他

应用程序中的资源,甚至是使用绝对URL重定向到其他站点的资源.而RequestDispatcher.forward

方法只能在同一个WEB应用程序内资源之间转发请求.如果传递给sendRedirect方法的相对URL不

是以"/"开头,则表示是相对于当前请求的URL;如果该相对URL是以"/"开头,则是相对于整个WEB站

点的根目录,而不是相对于当前WEB应用程序的根目录,例如,下面的语句表示重定向到当前站点中

的APTECH应用程序根目录下的index.html页面;

response.sendRedirect("/APTECH/index.html");

请求转发和请求包含都表示由多个Servlet共同处理一个请求。例如，客户端请

求服务器的AServlet，而AServlet处理不了当前的请求，就转发或包含给BServlet，

由BServlet处理或共同处理该请求。具体如图1-1所示：

图1-1 请求转发和请求包含原理图

由图1-1可知，请求转发和请求包含都是一次请求中，那么服务器只会创建一个

request对象和一个response对象，因此AServlet的request和response与BServlet

中的request和response是同一个request和response。我们知道request对象是

一个域对象，既然AServlet和BServlet的request对象是同一个，那么就可以在

AServlet中向request域中存放数据，然后在BServlet中从request域中获取。这

就是request域的域范围，在一个请求链中。

1.请求转发

请求转发是Servlet将请求转发给别的Servlet或服务器其他资源，无需客户端任

何行为。可以通过以下方式实现请求转发：

request.getRequestDispatcher(“转发资源路径”).forward(request,response)

?getRequestDispatcher(String path)：该方法的返回值类型是RequestDispatcher，可以理解它是一个调度器，该方法的参数是指明要转发或包含的资源路径；

?forward(ServletRequestreq,ServletResponse res)：该方法是RequestDispatcher接口的方法，将请求从一个 servlet 转发到服务器上的另一个资源（servlet、JSP 文件或 HTML 文件）。此方法允许一个 servlet 对请求进行初步处理，并使另一个资源生成响应。需要传递两个参数，这两个参数是当前Servlet的request对象和response对象传递过去的。

通过下图形象理解请求转发，如图1-2所示：

图1-2 请求转发

图1-2满足java_ee_api文档对forward()方法的定义，客户端请求AServlet，而

最终是由BServlet做出响应。

2.请求包含

请求包含是指多个Servlet共同处理一个请求。以下方式可以实现请求包含：

request.getRequestDispatcher(“包含资源路径”).include(request,response)

?include(ServletRequestrequest,ServletResponse response)：该方法是RequestDispatcher接口的方法，表示包含。它的参数同forward()方法的参数一样都是由当前Servlet传递过去的。

通过下图来形象理解请求包含，如图1-3所示：

图1-3 请求包含

3.请求转发和请求包含的比较

(1)相同点

请求转发和请求包含都是在一个请求范围内，多个Servlet之间使用的同一个

request对象和response对象。

(2)不同点

?如果在AServlet中请求转发到BServlet，那么在AServlet中不允许再输出响应体，即不能使用response.getWriter()和response.getOutputStream()向客户端输出，这一工作交由BServlet来完成；如果是由AServlet请求包含BServlet，则没有这个限制。

?请求转发不能设置响应体，但是可以设置响应头，简单来说就是“留头不留体”，例如：

response.setContentType("text/html;charset=utf-8”)；

而请求包含不仅可以设置响应头，还可以设置响应体，简单来说就是“留头又留体“；

?请求包含大多应用在jsp页面中，完成多页面的合并；

?请求转发大多应用在Servlet中，转发目标大多是jsp页面。