【源碼解析】憑什麼？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日誌體系