©
本文档使用 PHP中文网手册 发布
与其它web MVC框架一样,Spring的web MVC框架是一个请求驱动的web框架,其设计围绕一个中心的servlet进行,
它能将请求分发给控制器,并提供其它功能帮助web应用开发。然而,Spring的DispatcherServlet
所做的不仅仅是这些,它和Spring的IoC容器完全集成在一起,从而允许你使用Spring的其它功能。
下图展示了Spring Web MVC DispatcherServlet
处理请求的流程。
熟悉设计模式的读者可能会发现DispatcherServlet
应用了“
Front Controller”模式(很多其他的主流web框架也都用到了该模式)。
DispatcherServlet
实际上是一个Servlet
(它继承了HttpServlet
)。与其它Servlet一样,
DispatcherServlet
定义在web应用的web.xml
文件中。
DispatcherServlet处理的请求必须在同一个web.xml
文件里使用url-mapping定义映射。
下面的例子演示了如何配置DispatcherServlet
。
<web-app> <servlet> <servlet-name>example</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>example</servlet-name> <url-pattern>*.form</url-pattern> </servlet-mapping> </web-app>
在上面的例子里,所有以.form
结尾的请求都会由名为
example
的DispatcherServlet
处理。这只是配置Spring Web MVC
的第一步。接下来需要配置DispatcherServlet
本身和Spring Web MVC 框架用到的其他的bean。
正如在第 3.8 节 “The ApplicationContext
”中所描述的,Spring中的
ApplicationContext
实例可以被限制在不同的作用域(scope)中。在web MVC框架中,每个
DispatcherServlet
有它自己的WebApplicationContext
,这个context继承了根 WebApplicationContext
的所有bean定义。这些继承的bean也可以在每个serlvet自己的所属的域中被覆盖(override),覆盖后的bean
可以被设置成只有这个servlet实例自己才可以使用的属性。
在DispatcherServlet
的初始化过程中,框架会在web应用的
WEB-INF
文件夹下寻找名为[servlet-name]-servlet.xml
的配置文件,生成文件中定义的bean。这些bean会覆盖在全局范围(global cope)中定义的同名的bean。
下面这个例子展示了在web.xml
中DispatcherServlet
的配置:
<web-app> ... <servlet> <servlet-name>golfing</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>golfing</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> </web-app>
上述servlet配置完成后,还需要配置/WEB-INF/
golfing-servlet.xml
文件。golfing-servlet.xml这个文件应该声明在
Spring Web MVC 框架中需要的bean。 这个文件的路径也可以通过web.xml中servlet
的初始化参数来更改(详情见下面的例子)。
WebApplicationContext
仅仅是一个拥有web应用必要功能的普通
ApplicationContext
。它与一个标准的
ApplicationContext
的不同之处在于,它能够解析theme
(参考第 13.7 节 “使用主题”),并且它知道自己与哪个servlet相关联
(通过ServletContext
)。WebApplicationContext
被绑定在ServletContext
上,需要时,可以使用
RequestContextUtils
提供的静态方法找到WebApplicationContext
。
Spring的DispatcherServlet
有一组特殊的bean,
用来处理请求和渲染相应的视图。这些bean包含在Spring的框架里,可以在
WebApplicationContext
中配置,配置方式与配置其它bean相同。这些bean
中的每一个都在下文作详细描述。此刻读者只需知道它们的存在,以便我们继续对DispatcherServlet
进行讨论。对大多数bean,Spring都提供了合理的缺省值,所以在开始阶段,你不必担心如何对其进行配置。
表 13.1. WebApplicationContext
中特殊的bean
Bean类型 | 描述 |
---|---|
控制器(Controllers) |
控制器 实现的是MVC中的C 。
|
处理器映射(Handler mapping) | 处理器映射包含预处理器(pre-processor), 后置处理器(post-processor)和控制器的列表,它们在符合某种条件时才被执行(例如符合控制器指定的URL)。 |
视图解析器(View resolvers) | 视图解析器 可以将视图名解析为对应的视图。 |
本地化解析器(Locale resolver) | 本地化解析器能够解析用户正在使用的本地化设置,以提供国际化视图。 |
主题解析器(Theme resolver) | 主题解析器能够解析你的web应用所使用的主题,以提供个性化的布局。 |
文件上传解析器(Multipart File resolver) | 文件上传解析器提供HTML表单文件上传功能。 |
处理器异常解析器(Handler exception resolver(s)) | 处理器异常解析器可以将异常对应到视图,或者实现更加复杂的异常处理逻辑。 |
DispatcherServlet
配置完成后,当相应的请求到达时,处理就开始了。
下面的列表描述了DispatcherServlet
处理请求的全过程:
找到WebApplicationContext
并将其绑定到请求的一个属性上,
以便控制器和处理链上的其它处理器能使用WebApplicationContext
。
默认的属性名为DispatcherServlet.WEB_APPLICATION_CONTEXT_ATTRIBUTE
。
将本地化解析器(localResolver)绑定到请求上,这样使得处理链上的处理器在处理请求(准备数据、显示视图等等) 时能进行本地化处理。若不使用本地化解析器,也不会有任何副作用,因此如果不需要本地化解析,忽略它即可。
将主题解析器绑定到请求上,这样视图可以决定使用哪个主题。如果你不需要主题,可以忽略它,不会有任何影响。
如果上传文件解析器被指定,Spring会检查每个接收到的请求是否存在上传文件,如果存在,
这个请求将被封装成MultipartHttpServletRequest
以便被处理链中的其它处理器使用
(关于文件上传的更多内容请参考第 13.8.2 节 “使用MultipartResolver
”)。
找到合适的处理器,执行和这个处理器相关的执行链(预处理器,后置处理器,控制器),以便为视图准备模型数据(用于渲染)。
如果模型数据被返回,就使用配置在WebApplicationContext
中的视图解析器显示视图,
否则视图不会被显示。有多种原因可以导致返回的数据模型为空,比如预处理器或后处理器可能截取了请求,这可能是出于安全原因,
也可能是请求已经被处理,没有必要再处理一次。
请求处理过程中抛出的异常,可以被任何定义在WebApplicationContext
中的异常解析器所获取。
使用这些异常解析器,可以在异常抛出时根据需要定义特定行为。
Spring的DispatcherServlet
也支持返回Servlet API定义的last-modification-date。
决定某个请求的最后修改日期很简单:DispatcherServlet
会首先寻找一个合适的handler mapping,检查从中取得指定的处理器是否实现了
LastModified
接口,如果是,将调用long getLastModified(request)
方法,并将结果返回给客户端。
可以通过两种方式定制Spring的DispatcherServlet
:在web.xml
文件中增加添加context参数,
或servlet初始化参数。下面是可能用到的参数。
表 13.2. DispatcherServlet
初始化参数
参数 | 描述 |
---|---|
contextClass |
实现WebApplicationContext 接口的类,当前的servlet用它来创建上下文。如果这个参数没有指定,
默认使用XmlWebApplicationContext 。
|
contextConfigLocation |
传给上下文实例(由contextClass指定)的字符串,用来指定上下文的位置。这个字符串可以被分成多个字符串(使用逗号作为分隔符) 来支持多个上下文(在多上下文的情况下,如果同一个bean被定义两次,后面一个优先)。 |
namespace |
WebApplicationContext 命名空间。默认值是[server-name]-servlet 。
|