【源碼解析】憑什么？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 領域知識的深入學習，從源碼到原理，系統有序的學習）