概述

我们知道 Spring Boot 应用能够被打成 war 包，放入外部 Tomcat 容器中运行。你是否知道 Spring Boot 是如何整合 Spring MVC 的呢？

如何使用

在我们的 Spring Boot 项目中通常会引入 spring-boot-starter-web 这个依赖，该模块提供全栈的 WEB 开发特性，包括 Spring MVC 依赖和 Tomcat 容器，我们将内部 Tomcat 的 Starter 模块排除掉，如下：

然后启动类这样写：

这样你打成 war 包就可以放入外部的 Servlet 容器中运行了。

实现原理

原理在分析 Spring MVC 源码的时候讲过，参考我的 《精尽Spring MVC源码分析 - 寻找遗失的 web.xml》 这篇文章

借助于 Servlet 3.0 的一个新特性，新增的一个 javax.servlet.ServletContainerInitializer 接口，在 Servlet 容器启动时会通过 Java 的 SPI 机制从 META-INF/services/javax.servlet.ServletContainerInitializer 文件中找到这个接口的实现类，然后调用它的 onStartup(..) 方法。

在 Spring 的 spring-web 模块中该文件是这么配置的：

一起来看看这个类：

通过 @HandlesTypes 注解指定只处理 WebApplicationInitializer 类型的类

这个过程很简单，实例化所有 WebApplicationInitializer 类型的对象，然后依次调用它们的 onStartup(ServletContext) 方法

通过打断点你会发现，有一个 DemoApplication 就是我们的启动类

这也就是为什么如果你的 Spring Boot 应用需要打成 war 包放入外部 Tomcat 容器运行的时候，你的启动类需要继承 SpringBootServletInitializer 这个抽象类，因为这个抽象类实现类 WebApplicationInitializer 接口，我们只需要继承它即可

SpringBootServletInitializer

org.springframework.boot.web.servlet.support.SpringBootServletInitializer 抽象类，实现了 WebApplicationInitializer 接口，目的就是支持你将 Spring Boot 应用打包成 war 包放入外部的 Servlet 容器中运行

在 onStartup(ServletContext) 方法中就两步：

1. 调用 createRootApplicationContext(ServletContext) 方法，创建一个 WebApplicationContext 作为 Root Spring 应用上下文
2. 添加一个 ContextLoaderListener 监听器，会监听到 ServletContext 的启动事件，因为 Spring 应用上下文在上面第 1 步已经准备好了，所以这里什么都不用做

第 1 步是不是和 Spring MVC 类似，同样创建一个 Root WebApplicationContext 作为 Spring 应用上下文的父对象

createRootApplicationContext 方法

createRootApplicationContext(ServletContext) 方法，创建一个 Root WebApplicationContext 对象，如下：

过程如下：

1. 创建一个 SpringApplication 构造器，目的就是启动 Spring 应用咯

1. 设置 mainApplicationClass，也就是你的启动类，主要用于打印日志
2. 从 ServletContext 上下文中获取最顶部的 Root ApplicationContext 应用上下文 parent，通常这里没有父对象，所以为空
3. 如果 parent 不为空，则先 ServletContext 中的该属性置空，因为这里会创建一个 ApplicationContext 作为 Root添加一个 ApplicationContextInitializer 初始器，用于设置现在要创建的 Root ApplicationContext 应用上下文的父容器为 parent
4. 添加一个 ApplicationContextInitializer 初始器，目的是往 ServletContext 上下文中设置 Root ApplicationContext 为现在要创建的 Root ApplicationContext 应用上下文，并将这个 ServletContext 保存至 ApplicationContext 中注意，这个对象很关键，会将当前 ServletContext 上下文对象设置到 ApplicationContext 对象里面，那么后续就不会再创建 Spring Boot 内嵌的 Tomcat 了
5. 设置要创建的 Root ApplicationContext 应用上下文的类型（Servlet）
6. 对 SpringApplicationBuilder 进行扩展，调用 configure(SpringApplicationBuilder) 方法，这也就是为什么我们的启动类可以重写该方法，通常不用做什么
7. 添加一个 ApplicationListener 监听器，用于将 ServletContext 中的相关属性关联到 Environment 环境中
8. 构建一个 SpringApplication 对象 application，用于启动 Spring 应用
9. 如果没有设置 source 源对象，那么这里尝试设置为当前 Class 对象，需要有 @Configuration 注解
10. 因为 SpringApplication 在创建 ApplicationContext 应用上下文的过程中需要优先注册 source 源对象，如果为空则抛出异常
11. 添加一个错误页面 Filter 作为 sources
12. 调用 application 的 run 方法启动整个 Spring Boot 应用

整个过程不复杂，SpringApplication 相关的内容在前面的 《SpringApplication 启动类的启动过程》文章中已经分析过，这里的关键在于第 5 步

添加的 ServletContextApplicationContextInitializer 会将当前 ServletContext 上下文对象设置到 ApplicationContext 对象里面

ServletContextApplicationContextInitializer

可以看到会将这个 ServletContext 上下文对象设置到 ApplicationContext 中

那么我们回顾到上一篇 《Spring Boot 内嵌 Tomcat 容器的实现》 文章的 1. onRefresh 方法小节调用的 createWebServer() 方法，如下：

我们看到上面第 4 步，如果从当前 Spring 应用上下文获取到了 ServletContext 对象，不会走上面的第 3 步，也就是不创建 Spring Boot 内嵌的 Tomcat

主动调用它的 getSelfInitializer() 方法来往这个 ServletContext 对象中注册各种 Servlet、Filter 和 EventListener 对象，包括 Spring MVC 中的 DispatcherServlet 对象，该方法参考上一篇 《Spring Boot 内嵌 Tomcat 容器的实现》 文章的 2. selfInitialize 方法 小节

总结

本文分析了 Spring Boot 应用被打成 war 包后是如何支持放入外部 Tomcat 容器运行的，原理也比较简单，借助 Spring MVC 中的 SpringServletContainerInitializer 这个类，它实现了 Servlet 3.0 新增的 javax.servlet.ServletContainerInitializer 接口

1. 通过 Java 的 SPI 机制，在 META-INF/services/javax.servlet.ServletContainerInitializer 文件中写入 SpringServletContainerInitializer 这个类，那么在 Servlet 容器启动的时候会调用这个类的 onStartup(..) 方法，会找到 WebApplicationInitializer 类型的对象，并调用他们的 onStartup(ServletContext) 方法
2. 在我们的 Spring Boot 应用中，如果需要打成 war 包放入外部 Tomcat 容器运行，启动类则需要继承 SpringBootServletInitializer 抽象类，它实现了 WebApplicationInitializer 接口
3. 在 SpringBootServletInitializer 中会创建一个 WebApplicationContext 作为 Root Spring 应用上下文，同时会将 ServletContext 对象设置到 Spring 应用上下文中
4. 这样一来，因为已经存在 ServletContext 对象，那么不会再创建 Spring Boot 内嵌的 Tomcat 容器，而是对 ServletContext 进行一些初始化工作

好了，到这里关于 Spring Boot 启动 Spring 应用的整个主流程，包括内嵌 Tomcat 容器的实现，以及支持运行在外部 Servlet 容器的实现都分析完了

那么接下来，我们一起来看看 @SpringBootApplication 这个注解，也就是 @EnableAutoConfiguration 自动配置注解的实现原理

如果文章对你有帮助的话，就点赞支持一波吧，非常感谢！

如何获取Java学习资料？

转发分享此文，后台私信小编：“ 666 ”即可获取。（注：转发分享，感谢大家）