DispatcherServlet与ContextLoaderListener

DispatcherServlet与ContextLoaderListener

Spring MVC 配置的两种方式：Web.xml 和 java 类配置

DispatcherServlet是Spring MVC的核心，在这里请求会第一次接触到框架，它负责将请求路由到其余组件之中。

传统配置DispatcherServlet是采用web.xml文件的方式。通常以下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
    
     <!-- 监听器配置 -->
    <listener>
    	<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    
    <!-- 上下文参数，在监听器中被使用 -->
    <!-- 监听器配置文件路径 -->
    <context-param>
    	<param-name>contextConfigLocation</param-name>
    	<param-value>
        	classpath:applicationContext.xml
        </param-value>
    </context-param>
    
    <!-- 前端控制器配置 -->
    <servlet>
        <!--在DispatcherServlet的初始化过程当中，框架会在web应用的WEB-INF文件夹下默认寻找名为[servlet-name]-servlet.xml 的配置文件，生成文件中定义的bean。如如下默认寻找dispatcher-servlet.xml-->
    	<servlet-name>dispatcher</servlet-name>
    	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    	<init-param>
            <!-- 前端控制器配置文件路径 -->
    		<param-name>contextConfigLocation</param-name>
    		<param-value>classpath:applicationContext-mvc.xml</param-value>
    	</init-param>
        <!--是启动顺序，让这个Servlet随Servletp容器一块儿启动。-->
    	<load-on-startup>1</load-on-startup>
    </servlet>
    
    <servlet-mapping>
        <!--这个Servlet的名字是dispatcher，能够有多个DispatcherServlet，是经过名字来区分的。每个DispatcherServlet有本身的WebApplicationContext上下文对象。同时保存的ServletContext中和Request对象中.-->
        <!--ApplicationContext是Spring的核心，Context咱们一般解释为上下文环境，我想用“容器”来表述它更容易理解一些，ApplicationContext则是“应用的容器”了:P，Spring把Bean放在这个容器中，在须要的时候，用getBean方法取出-->
    	<servlet-name>dispatcher</servlet-name>
        <!--Servlet拦截匹配规则能够自已定义，当映射为@RequestMapping("/user/add")时，为例,拦截哪一种URL合适？-->
        <!--一、拦截*.do、*.htm， 例如：/user/add.do,这是最传统的方式，最简单也最实用。不会致使静态文件（jpg,js,css）被拦截。-->
        <!--二、拦截/，例如：/user/add,能够实现如今很流行的REST风格。不少互联网类型的应用很喜欢这种风格的URL。弊端：会致使静态文件（jpg,js,css）被拦截后不能正常显示。 -->
    	<url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>
复制代码

在Servlet3规范中，容器会在类路径中查找实现ServletContainerInitializer接口的类，若是能发现的话就用它来配置Servlet容器。

Spring中提供了这个接口的实现，名为SpringServletContainerInitializer，这个类反过来又会查找实现WebApplicationInitializer的类并将配置任务交给它们继续完成。Spring3.2中，提供了一个便利的WebApplicationInitializer的基础实现，即AbstractAnnotationConfigDispatcherServletInitializer。因此采用java配置DispatcherServlet只须要扩展AbstractAnnotationConfigDispatcherServletInitializer就能够了。

而且扩展AbstractAnnotationConfigDispatcherServletInitializer的任意类都会自动的配置DispatcherServlet和SpringApplicationContext。

通常java配置以下：

public class WebMVCInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    /** * 根应用上下文配置文件 */
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class<?>[]{
            RootConfig.class
        };
    }

    /** * web 应用上下文配置文件 */
    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class<?>[]{
        	WebConfig.class
        };
    }

    @Override
    protected String[] getServletMappings() {
        return new String[]{
                "/"
        };
    }
    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        super.onStartup(servletContext);
        servletContext.addListener(new SessionListener());
    }
}
复制代码

两个应用上下文之间的故事

在java配置文件中，咱们发现了两个应用上下文：根应用上下文，web应用上下文。

首先咱们先看 DispatcherServlet 和 ContextLoaderListener。

DispatcherServlet ，前端控制器

