2.6.1 RequestDispatcher接口

2.6   请求转发

考虑生活中的一个场景，110报警中心收到群众报警电话，根据报警的内容（报警地点、事情紧急程度），将报警请求交由不同的派出所进行处理。在这里，110报警中心充当了一个调度员的角色，它负责将各种报警请求转发给实际的处理单位。这种处理模型的好处是：

① 给人们提供了统一的报警方式（拨打110）。

② 另一方面，报警中心可以根据报案人所处的位置、派出所的地理位置与人员状况，合理调度资源，安排就近的派出所及时出警。

③ 报警中心并不处理具体的案件，缩短了对报警请求的响应时间。

在Web应用中，这种处理模型也得到了广泛的应用（参见第10.2节），这种调度员的角色通常由Servlet来充当，我们把这样的Servlet叫做控制器（Controller）。在控制器中，可以将请求转发（request dispatching）给另外一个Servlet或者JSP页面，甚至是静态的HTML页面，然后由它们进行处理并产生对请求的响应。要完成请求转发，就要用到javax.servlet.RequestDispatcher接口。

2.6.1  RequestDispatcher接口

RequestDispatcher对象由Servlet容器创建，用于封装一个由路径所标识的服务器资源。利用RequestDispatcher对象，可以把请求转发给其他的Servlet或JSP页面。在RequestDispatcher接口中定义了两种方法。

public void forward(ServletRequest request, ServletResponse response) throws ServletException, java.io.IOException

该方法用于将请求从一个Servlet传递给服务器上的另外的Servlet、JSP页面或者是HTML文件。在Servlet中，可以对请求做一个初步的处理，然后调用这个方法，将请求传递给其他的资源来输出响应。要注意的是，这个方法必须在响应被提交给客户端之前调用，否则的话，它将抛出IllegalStateException异常。在forward()方法调用之后，原先在响应缓存中的没有提交的内容将被自动清除。

public void include(ServletRequest request, ServletResponse response) throws ServletException, java.io.IOException

该方法用于在响应中包含其他资源（Servlet、JSP页面或HTML文件）的内容。和forward()方法的区别在于：利用include()方法将请求转发给其他的Servlet，被调用的Servlet对该请求做出的响应将并入原先的响应对象中，原先的Servlet还可以继续输出响应信息。而利用forward()方法将请求转发给其他的Servlet，将由被调用的Servlet负责对请求做出响应，而原先Servlet的执行则终止。

2.6.2  得到RequestDispatcher对象

有三种方法可以用来得到RequestDispatcher对象。一是利用ServletRequest接口中的getRequestDispatcher()方法：

public RequestDispatcher getRequestDispatcher (java.lang.String path)public RequestDispatcher getRequestDispatcher(java.lang.String path)

外两种是利用ServletContext接口中的getNamedDispatcher()和getRequestDispatcher()方法：

public RequestDispatcher getRequestDispatcher(java.lang.String path) public RequestDispatcher getNamedDispatcher(java.lang.String name)

可以看到ServletRequest接口和ServletContext接口各自提供了一个同名的方法getRequestDispatcher()，那么这两个方法有什么区别呢？两个getRequestDispatcher()方法的参数都是资源的路径名，不过ServletContext接口中的getRequestDispatcher()方法的参数必须以斜杠（/）开始，被解释为相对于当前上下文根（context root）的路径。例如：/myservlet是合法的路径，而../myservlet是不合法的路径；而ServletRequest接口中的getRequestDispatcher()方法的参数不但可以是相对于上下文根的路径，而且可以是相对于当前Servlet的路径。例如：/myservlet和myservlet都是合法的路径，如果路径以斜杠（/）开始，则被解释为相对于当前上下文根的路径；如果路径没有以斜杠（/）开始，则被解释为相对于当前Servlet的路径。ServletContext接口中的getNamedDispatcher()方法则是以在部署描述符中给出的Servlet（或JSP页面）的名字作为参数。

调用ServletContext对象的getContext()方法可以获取另一个Web应用程序的上下文对象，利用该上下文对象调用getRequestDispatcher()方法得到的RequestDispatcher对象，可以将请求转发到另一个Web应用程序中的资源。但要注意的是，要跨Web应用程序访问资源，需要在当前Web应用程序的<context>元素的设置中，指定crossContext属性的值为true（参见第3章）。