【源码解析】凭什么？spring boot 一个 jar 就能开发 web 项目

问题

为什么开发web项目，spring-boot-starter-web 一个jar就搞定了？这个jar做了什么？

通过 spring-boot 工程可以看到所有开箱即用的的引导模块 spring-boot-starter-xxx 都在 spring-boot-starters 子模块中，且所有的 spring-boot-starter-xxx 模块中都没有代码，都是在其他包中就完成对应的功能。首先，分析其依赖

依赖

注意：图中的 jakarta.xxxx 包是原来的 javax.xxxx 包，java ee 改名为 jakarta ee 了，spring-boot-starter-web-2.1.8.release 版本是直接依赖于hibernate-validator，spring-boot-2.2.0 版本开始使用的是 jakarta，并用一个新模块 spring-boot-starter-validation 来管理

从依赖图中可以看到，最核心的 spring-boot 依赖于 spring-context 和 spring-core ，因此，正如官方所说，spring-boot 是基于 spring 的。

spring boot可以轻松地创建可运行的、独立的、生产级的基于spring的应用程序。我们对spring平台和第三方库有自己的见解，这样您就可以从最少的麻烦开始了。大多数spring引导应用程序只需要很少的spring配置。
可以使用 spring boot 创建java应用程序，java应用程序可以通过使用 java -jar 或更传统的war 来部署。我们还提供了一个运行“spring脚本”的命令行工具。

我们首要的目标是：

• 为所有spring开发提供一个更快、更容易获得的入门体验。
• 开箱即用，但要在需求开始偏离默认值时迅速改变。
• 提供一系列对大型项目通用的非功能性特性（如嵌入式服务器、安全性、流量、运行状况检查和外部化配置）。
• 绝对不需要代码生成，也不需要xml配置。

【spring-boot 源码解析】spring-boot 依赖管理

【spring-boot 源码解析】spring-boot 依赖管理梳理图

spring-boot-starter（重要）

此模块是所有 spring-boot-starter-xxxx 引导器核心，非常重要！！！

包含以下模块：

<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot</artifactid>
</dependency>
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-autoconfigure</artifactid>
</dependency>
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-logging</artifactid>
</dependency>
<dependency>
    <groupid>javax.annotation</groupid>
    <artifactid>javax.annotation-api</artifactid>
</dependency>
<dependency>
    <groupid>org.springframework</groupid>
    <artifactid>spring-core</artifactid>
</dependency>
<dependency>
    <groupid>org.yaml</groupid>
    <artifactid>snakeyaml</artifactid>
    <scope>runtime</scope>
</dependency>

spring-boot

spring-boot 内核，spring-boot 特性功能都是在此包实现。

spring-boot-autoconfigure

spring-boot 自动配置，提供一些常用包的默认配置

【源码解析】自动配置的这些细节不知道，别说你会 spring-boot

spring-boot-starter-logging

spring-boot 默认日志引导器

<dependency>
    <groupid>ch.qos.logback</groupid>
    <artifactid>logback-classic</artifactid>
</dependency>
<dependency>
    <groupid>org.apache.logging.log4j</groupid>
    <artifactid>log4j-to-slf4j</artifactid>
</dependency>
<dependency>
    <groupid>org.slf4j</groupid>
    <artifactid>jul-to-slf4j</artifactid>
</dependency>

什么都没做，就引入了几个依赖，那引入这几个依赖解决了什么问题呢？
通过引入这几个依赖，直接或间接的引入了 slf4j、logback日志框架所需jar，以及 log4j、jul日志工具对 slf4j的适配。
因此，引入了这个jar，工程中的日志实现使用 logback。
嗯？那 log4j2 呢？
原来如果想用 log4j2，还有一个 spring-boot-starter-log4j2 包供我们选择。

日志的具体配置，建议还是用原本的 xml 配置，用 yaml 或 properties 不好配置。
如：logback 使用根目录下的 logback-spring.xml 配置。

snakeyaml

支持yaml语法的生成与解析工具包

snakeyaml快速入门

spring-boot-starter-tomcat

没有做任何处理，直接使用嵌入式 tomcat 相关jar。spring 项目由外部 tomcat 调用 spring框架，而 spring-boot 是由 框架内部去调用嵌入式 tomcat，主被动关系发生了转化。

<!-- 相当于去掉的tomcat-annotations-api -->
<dependency>
    <groupid>javax.annotation</groupid>
    <artifactid>javax.annotation-api</artifactid>
</dependency>
<dependency>
    <groupid>org.apache.tomcat.embed</groupid>
    <artifactid>tomcat-embed-core</artifactid>
    <exclusions>
        <exclusion>
            <groupid>org.apache.tomcat</groupid>
            <artifactid>tomcat-annotations-api</artifactid>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupid>org.apache.tomcat.embed</groupid>
    <artifactid>tomcat-embed-el</artifactid>
</dependency>
<dependency>
    <groupid>org.apache.tomcat.embed</groupid>
    <artifactid>tomcat-embed-websocket</artifactid>
</dependency>

spring-boot-starter-json

没有做任何处理，使用 jackson 作为默认json工具

<dependency>
   <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter</artifactid>
</dependency>
<dependency>
    <groupid>org.springframework</groupid>
    <artifactid>spring-web</artifactid>
</dependency>
<dependency>
    <groupid>com.fasterxml.jackson.core</groupid>
    <artifactid>jackson-databind</artifactid>
</dependency>
<dependency>
    <groupid>com.fasterxml.jackson.datatype</groupid>
    <artifactid>jackson-datatype-jdk8</artifactid>
</dependency>
<dependency>
    <groupid>com.fasterxml.jackson.datatype</groupid>
    <artifactid>jackson-datatype-jsr310</artifactid>
</dependency>
<dependency>
    <groupid>com.fasterxml.jackson.module</groupid>
    <artifactid>jackson-module-parameter-names</artifactid>
</dependency>

spring-boot-starter-validation

2.1.8.release 版本直接依赖于 hibernate-validator，没有此模块

2.2.0 版本依赖于 jakarta.validation-api 和 hibernate-validator，并去掉了 hibernate-validator中的 javax.validation-api。

两者在使用的时候没有任何区别，是无感切换的。

validator 自动化校验

<!-- 2.2.0.m6 -->

<!-- 相当于去掉的javax validation-api -->
<dependency>
    <groupid>jakarta.validation</groupid>
    <artifactid>jakarta.validation-api</artifactid>
</dependency>
<dependency>
    <groupid>org.apache.tomcat.embed</groupid>
    <artifactid>tomcat-embed-el</artifactid>
</dependency>

<dependency>
    <groupid>org.hibernate.validator</groupid>
    <artifactid>hibernate-validator</artifactid>
    <exclusions>
        <exclusion>
            <groupid>javax.validation</groupid>
            <artifactid>validation-api</artifactid>
        </exclusion>
    </exclusions>
</dependency>

参考资料

• spring-boot-2.1.8 源码
• 【spring-boot 源码解析】spring-boot 依赖管理
• 【spring-boot 源码解析】spring-boot 依赖管理梳理图
• validator 自动化校验
• 【源码解析】自动配置的这些细节不知道，别说你会 spring-boot
• 架构师必备，带你弄清混乱的java日志体系
  公众号：逸飞兮（专注于 java 领域知识的深入学习，从源码到原理，系统有序的学习）