笔记33 Spring MVC的高级技术——Spring MVC配置的替代方案

一、自定义DispatcherServlet配置 

AbstractAnnotationConfigDispatcherServletInitializer所完成 的事情其实比看上去要多。在SpittrWebAppInitializer中，原来所编写的三个方法仅仅是必须要重载的abstract方法。但实际上还 有更多的方法可以进行重载，从而实现额外的配置。 此类的方法之一就是customizeRegistration()。 在AbstractAnnotationConfigDispatcherServletInitializer 将DispatcherServlet注册到Servlet容器中之后，就会调 用customizeRegistration()，并将Servlet注册后得到的 Registration.Dynamic传递进来。通过重 载customizeRegistration()方法，我们可以对 DispatcherServlet进行额外的配置。 

需求：在Spring MVC中处理multipart请求和文件上传

需要使用DispatcherServlet的 registration来启用multipart请求。可以重 载customizeRegistration()方法来设 置MultipartConfigElement，如下所示：

     @Override
     protected void customizeRegistration(Dynamic registration) {
         // TODO Auto-generated method stub
         super.customizeRegistration(registration);
         registration.setMultipartConfig(new MultipartConfigElement("/tmp/spittr/uploads"));
     }

设置了对multipart的支持，将上传文件的临时存储 目录设置在“/tmp/spittr/uploads”中。 

二、添加其他的Servlet和Filter

按 照AbstractAnnotationConfigDispatcherServletInitializer 的定义，它会创建DispatcherServlet和 ContextLoaderListener。但是，如果你想注册其他的Servlet、 Filter或Listener的话，就需要创建一个新的初始化器就可以了。基于Java的初始化器（initializer）的一个好处就在于可以定义任 意数量的初始化器类。最简单的方式就是实现 Spring的WebApplicationInitializer接口。 

如下的程序清单展现了如何创建 WebApplicationInitializer实现并注册一个Servlet。 

 package myspittr.config;

 import javax.servlet.ServletContext;
 import javax.servlet.ServletException;
 import javax.servlet.ServletRegistration.Dynamic;

 import org.springframework.web.WebApplicationInitializer;

 public class MyServletInitializer implements WebApplicationInitializer {

     @Override
     public void onStartup(ServletContext arg0) throws ServletException {
         // TODO Auto-generated method stub
         // 注册Servlet
         Dynamic myServlet = arg0.addServlet("myServlet", MyServlet.class);
         // 映射Servlet
         myServlet.addMapping("/custom/**");

     }

 }

三、在web.xml中声明DispatcherServlet 

在典型的Spring MVC应用中，需要DispatcherServlet和 Context-Loader Listener。AbstractAnnotationConfigDispatcherServletInitializer 会自动注册它们，但是如果需要在web.xml中注册的话，就需要手动配置了。

以传统方式搭建DispatcherServlet和ContextLoaderListener。 

web.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
 http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

 <!-- 设置根据上下文配置文件位置 -->
 <context-param>
     <param-name>contextConfigLocation</param-name>
     <param-value>/WEB-INF/spring/root-context.xml</param-value>
 </context-param>
 <!-- 注册ContextLoaderListener -->
 <listener>
     <listener-class>
         org.springframework.web.context.ContextLoaderListener
     </listener-class>
 </listener>
 <!-- 注册DispatcherServlet -->
 <servlet>
         <servlet-name>appServlet</servlet-name>
         <servlet-class>
             org.springframework.web.servlet.DispatcherServlet
         </servlet-class>
         <load-on-startup></load-on-startup>
 </servlet>
 <!-- 将DispatcherServlet映射到“/” -->
 <servlet-mapping>
         <servlet-name>appServlet</servlet-name>
         <url-pattern>/</url-pattern>
 </servlet-mapping>

 </web-app>

ContextLoaderListener和 DispatcherServlet各自都会加载一个Spring应用上下文。上下文 参数contextConfigLocation指定了一个XML文件的地址，这个 文件定义了根应用上下文，它会被ContextLoaderListener加 载，并且会从“/WEB-INF/spring/root-context.xml”中加载bean定义。 

root-context.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <beans xmlns="http://www.springframework.org/schema/beans"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

     <!-- Root Context: defines shared resources visible to all other web components -->

 </beans>

DispatcherServlet会根据Servlet的名字找到一个文件，并基于该 文件加载应用上下文。在上边的代码中，Servlet的名字 是appServlet，因此DispatcherServlet会从“/WEBINF/appServlet-context.xml”文件中加载其应用上下文。 

如果指定DispatcherServlet配置文件的位置的话，那么 可以在Servlet上指定一个contextConfigLocation初始化参数。 例如，如下的配置中，DispatcherServlet会从“/WEBINF/spring/appServlet/servlet-context.xml”加载它的bean：

 <servlet>
         <servlet-name>appServlet</servlet-name>
         <servlet-class>
             org.springframework.web.servlet.DispatcherServlet
         </servlet-class>
         <init-param>
             <param-name>contextConfigLocation</param-name>
             <param-value>
                 /WEB-INF/spring/appServlet/servlet-context.xml
             </param-value>
         </init-param>
         <load-on-startup></load-on-startup>
 </servlet>

四、设置web.xml使用基于Java的配置