Dispatcher Servlet 简单理解及项目配置

本文主要介绍Spring中Dispatcher Servlet在项目中的配置和基本理解

---

一、简介

DispatcherServlet是前端控制器设计模式的实现，提供Spring Web MVC的集中访问点，而且负责职责的分派，与Spring IoC容器无缝集成，从而可以获得Spring的所有好处。

DispatcherServlet配置在web.xml文件中，拦截匹配的请求，Servlet拦截匹配规则要自己定义，把拦截下来的请求，依据相应的规则分发到目标Controller来处理，是配置spring MVC的第一步。

二、作用

DispatcherServlet主要用作职责调度工作，本身主要用于控制流程，主要职责如下：

1、文件上传解析，如果请求类型是multipart将通过MultipartResolver进行文件上传解析；
2、通过HandlerMapping，将请求映射到处理器（返回一个HandlerExecutionChain，它包括一个处理器、多个HandlerInterceptor拦截器）；
3、通过HandlerAdapter支持多种类型的处理器(HandlerExecutionChain中的处理器)；
4、通过ViewResolver解析逻辑视图名到具体视图实现；
5、本地化解析；
6、渲染具体的视图等；
7、如果执行过程中遇到异常将交给HandlerExceptionResolver来解析。

三、web.xml 配置

web.xml 文件配置：

<!-- 上下文 -->
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
        classpath*:/applicationContext.xml
    </param-value>
</context-param>
<listener>
    <description>Spring监听</description>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<!-- Spring MVC -->
<servlet>
    <!-- 配置的Dispatcher Servlet名称及Class类 -->
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

    <!-- 表示启动容器时初始化该Servlet -->
    <load-on-startup>1</load-on-startup>

    <!-- 如若不配置init-param，DispatcherServlet默认使用WebApplicationContext作为上下文，Spring默认配置文件为“/WEB-INF/[servlet名字]-servlet.xml” -->
    <!-- 自定义初始化上下文 -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <!-- 引用spring-mvc.xml文件 -->
        <param-value>classpath*:/spring-mvc.xml</param-value>
    </init-param>
</servlet>

<servlet-mapping>
    <!-- 拦截匹配的请求，Servlet拦截匹配规则 -->
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>*.htm</url-pattern>
    <url-pattern>*.do</url-pattern>
    <url-pattern>*.json</url-pattern>
    <!-- 配置“/“拦截所有 -->
    <url-pattern>/</url-pattern>    
</servlet-mapping>

spring-mvc.xml 文件配置：

<!-- 使用Annotation自动注册Bean,只扫描@Controller -->
<!-- base-package 如果多个，用“,”分隔 -->
<context:component-scan base-package="com.xxx.web.**.*,com.xxx.common.web.**.*" use-default-filters="false">
    <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller" />

    <!-- Spring3.2新注解@ControllerAdvice，使用@Component注解 -->
    <context:include-filter type="annotation" expression="org.springframework.web.bind.annotation.ControllerAdvice" /> 

    <!-- 不扫描Service -->
    <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Service" />
</context:component-scan>

<!-- 默认的注解映射的支持，org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping -->
<mvc:annotation-driven>
    <mvc:message-converters>
        <ref bean="fastJsonHttpMessageConverter" />
        <ref bean="stringHttpMessageConverter" />
    </mvc:message-converters>
</mvc:annotation-driven>

<!-- 拦截器 -->
<mvc:interceptors>
    <!-- 国际化 -->
    <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor" />
    <!-- 异常 -->
    <bean class="com.xxx.common.interceptor.ExceptionInterceptor" />
    <!-- 用户Session -->
    <bean class="com.xxx.web.interceptor.UserLoginInterceptor"/>
</mvc:interceptors>

<!-- 上传限制 -->
<beanid="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="5242880" />
    <property name="maxInMemorySize" value="4096" />
    <property name="defaultEncoding" value="utf-8" />
    <!-- 延迟解析文件 -->
    <property name="resolveLazily" value="true" />
</bean>

<!-- freemark视图分析器 -->
<bean id="freemarkerViewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
    <property name="cache" value="true" />
    <property name="prefix" value="/views/" />
    <property name="suffix" value=".html" />
    <property name="contentType" value="text/html; charset=UTF-8" />
    <property name="exposeRequestAttributes" value="true" />
    <property name="exposeSessionAttributes" value="true" />
    <property name="exposeSpringMacroHelpers" value="true" />
    <property name="requestContextAttribute" value="request" />
</bean>

四、特殊Bean

DispatcherServlet中使用的特殊的Bean：
DispatcherServlet默认使用WebApplicationContext作为上下文，该上下文中特殊的Bean有：

1、Controller：
处理器/页面控制器，做的是MVC中的C的事情，但控制逻辑转移到前端控制器了，用于对请求进行处理；
2、HandlerMapping：
请求到处理器的映射，如果映射成功返回一个HandlerExecutionChain对象
（包含一个Handler处理器（页面控制器）对象、多个HandlerInterceptor拦截器）对象；
如BeanNameUrlHandlerMapping将URL与Bean名字映射，映射成功的Bean就是此处的处理器；
3、HandlerAdapter：
HandlerAdapter将会把处理器包装为适配器，从而支持多种类型的处理器，即适配器设计模式的应用，
从而很容易支持很多类型的处理器；
如SimpleControllerHandlerAdapter将对实现了Controller接口的Bean进行适配，
并且按处理器的handleRequest方法进行功能处理；
4、ViewResolver：
ViewResolver将把逻辑视图名解析为具体的View，通过这种策略模式，很容易更换其他视图技术；
如InternalResourceViewResolver将逻辑视图名映射为jsp视图；
5、LocalResover：
本地化解析，因为Spring支持国际化，因此LocalResover解析客户端的Locale信息从而方便进行国际化；
6、ThemeResovler：
主题解析，通过它来实现一个页面多套风格，即常见的类似于软件皮肤效果；
7、MultipartResolver：
文件上传解析，用于支持文件上传；
8、HandlerExceptionResolver：
处理器异常解析，可以将异常映射到相应的统一错误界面，从而显示用户友好的界面（而不是给用户看到具体的错误信息）；
9、RequestToViewNameTranslator：
当处理器没有返回逻辑视图名等相关信息时，自动将请求URL映射为逻辑视图名；

到此本文已结束，后续有时间继续详解dispatcher servlet初始化及具体实现。
文章部分内容参照百度百科，如有问题，请大家留言指出。

扫描下面二维码，关注我的公众号哦！！！

---

---