细说Spring Boot初始化DispatcherServlet

发布时间 2023-07-31 00:51:48作者: nuccch

DispatcherServlet概述

在Spring Boot框架未出现之前,要开发一个基于Spring MVC框架的项目,通常需要在Java web项目的描述符文件web.xml中添加如下配置:

<!-- 初始化Spring IoC容器 -->
<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<!-- 手动配置DispatcherServlet  -->
<servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:/spring*.xml</param-value>
    </init-param>
</servlet>

<!-- 配置DispatcherServlet拦截路径,让所有Web请求都经过DispatcherServlet -->
<servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

添加如上配置之后,就能实现将Spring MVC框架整合到Web项目中了,那这是怎么做到的呢?下面一一解答下。

首先,org.springframework.web.context.ContextLoaderListener实现了接口javax.servlet.ServletContextListener,这样就能确保Web应用在启动后回调该接口。

public interface ServletContextListener extends EventListener {
	// Web应用在启动之后会调用该方法,通过传递的事件参数获取到ServletContext上下文环境
    public void contextInitialized(ServletContextEvent sce);

	// Web应用在停止后会回调该方法
    public void contextDestroyed(ServletContextEvent sce);
}

其次,在org.springframework.web.context.ContextLoaderListener中实现了contextInitialized()方法,并且在方法实现中触发了对Spring IoC容器的初始化,并且将ServletContext上下文保存到了IoC容器中。

// ServletContextListener
@Override
public void contextInitialized(ServletContextEvent event) {
    // 触发对Spring IoC容器的初始化
    initWebApplicationContext(event.getServletContext());
}

// AbstractRefreshableWebApplicationContext
@Override
public void setServletContext(@Nullable ServletContext servletContext) {
    // 在IoC容器中保存了ServletContext上下文
    this.servletContext = servletContext;
}

既然Spring IoC容器已经和ServletContext建立了联系,那当Web请求被DispatcherServlet拦截之后就可以基于Spring IoC容器环境进行处理了,实际上这样就建立了一个从Serlvet到Spring MVC框架的桥梁。

至此,关于Spring MVC框架如何与Web应用集成的问题就算得到了解答,很显然在传统的Spring MVC项目中,这是通过手动配置实现的。而在使用Spring Boot框架时就没有再看到这些配置了, Spring Boot的强大之处在于自动装配机制,虽然我们没有手动去配置,实际上是Spring Boot框架帮我们自动实现了。
那么,Spring Boot是如何实现的呢?

Spring Boot自动初始化DispatcherServlet

如下解读基于Spring Boot 2.7.14版本进行。

经过对Spring Boot的源码解读和梳理后知道,在Spring Boot框架中DispatcherServlet的自动装配是通过注解@DispatcherServletAutoConfiguration实现的。
具体流程如下:

首先,在Spring Boot的核心注解@EnableAutoConfiguration中引入了一个类AutoConfigurationImportSelector,Spring Boot在启动时会触发该类中如下方法的调用。

// AutoConfigurationImportSelector.getCandidateConfigurations()
// 该方法是在Spring Boot启动时调用的,具体来说是在刷新Spring IoC容器的时候触发的
// 在该方法中实现加载自动配置类,具体来说,是加载2个配置文件中的自动配置类
// 其一,加载各种starter组件jar中"META-INF/spring.factories"文件指定的自动配置类
// 其二,加载Sring Boot自己的自动配置类,这些类在文件"META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports"中指定
protected List<String> getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {
    // 首先加载各类starter组件jar包中"META-INF/spring.factories"文件指定的自动配置类
    List<String> configurations = new ArrayList<>(
            SpringFactoriesLoader.loadFactoryNames(getSpringFactoriesLoaderFactoryClass(), getBeanClassLoader()));
    // 再加载文件"META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports"中指定的自动配置类
    ImportCandidates.load(AutoConfiguration.class, getBeanClassLoader()).forEach(configurations::add);
    return configurations;
}

其次,在加载Spring Boot的“META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports”自动配置类的时候,就会加载到org.springframework.boot.autoconfigure.web.servlet.DispatcherServletAutoConfiguration

DispatcherServletAutoConfiguration的源码中可以很清晰地看到正是在该配置类中实现了对dispatcherServlet的注入。

@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE)
@AutoConfiguration(after = ServletWebServerFactoryAutoConfiguration.class)
@ConditionalOnWebApplication(type = Type.SERVLET)
@ConditionalOnClass(DispatcherServlet.class)
public class DispatcherServletAutoConfiguration {
    @Configuration(proxyBeanMethods = false)
	@Conditional(DefaultDispatcherServletCondition.class)
	@ConditionalOnClass(ServletRegistration.class)
	@EnableConfigurationProperties(WebMvcProperties.class)
	protected static class DispatcherServletConfiguration {
        
        // 实际上是在DispatcherServletAutoConfiguration的内部静态类DispatcherServletConfiguration中完成了对"dispatcherServlet"的注入
		@Bean(name = DEFAULT_DISPATCHER_SERVLET_BEAN_NAME)
		public DispatcherServlet dispatcherServlet(WebMvcProperties webMvcProperties) {
			DispatcherServlet dispatcherServlet = new DispatcherServlet();
			dispatcherServlet.setDispatchOptionsRequest(webMvcProperties.isDispatchOptionsRequest());
			dispatcherServlet.setDispatchTraceRequest(webMvcProperties.isDispatchTraceRequest());
			dispatcherServlet.setThrowExceptionIfNoHandlerFound(webMvcProperties.isThrowExceptionIfNoHandlerFound());
			dispatcherServlet.setPublishEvents(webMvcProperties.isPublishRequestHandledEvents());
			dispatcherServlet.setEnableLoggingRequestDetails(webMvcProperties.isLogRequestDetails());
			return dispatcherServlet;
		}

		// 省略了其他代码
        // ...
	}
}

虽然解答了DispatcherServlet的自动注入问题,但是还没有解答Spring IoC容器是如何与ServletContext上下文建立联系的。
经过对Spring Boot启动流程的源码解读知道,其实建立Spring IoC容器与ServletContext的关系是在ServletWebServerApplicationContext.onRefresh()方法中实现的。

// 在刷新Spring IoC容器的过程中会调用该方法
@Override
protected void onRefresh() {
    super.onRefresh();
    try {
        createWebServer();
    }
    catch (Throwable ex) {
        throw new ApplicationContextException("Unable to start web server", ex);
    }
}

private void createWebServer() {
    // 在这里会完成对Servlet容器的创建,并且与ServletContext上下文进行关联
}

所以,Spring Boot通过自动装配机制完成了对Spring MVC的DispatcherServlet注入,并且还创建了嵌入式的Servlet容器,并以Deamon线程方式运行在后台。