Spring Web MVC配置方式汇总（一）

1 Spring Web MVC

本文将介绍Spring Web MVC的几种配置方法。

2 准备工作

首先得有一个工程，我们随便建一个web工程，比如SpringMvcTest。

按照从零搭建Web应用中介绍的，先调整下pom.xml文件。

    4.0.0
    org.example
    SpringMvcTest
    1.0-SNAPSHOT
    war
    
        UTF-8
        1.8
        1.8
        1.8
    
    
        
            
                org.apache.tomcat.maven
                tomcat7-maven-plugin
                2.2
                
                    /
                
            
        
    

另外，既然是要用Spring Web MVC搭建Web应用，那我们自然需要在pom.xml中增加jar包依赖。

    ...
    
        
            org.springframework
            spring-webmvc
            5.2.8.RELEASE
        
    
    ...

此外，我们准备一个@Controller类，用于处理浏览器发送的请求。当在浏览器输入http://localhost:8080/test时，服务器端返回Hello. This is Spring Web MVC.

package org.example.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class MyController {
    @RequestMapping("/test")
    public String sayHello() {
        return "Hello. This is Spring Web MVC.";
    }
}

3 使用web.xml

在从零搭建Web应用中曾说过，Web应用加载的入口是web.xml文件，这一点在Spring Web MVC中也适用。我们在WEB-INF/web.xml文件中进行如下配置：

    
        org.springframework.web.context.ContextLoaderListener
    
    
        contextConfigLocation
        /WEB-INF/app-context.xml
    
    
        app
        org.springframework.web.servlet.DispatcherServlet
        
            contextConfigLocation
            
        
        1
    
    
        app
        /*
    

listener节点配置监听器，监听的是Web容器ServletContext的事件，这在ServletContextListener的定义中可以看出来：

/**
 * Interface for receiving notification events about ServletContext
 * lifecycle changes.
**/
public interface ServletContextListener extends EventListener {
    default public void contextInitialized(ServletContextEvent sce) {}
    default public void contextDestroyed(ServletContextEvent sce) {}
}

ContextLoaderListener是spring-web中的类，其作用是初始化WebApplicationContext。WebApplicationContext和ServletContext是不同性质的类，WebApplicationContext是Spring的IoC容器，而ServletContext是Web容器类。

public class ContextLoaderListener extends ContextLoader implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent event) {
        initWebApplicationContext(event.getServletContext());
    }
    @Override
    public void contextDestroyed(ServletContextEvent event) {
        closeWebApplicationContext(event.getServletContext());
        ContextCleanupListener.cleanupAttributes(event.getServletContext());
    }
}

上面这段配置的意思是，WebApplicationContext伴随着ServletContext对象创建而创建，也跟着ServletContext对象消亡而消亡，这个特性在所有的Spring Web MVC工程中都是通用的。

servlet和servlet-mapping两段配置的意思是所有的请求（/*）都由DispatcherServlet类处理。DispatcherServlet类是何方神圣，为何它能处理所有的请求呢？

这便是MVC模式中所说的控制器功能(Model-View-Controller)，其实DispatcherServlet并不对任何的请求进行具体的处理，它会为每次请求找到某个Controller对象的方法，由它来处理该请求。

contextConfigLocation属性则配置了一个文件路径，该文件是WebApplicationContext初始化时用到的配置文件，当中有WebApplicationContext初始化时需要用到的各类配置。

DispatcherServlet中引用了WebApplicationContext对象，利用Spring IoC容器的各种特性完成请求分发处理的工作。WebApplicationContext中包含了对ServletContext的引用。这便是DispatcherServlet、WebApplicationContext和ServletContext三者的关系。

在WEB-INF目录下创建app-context.xml文件。

context:component-scan配置指明需要扫描注解的package的根路径，这条配置保证我们前面创建的MyController对象可以被WebApplicationContext识别并加载到IoC容器中。若没有该配置，DispatcherServlet便无法识别我们编写的MyController，那么请求也就无法正确被执行。

mvc:annotation-driven注解的意思是告诉Spring Web MVC启动自动配置功能。Spring Web MVC具有很强大的自适配功能，可以根据应用环境选择最合适的加载方式，自主确定哪些Bean对象需要在应用启动时加载到IoC容器中。

这样配置完成后，运行应用，在浏览器上输入http://localhost:8080/test便能得到正确的返回了。

4 后续

后续的文章中，将会介绍如何完全舍弃web.xml文件来配置应用。

5 结论

Spring Web MVC框架还是很复杂的，要深入了解还需要多花时间的。