Spring Boot 2.x基礎教程：快速入門

簡介

在您第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/

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

• 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...

  

• 選擇解壓後的項目檔案夾，點選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愛好者們不妨可以嘗試一下這種不同的建構方式。

項目結構解析

通過上面步驟完成了基礎項目的建立。如上圖所示，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/tree/2.x
• Gitee： https://gitee.com/didispace/SpringBoot-Learning/tree/2.x

如果您覺得本文不錯，歡迎Star支援，您的關注是我堅持的動力！

專欄推薦

• Spring Boot從入門到精通
• Spring Cloud從入門到精通