【源码解析】凭什么？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-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 领域知识的 深入学习 ，从源码到原理，系统有序的学习）