笔记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>1</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>1</load-on-startup>
</servlet>

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