乐趣区

源码解析凭什么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-contextspring-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 日志体系
退出移动版