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從入門到精通