共计 4716 个字符,预计需要花费 12 分钟才能阅读完成。
问题
为什么开发 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 日志体系