DispatcherServlet 本质是一个Servlet，它扩展了HTTPServlet，其主要目的是处理与配置URL模式匹配的传入Web的请求。

每个DispatcherServlet定义一个Spring的web application，而且都与一个WebApplicationContext相关。当DispatcherServlet启动的时候，它会建立WebApplicationContext，并加载配置文件。

从Spring 3.x开始，方法DispatcherServlet(WebApplicationContext webApplicationContext)经过给定的web application context建立一个新DispatcherServlet。只有在Servlet 3.x环境中才有可能经过ServletContext.addServlet(java.lang.String, java.lang.String)的API支持。

ContextLoaderListener，上下文加载监听器

ContextLoaderListener是spring框架对servlet监听器的一个封装，本质上仍是一个servlet监听器，它建立了一个根应用程序上下文（ApplicationContext），并与全部DispatcherServlet上下文建立的子上下文共享。

ContextLoaderListener 包含全局可见的bean 的上下文，如服务，存储库，基础结构bean等。建立根应用程序上下文后，它将 ServletContext 做为属性存储，名称为：

// org/springframework/web/context/ContextLoader.java
servletContext.setAttribute(WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, this.context);
 
//Where attibute is defined in /org/springframework/web/context/WebApplicationContext.java as
 
WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE = WebApplicationContext.class.getName() + ".ROOT";
复制代码

要在Spring控制器中获取根应用程序上下文，可使用 WebApplicationContextUtils 类。

// Controller.java
@Autowired
ServletContext context;
 
ApplicationContext ac = WebApplicationContextUtils.getWebApplicationContext(context);
 
if(ac == null){
    return "root application context is null";
}    
复制代码

在Spring Web应用程序中，有两种类型的容器，ApplicationContext和WebAppilicationContext.

ApplicationContext是由ContextLoaderListener建立并配置的或Web.xml。

而WebApplicationContext是ApplicationContext的子上下文环境。是由DispatcherServlet 启动时建立配置的。

DispatcherServlet 和 ContextLoaderListener之间的关系。

  因此说若是没有配置listener参数，只配置了dispatcherServlet时，tomcat启动时是不会初始化Spring Web上下文的，由于Spring Web是基于Spring的，你没有配置Spring，因此也不会启动它的子上下文Spring Web。这一点在Spring MVC启动源码中也能够看到。

下图中详细的描述了整个关系。

1. ContextLoaderListener 建立根应用程序上下文
2. DispatcherServlet 条目为每一个servlet条目建立一个子应用程序上下文。
3. 子上下文能够访问根上下文中定义的bean。
4. 根上下文中的Bean没法直接访问子上下文中的bean。
5. 全部上下文都被添加到ServletContext。
6. 你可使用WebApplicationContextUtils类访问根上下文。

两者具体关系参考自ContextLoaderListener vs DispatcherServlet

Spring MVC启动流程

Tomcat启动时会优先加载Servlet监听器组件，并调用ContextInitialized方法。而ContextLoaderListener继承了ServletContextListener实现了ContextInitialized方法。在其中调用initwebApplicationContext方法初始化Spring Web Context。这就是 Spring MVC 的入口。

public class ContextLoaderListener extends ContextLoader implements ServletContextListener {

   public ContextLoaderListener() {
   }
   
   public ContextLoaderListener(WebApplicationContext context) {
      super(context);
   }

   /** * Initialize the root web application context. */
   @Override
   public void contextInitialized(ServletContextEvent event) {
      initWebApplicationContext(event.getServletContext());
   }

   /** * Close the root web application context. */
   @Override
   public void contextDestroyed(ServletContextEvent event) {
      closeWebApplicationContext(event.getServletContext());
      ContextCleanupListener.cleanupAttributes(event.getServletContext());
   }
}
复制代码

通常DispatcherServlet加载包含Web组件的bean（控制器，视图解析器，以及处理器映射），根上下文加载应用中的其余bean（安全性，事务，服务，中间层和数据层组件等）。

参考文献:

howtodoinjava.com/spring-mvc/…

blog.csdn.net/seagal890/a…

juejin.im/post/5b207d…