乐趣区

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

jiezi

问题

为什么开发 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 日志体系
退出移动版