寫在前面 在我初次接觸MongoDB的時候，是為了做一個監控系統和日誌分析系統。當時在用Java操作MongoDB數據里的數據的時候，都是在網上查找Demo示例然後完成的功能，相信大家也同樣的體會，網上大都是這種一個入門的小Demo，很少有深入講解的。功能調通後，自己琢磨效率方面的問題，便開始自己的 ...
寫在前面
在我初次接觸MongoDB的時候，是為了做一個監控系統和日誌分析系統。當時在用Java操作MongoDB數據里的數據的時候，都是在網上查找Demo示例然後完成的功能，相信大家也同樣的體會，網上大都是這種一個入門的小Demo，很少有深入講解的。功能調通後，自己琢磨效率方面的問題，便開始自己的瞎嘗試之路，然後在產品啟動階段初始化多個MongoClient對象，搞了一個類似於連接池一類的池子，完成之後打心眼裡覺得自己真是個小機靈鬼。 大概過了一年，為了系統地學習MongoDB的一些高級特性，在網上尋找Blog和Mooc無果後，我便把眼光落到了MongoDB提供的官方文檔上。從看文檔開始，我就覺得原來的認知太淺了。MongoDB Java Driver官方的文檔一開始就介紹MongoClient已經做好連接池一類的機制，而軟體開發人員只需要在創建對象階段設置好參數即可。 後來慢慢地越來越意識到，一個新的技術入門最好的方式就是從閱讀官方的文檔開始，而像Spring、MongoDB這類技術的官方文檔，入門、高級特性都寫得很詳細。用正確的方法做正確的事情。 關於Spring Boot的參考文檔翻譯，是因為後來的工作中開始大規模地用Spring Boot的技術，自己在學習的過程中，發現Spring Boot比較新的版本的參考文檔一般都只有英語的，一些社區在自發進行翻譯的文檔版本都不是最新的。在學習的過程中，正好把參考文檔的翻譯也整理出來，也算是一種歸檔。如有疑問，歡迎大家一起交流。
關於文檔內容，有幾點需要聲明下：
- 由於時間有限，文檔先初步先把Maven方式使用Spring Boot部分翻譯出來，Gradle方式和Spring CLI翻譯部分後續如果有需要會整理出來。
- 文檔是從Spring Boot官方文檔的第二部分開始的，因為第一部分只是提供了Spring Boot參考文檔的導覽。
- 關於翻譯的信、達、雅。我只能儘力做到“信”和“達”，“雅”確實因為能力不夠達不到。文檔有一些單詞的翻譯，在不能做到信的情況下，我會把英文參考文檔中的單詞或者原文貼出來，大家可以自行體會官方文檔想要表達的意圖。
開始
如果您是從Spring Boot或“Spring”開始的，請先閱讀本節。它回答了基本的“什麼”，如何”和“為什麼”問題。它包括對Spring Boot的介紹以及安裝說明。然後，我們將引導您構建第一個Spring Boot應用程式，併在討論過程中討論一些核心原理。
2.1 介紹Spring Boot
Spring Boot使創建可運行的獨立，生產級基於Spring的應用程式變得容易。我們對Spring平臺和第三方庫持固執己見[opinionated]的觀點，這樣您就可以以最小的麻煩[fuss]開始使用。大多數Spring Boot應用程式只需要很少的Spring配置。
您可以使用Spring Boot創建可以通過使用java -jar或更傳統的war部署啟動的Java應用程式。我們還提供了一個運行“spring腳本”的命令行工具。
我們的主要目標是：
- 為所有Spring開發提供根本上更快且可廣泛訪問的入門體驗。
- 開箱即用，但由於需求開始與預設值有所出入，因此很快就會擺脫困境。[Be opinionated out of the box but get out of the way quickly as requirements start to diverge from the defaults.]
- 提供一系列大型項目通用的非功能性功能（例如嵌入式伺服器，安全性，指標，運行狀況檢查和外部化配置）。
- 完全沒有代碼生成，也不需要XML配置。
2.2 系統要求
Spring Boot 2.2.2.RELEASE需要Java 8，並且與Java 13（包括）相容。 還需要Spring Framework 5.2.2.RELEASE或更高版本。
為以下構建工具提供了明確的構建支持：
2.2.1 Servlet容器
Spring Boot支持以下嵌入式Servlet容器：
2.3 安裝Spring Boot
Spring Boot可以與“經典” Java開發工具一起使用，也可以作為命令行工具安裝。 無論哪種方式，都需要Java SDK v1.8或更高版本。
在開始之前，您應該使用以下命令檢查當前的Java安裝版本：
$ java -veriosn
如果您不熟悉Java開發，或者想嘗試使用Spring Boot，則可能要先嘗試使用Spring Boot CLI（命令行界面）。 否則，請繼續閱讀“經典”安裝說明。
2.3.1 Java開發人員的安裝說明
您可以像使用任何標準Java庫一樣使用Spring Boot。 為此，請在類路徑中包含相應的spring-boot-*。jar文件。 Spring Boot不需要任何特殊的工具集成，因此您可以使用任何IDE或文本編輯器。而且，Spring Boot應用程式沒有什麼特別之處，因此您可以像運行其他Java程式一樣運行和調試Spring Boot應用程式。
儘管您可以複製Spring Boot jar，但是我們通常建議您使用支持依賴關係管理的構建工具（例如Maven或Gradle）。
Maven安裝
Spring Boot與Apache Maven 3.3或更高版本相容。如果尚未安裝Maven，則可以按照maven.apache.org中的說明進行操作。
在許多操作系統上，Maven可以與程式包管理器一起安裝。 如果使用OSX Homebrew，請嘗試brew install maven。 Ubuntu用戶可以運行sudo apt-get install maven。 具有Chocolatey的Windows用戶可以從提升的（管理員）提示符下運行choco install maven。
Spring Boot依賴項使用的groupId為org.springframework.boot。 通常，您的Maven POM文件是從spring-boot-starter-parent項目繼承的，並聲明對一個或多個“Starters”的依賴關係。Spring Boot還提供了一個可選的Maven插件來構建可執行jar。
以下清單顯示了一個典型的pom.xml文件：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>myproject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<!-- Inherit defaults from Spring Boot -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.2.RELEASE</version>
</parent>
<!-- Override inherited settings -->
<description/>
<developers>
<developer/>
</developers>
<licenses>
<license/>
</licenses>
<scm>
<url/>
</scm>
<url/>
<!-- Add typical dependencies for a web application -->
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<!-- Package as an executable jar -->
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
spring-boot-starter-parent是使用Spring Boot的一種好方法，但可能並非始終適合。 有時您可能需要從其他父POM繼承，或者您可能不喜歡我們的預設設置。在這些情況下，請參閱使用不帶父POM的Spring Boot以獲得使用導入範圍的替代解決方案。
Gradle安裝
2.3.2 安裝Spring Boot CLI
2.3.3 從較早版本的Spring Boot升級
2.4 開發您的第一個Spring Boot應用程式
本節介紹如何開發一個簡單的“Hello World” Web應用程式，該應用程式重點介紹Spring Boot的一些關鍵功能。 我們使用Maven來構建該項目，因為大多數IDE都支持它。
spring.io網站包含許多使用Spring Boot的“入門”指南。 如果您需要解決特定的問題，請首先檢查。 通過訪問start.spring.io並從依賴項搜索器中選擇“ Web”啟動器，可以簡化以下步驟。 這樣做會生成一個新的項目結構，以便您可以立即開始編碼。 查看Spring Initializr文檔以獲取更多詳細信息。
在開始之前，請打開終端並運行以下命令，以確保全裝了有效的Java和Maven版本：
$ java -version
java version "1.8.0_102"
Java(TM) SE Runtime Environment (build 1.8.0_102-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode)
$ mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-17T14:33:14-04:00)
Maven home: /usr/local/Cellar/maven/3.3.9/libexec
Java version: 1.8.0_102, vendor: Oracle Corporation
該示例需要在其自己的文件夾中創建。 隨後的說明假定您已經創建了一個合適的文件夾，並且它是當前目錄。
2.4.1 創建POM
我們需要先創建一個Maven pom.xml文件。 pom.xml是用於構建項目的配方[recipe]。打開您喜歡的文本編輯器並添加以下內容：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>myproject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.2.RELEASE</version>
</parent>
<description/>
<developers>
<developer/>
</developers>
<licenses>
<license/>
</licenses>
<scm>
<url/>
</scm>
<url/>
<!-- Additional lines to be added here... -->
</project>
上面的清單應為您提供有效的構建。您可以通過運行mvn package命令對其進行測試（目前，您可以忽略“jar will be empty - no content was marked for inclusion!”警告）。
此時，您可以將項目導入IDE（大多數現代Java IDE包括對Maven的內置支持）。為簡單起見，我們在此示例中繼續使用純文本編輯器。
2.4.2 添加類路徑依賴
Spring Boot提供了許多“啟動器”，使您可以將jar添加到類路徑中。我們的冒煙測試應用程式在POM的父部分中使用spring-boot-starter-parent。 spring-boot-starter-parent是一個特殊的啟動器，提供有用的Maven預設值。它還提供了一個依賴項管理部分，以便您可以省去最佳版本的依賴項的標簽。
其他“Starters”提供了在開發特定類型的應用程式時可能需要的依賴項。由於我們正在開發Web應用程式，因此我們添加了spring-boot-starter-web依賴項。在此之前，我們可以通過運行以下命令來查看當前的狀態：
$ mvn dependency:tree
[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT
mvn dependency:tree 命令顯示項目依賴關係的樹形表示。您可以看到spring-boot-starter-parent本身不提供任何依賴關係。要添加必要的依賴關係，請編輯pom.xml併在父部分的正下方添加spring-boot-starter-web依賴關係：
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
如果再次運行mvn dependency:tree，則會看到現在還有許多其他依賴項，包括Tomcat Web伺服器和Spring Boot本身。
2.4.3 編寫代碼
要完成我們的應用程式，我們需要創建一個Java文件。預設情況下，Maven從src/main/java編譯源代碼，因此您需要創建該文件夾結構，然後添加一個名為src/main/java/ Example.java的文件以包含以下代碼：
import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;
@RestController
@EnableAutoConfiguration
public class Example {
@RequestMapping("/")
String home() {
return "Hello World!";
}
public static void main(String[] args) {
SpringApplication.run(Example.class, args);
}
}
儘管這裡沒有太多代碼，但是代碼里正在發生很多事情。我們將在接下來的幾節中逐步介紹重要部分。
@RestController 和 @RequestMapping註解
Example類的第一個註釋是@RestController。這被稱為stereotype註解。它為人們閱讀代碼提供了提示，對於Spring來說，類扮演了特定角色。在這種情況下，我們的類是一個Web @Controller，因此Spring在處理傳入的Web請求時會考慮使用它。
@RestController 和 @RequestMapping 註解是Spring MVC註釋（它們不是Spring Boot專有的註解）。有關更多詳細信息，請參見Spring參考文檔中的MVC章節部分。
@EnableAutoConfiguration 註解
第二個類級別的註解是 @EnableAutoConfiguration。這個註解告訴Spring Boot根據所添加的jar依賴關係“猜測”您如何配置Spring。由於spring-boot-starter-web添加了Tomcat和Spring MVC，因此自動配置假定您正在開發Web應用程式並相應地設置Spring。
啟動器和自動配置
自動配置旨在與“啟動器”配合使用，但是這兩個概念並沒有直接聯繫在一起。您可以在啟動程式之外自由選擇jar依賴項。Spring Boot仍會盡其所能自動配置您的應用程式。
Main方法
我們應用程式的最後一部分是main方法。 這隻是遵循Java約定的應用程式入口點的標準方法。 我們的主要方法通過調用run委托給Spring Boot的SpringApplication類。 SpringApplication會引導我們的應用程式，並啟動Spring，後者反過來又會啟動自動配置的Tomcat Web伺服器。 我們需要將Example.class作為參數傳遞給run方法，以告訴SpringApplication哪個是主要的Spring組件。 args數組也通過傳遞以公開任何命令行參數。
2.4.4 運行示例
此時，您的應用程式應該可以工作了。 由於您使用了spring-boot-starter-parent父POM，因此您具有一個有用的運行目標，可以用來啟動該應用程式。 從根項目目錄輸入命令 mvn spring-boot:run 以啟動應用程式。 您應該看到類似於以下內容的輸出：
$ mvn spring-boot:run
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.2.2.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.222 seconds (JVM running for 6.514)
如果打開Web瀏覽器到localhost:8080，則應該看到以下輸出：
Hello World!
要正常退出該應用程式，請按ctrl-c。
2.4.5 構建可執行Jar
通過構建可以在生產環境中運行的完全獨立的可執行jar文件來結束本節示例。可執行jar（有時稱為“fat jar”）是包含您的已編譯類以及代碼需要運行的所有jar依賴項的歸檔文件。
可執行jar和Java
Java沒有提供載入嵌套jar文件（jar中本身包含的jar文件）的標準方法。如果您要分發獨立的應用程式，則可能會出現問題。 為瞭解決這個問題，許多開發人員使用“超級[uber]”容器。 超級[uber] jar將來自應用程式所有依賴項的所有類打包到一個存檔中。這種方法的問題在於，很難查看應用程式中包含哪些庫。如果在多個jar中使用相同的文件名（但具有不同的內容），也可能會產生問題。
Spring Boot採用了另一種方法，實際上允許您直接嵌套jar。
要創建可執行jar，我們需要將spring-boot-maven-plugin添加到我們的pom.xml中。 為此，請在 dependencies 部分的下麵插入以下行：
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
spring-boot-starter-parent的POM包含配置以綁定重新打包目標。 如果不使用父POM，則需要自己聲明此配置。 有關詳細信息，請參見插件文檔。
保存您的pom.xml並從命令行運行mvn軟體包，如下所示：
$ mvn package
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building myproject 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] .... ..
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ myproject ---
[INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.2.2.RELEASE:repackage (default) @ myproject ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
如果查看target目錄，則應該看到 myproject-0.0.1-SNAPSHOT.jar 包。該文件的大小應為10 MB左右。如果想看到內部結構，可以使用jar tvf命令，如下所示：
$ jar tvf target/myproject-0.0.1-SNAPSHOT.jar
您還將在目標目錄中看到一個名為myproject-0.0.1-SNAPSHOT.jar.original的文件大小比較小文件。這是Maven在Spring Boot重新打包之前創建的原始jar文件。
要運行該應用程式，請使用java -jar命令，如下所示：
$ java -jar target/myproject-0.0.1-SNAPSHOT.jar
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.2.2.RELEASE)
....... . . .
....... . . . (log output here)
....... . . .
........ Started Example in 2.536 seconds (JVM running for 2.864)
和以前一樣，要退出該應用程式，請按ctrl-c。
第二章節結束。
後續其他章節和Java相關知識和資料會在公眾號同步更新，關註下咯~
