Spring Boot之快速入門

簡介

在您第1次接觸和學習Spring框架的時候，是否因爲其繁雜的配置而退卻了？在你第n次使用Spring框架的時候，是否覺得一堆反覆黏貼的配置有一些厭煩？那麼您就不妨來試試使用Spring Boot來讓你更易上手，更簡單快捷地構建Spring應用！

Spring Boot讓我們的Spring應用變的更輕量化。我們不必像以前那樣繁瑣的構建項目、打包應用、部署到Tomcat等應用服務器中來運行我們的業務服務。通過Spring Boot實現的服務，只需要依靠一個Java類，把它打包成jar，並通過java -jar命令就可以運行起來。這一切相較於傳統Spring應用來說，已經變得非常的輕便、簡單。

總結一下Spring Boot的主要優點：

• 爲所有Spring開發者更快的入門
• 開箱即用，提供各種默認配置來簡化項目配置
• 內嵌式容器簡化Web項目
• 沒有冗餘代碼生成和XML配置的要求

快速入門

本文我們將學習如何快速的創建一個Spring Boot應用，並且實現一個簡單的Http請求處理。通過這個例子對Spring Boot有一個初步的瞭解，並體驗其結構簡單、開發快速的特性。

創建基礎項目

Spring官方提供了非常方便的工具Spring Initializr來幫助我們創建Spring Boot應用。

使用Spring Initializr頁面創建

第一步：訪問Spring Initializr：https://start.spring.io/

upload successful

如圖所示，幾個選項說明：

• Project：使用什麼構建工具，Maven還是Gradle；本教程將採用大部分Java人員都熟悉的Maven，以方便更多讀者入門學習。
• Language：使用什麼編程語言，Java、Kotlin還是Groovy；本教程將採用Java爲主編寫，以方便更多讀者入門學習。
• Spring Boot：選用的Spring Boot版本；這裏將使用當前最新的2.1.3版本。
• Project Metadata：項目的元數據；其實就是Maven項目的基本元素，點開More options可以看到更多設置，根據自己組織的情況輸入相關數據，比如：
  
• Dependencies：選擇要加入的Spring Boot組件；本文將實現一個Http接口，所以可以選擇Web組件，只需要輸入Web，頁面會自動聯想顯示匹配的可選組件：
  
  點擊”+“之後，就如下圖所示：
  

第二步：點擊”Generate Project“按鈕生成項目；此時瀏覽器會下載一個與上面Artifact名稱一樣的壓縮包。

第三步：解壓項目包，並用編譯器以Maven項目導入，以IntelliJ IDEA爲例：

• 菜單中選擇：File –> New –> Project from Existing Sources…
  upload successful
• 選擇解壓後的項目文件夾，點擊OK
• 點擊：Import project from external model，並選擇Maven，點擊Next到底爲止。
• 若你的環境有多個版本的JDK，注意到選擇Java SDK的時候請選擇Java 8（具體根據你在第一步中選擇的Java版本爲準）

由於我們後續會有很多樣例工程，您也可以像我們樣例倉庫那樣，用一個基礎倉庫，每篇文章的樣例以模塊的方式保存，具體形式可見文末的案例倉庫。

使用IntelliJ IDEA創建

如果是使用IntelliJ IDEA來寫Java程序的話，那麼還可以直接在編譯器中創建Spring Boot應用。

第一步：菜單欄中選擇：File => New => Project..，我們可以看到如下圖所示的創建功能窗口。

其中Initial Service Url指向的地址就是Spring官方提供的Spring Initializr工具地址，所以這裏創建的工程實際上也是基於它的Web工具來實現的。

第二步：點擊Next，等待片刻後，我們可以看到如下圖所示的工程信息窗口：

其實內容就跟我們用Web版的Spring Initializr是一模一樣的，跟之前在頁面上一樣填寫即可。

第三步：繼續點擊Next，進入選擇Spring Boot版本和依賴管理的窗口：

在這裏值的我們關注的是，它不僅包含了Spring Boot Starter POMs中的各個依賴，還包含了Spring Cloud的各種依賴。

第四步：點擊Next，進入最後關於工程物理存儲的一些細節。最後，點擊Finish就能完成工程的構建了。

Intellij中的Spring Initializr雖然還是基於官方Web實現，但是通過工具來進行調用並直接將結果構建到我們的本地文件系統中，讓整個構建流程變得更加順暢，還沒有體驗過此功能的Spring Boot/Cloud愛好者們不妨可以嘗試一下這種不同的構建方式。

項目結構解析

upload successful

通過上面步驟完成了基礎項目的創建。如上圖所示，Spring Boot的基礎結構共三個文件（具體路徑根據用戶生成項目時填寫的Group所有差異）：

• src/main/java下的程序入口：Chapter11Application
• src/main/resources下的配置文件：application.properties
• src/test/下的測試入口：Chapter11ApplicationTests

生成的Chapter11Application和Chapter11ApplicationTests類都可以直接運行來啓動當前創建的項目，由於目前該項目未配合任何數據訪問或Web模塊，程序會在加載完Spring之後結束運行。

項目依賴解析

打開pom.xml，一起來看看Spring Boot項目的依賴：

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.didispace</groupId>
    <artifactId>chapter1-1</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>chapter1-1</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

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

如上所示，主要有四個部分：

• 項目元數據：創建時候輸入的Project Metadata部分，也就是Maven項目的基本元素，包括：groupId、artifactId、version、name、description等
• parent：繼承spring-boot-starter-parent的依賴管理，控制版本與打包等內容
• dependencies：項目具體依賴，這裏包含了spring-boot-starter-web用於實現HTTP接口（該依賴中包含了Spring MVC）；spring-boot-starter-test用於編寫單元測試的依賴包。更多功能模塊的使用我們將在後面的教程中逐步展開。
• build：構建配置部分。默認使用了spring-boot-maven-plugin，配合spring-boot-starter-parent就可以把Spring Boot應用打包成JAR來直接運行。

編寫一個HTTP接口

• 創建package命名爲com.didispace.web（根據實際情況修改）
• 創建HelloController類，內容如下：

@RestController
public class HelloController {

    @RequestMapping("/hello")
    public String index() {
        return "Hello World";
    }

}

• 啓動主程序，使用PostMan等工具發起請求：http://localhost:8080/hello，可以看到頁面返回：Hello World

編寫單元測試用例

打開的src/test/下的測試入口Chapter11ApplicationTests類。下面編寫一個簡單的單元測試來模擬http請求，具體如下：

import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;


@RunWith(SpringRunner.class)
@SpringBootTest
public class Chapter11ApplicationTests {

    private MockMvc mvc;

    @Before
    public void setUp() throws Exception {
        mvc = MockMvcBuilders.standaloneSetup(new HelloController()).build();
    }

    @Test
    public void getHello() throws Exception {
        mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("Hello World")));
    }

}

使用MockServletContext來構建一個空的WebApplicationContext，這樣我們創建的HelloController就可以在@Before函數中創建並傳遞到MockMvcBuilders.standaloneSetup()函數中。

注意引入下面內容，讓status、content、equalTo函數可用

import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

至此已完成目標，通過Maven構建了一個空白Spring Boot項目，再通過引入web模塊實現了一個簡單的請求處理。

代碼示例

本文的相關例子可以查看下面倉庫中的chapter1-1目錄：

• Github：https://github.com/dyc87112/SpringBoot-Learning/
• Gitee：https://gitee.com/didispace/SpringBoot-Learning/