Spring Boot 2.2.2.RELEASE 版本中文參考文檔【3.1】

使用Spring Boot 本節將詳細介紹如何使用Spring Boot。它涵蓋了諸如構建系統，自動配置以及如何運行應用程式之類的主題。我們還將介紹一些Spring Boot最佳實踐。儘管Spring Boot並沒有什麼特別的地方（它只是另一個可以使用的庫），但是有一些建議可以使您的開發過程更輕鬆一 ...

使用Spring Boot

本節將詳細介紹如何使用Spring Boot。它涵蓋了諸如構建系統，自動配置以及如何運行應用程式之類的主題。我們還將介紹一些Spring Boot最佳實踐。儘管Spring Boot並沒有什麼特別的地方（它只是另一個可以使用的庫），但是有一些建議可以使您的開發過程更輕鬆一些。

如果您是從Spring Boot開始的，那麼在進入本節之前，您可能應該閱讀入門指南。

3.1 構建系統

強烈建議您選擇一個支持依賴關係管理並且可以使用發佈到“Maven Central”存儲庫的artifacts的構建系統。我們建議您選擇Maven或Gradle。可以使Spring Boot與其他構建系統（例如Ant）一起使用，但是它們並沒有得到很好的支持。

3.1.1 依賴管理

每個Spring Boot版本都提供了它所支持的依賴關係的精選列表。實際上，您不需要為構建配置中的所有這些依賴項提供版本，因為Spring Boot會為您管理該版本。當您升級Spring Boot本身時，這些依賴項也會以一致的方式升級。

Tips: 您仍然可以指定版本，併在需要時覆蓋Spring Boot的建議。

精選列表包含可與Spring Boot一起使用的所有spring模塊以及完善的第三方庫列表。該列表作為可與Maven和Gradle一起使用的標準物料清單（spring-boot-dependencies）提供。

Warning: Spring Boot的每個發行版都與Spring Framework的基本版本相關聯。強烈建議您不要指定其版本。

3.1.2 Maven

Maven用戶可以從spring-boot-starter-parent項目繼承來獲得合理的預設值。父項目提供以下功能： Java 1.8是預設的編譯級別。 UTF-8源編碼。從spring-boot-dependencies pom繼承的依賴管理部分，它管理公共依賴項的版本。當在自己的pom中使用這些依賴關係時，可以為這些依賴關係省略\<version>標記。具有重新打包執行ID的重新打包目標的執行。[An execution of the repackage goal with a repackage execution id.] 合理的資源過濾。 合理的插件配置（exec plugin，Git commit ID和shade）。 * 對application.properties和application.yml進行合理的資源過濾，包括profile-specific的文件（例如application-dev.properties和application-dev.yml）

請註意，由於application.properties和application.yml文件接受Spring樣式的占位符（${…}），因此Maven過濾已更改為使用@ .. @占位符。（您可以通過設置一個名為resource.delimiter的Maven屬性來覆蓋它。）

繼承父Starter

要將項目配置為從spring-boot-starter-parent繼承，請設置pom文件的parent，如下所示：

1 <!-- Inherit defaults from Spring Boot -->
2 <parent>
3     <groupId>org.springframework.boot</groupId>
4     <artifactId>spring-boot-starter-parent</artifactId>
5     <version>2.2.2.RELEASE</version>
6 </parent>

Note: 您只需要為此依賴項指定Spring Boot版本號。如果導入其他啟動器，則可以安全地省略版本號。

使用該設置，您還可以通過覆蓋自己項目中的屬性來覆蓋各個依賴項。例如，要升級到另一個Spring Data發佈系列，可以將以下內容添加到pom.xml中：

1 <!-- Inherit defaults from Spring Boot -->
2 <properties>
3     <spring-data-releasetrain.version>Fowler-SR2</spring-data-releasetrain.version>
4 </properties>

Tip: 查看spring-boot-dependencies pom以獲取受支持屬性的列表。

在沒有父POM的情況下使用Spring Boot

並非每個人都喜歡從spring-boot-starter-parent父POM繼承。您可能需要使用自己的公司標準父級，或者可能希望顯式聲明所有Maven配置。

如果您不想使用spring-boot-starter-parent，仍然可以通過使用scope = import依賴項來保留依賴項管理（而不是插件管理）的好處，如下所示：

 1 <dependencyManagement>
 2     <dependencies>
 3         <dependency>
 4             <!-- Import dependency management from Spring Boot -->
 5             <groupId>org.springframework.boot</groupId>
 6             <artifactId>spring-boot-dependencies</artifactId>
 7             <version>2.2.2.RELEASE</version>
 8             <type>pom</type>
 9             <scope>import</scope>
10         </dependency>
11     </dependencies>
12 </dependencyManagement>

如上所述，前面的示例設置不允許您使用屬性來覆蓋各個依賴項。為了獲得相同的結果，需要在spring-boot-dependencies條目之前的項目的dependencyManagement中添加一個條目。例如，要升級到另一個Spring Data發佈系列，可以將以下元素添加到pom.xml中：

 1 <dependencyManagement>
 2     <dependencies>
 3         <!-- Override Spring Data release train provided by Spring Boot -->
 4         <dependency>
 5             <groupId>org.springframework.data</groupId>
 6             <artifactId>spring-data-releasetrain</artifactId>
 7             <version>Fowler-SR2</version>
 8             <type>pom</type>
 9             <scope>import</scope>
10         </dependency>
11         <dependency>
12             <groupId>org.springframework.boot</groupId>
13             <artifactId>spring-boot-dependencies</artifactId>
14             <version>2.2.2.RELEASE</version>
15             <type>pom</type>
16             <scope>import</scope>
17         </dependency>
18     </dependencies>
19 </dependencyManagement>

Note: 在前面的示例中，我們指定了BOM，但是可以以相同方式覆蓋任何依賴項類型。

使用Spring Boot Maven插件

Spring Boot包含一個可以將項目打包為可執行jar的Maven插件。如果要使用插件，請將其添加到您的\<plugins>部分，如以下示例所示：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

Note: 如果您使用了spring-boot-starter-parent，則只需添加該插件。除非您要更改父級中定義的設置，否則無需對其進行配置。

3.1.3 Gradle

3.1.4 Ant

3.1.5 啟動器[Starters]

Starters是一系列便捷的，可以包含在你應用中的依賴項描述符[dependency descriptors]。您可以一站式獲取所需的所有Spring和相關技術，從而省去遍歷示例代碼和遍歷依賴描述符的負擔。例如，如果要開始使用Spring和JPA進行資料庫訪問，在項目中包括spring-boot-starter-data-jpa依賴項即可。

入門程式包含許多啟動項目並快速運行所需的依賴項，並且支持依賴傳遞。

關於名字叫什麼

官方startter都遵循類似的命名方式：spring-boot-starter-*，其中 * 是特定類型的應用程式[application]。這種命名結構在您需要尋找starter時提供了便利。許多IDE中的Maven集成使您可以按名稱搜索依賴項。例如，在安裝了適當的Eclipse或STS插件的情況下，您可以在POM編輯器中按ctrl-space並鍵入“spring-boot-starter”以獲取完整列表。

如“創建自己的Stater”部分中所述，第三方starter的命名不建議以spring-boot開頭，因為它是為Spring Boot官方artifactId保留的。而是，第三方啟動程式通常以項目名稱開頭。例如，一個名為thirdpartyproject的第三方啟動程式項目通常會被命名為thirdpartyproject-spring-boot-starter。

Spring Boot在org.springframework.boot組下提供了以下應用程式的starters：

Table 1. Spring Boot application starters