Spring Boot乾貨系列：（一）優雅的入門篇 | 掘金技術徵文

嘟嘟MD發表於2017-04-14

原本地址：Spring Boot乾貨系列：（一）優雅的入門篇
部落格地址：tengj.top/

前言

Spring一直是很火的一個開源框架，在過去的一段時間裡，Spring Boot在社群中熱度一直很高，所以決定花時間來了解和學習，為自己做技術儲備。

正文

首先宣告，Spring Boot不是一門新技術，所以不用緊張。從本質上來說，Spring Boot就是Spring,它做了那些沒有它你也會去做的Spring Bean配置。它使用“習慣優於配置”（專案中存在大量的配置，此外還內建了一個習慣性的配置，讓你無需手動進行配置）的理念讓你的專案快速執行起來。使用Spring Boot很容易建立一個獨立執行（執行jar,內嵌Servlet容器）、準生產級別的基於Spring框架的專案，使用Spring Boot你可以不用或者只需要很少的Spring配置。

Spring Boot精要

Spring將很多魔法帶入了Spring應用程式的開發之中，其中最重要的是以下四個核心。

自動配置：針對很多Spring應用程式常見的應用功能，Spring Boot能自動提供相關配置
起步依賴：告訴Spring Boot需要什麼功能，它就能引入需要的庫。
命令列介面：這是Spring Boot的可選特性，藉此你只需寫程式碼就能完成完整的應用程式，無需傳統專案構建。
Actuator：讓你能夠深入執行中的Spring Boot應用程式，一套究竟。

詳細的我們就不展開，等你愛上後自然會去深入的瞭解，後續章節我們會一一展開介紹。接下來讓我們開搞吧。我已經迫不及待的要嚐嚐Spring Boot的味道了。

系統要求

目前Spring Boot正式版為1.5.1.RELEASE預設情況下，Spring Boot 1.5.1.RELEASE需要Java 7和Spring Framework 4.3.6.RELEASE或更高版本,你也可以使用Spring Boot with Java 6和一些額外的配置（不建議）,使用Maven（3.2+）或Gradle 2（2.9或更高版本）和3來構建。

雖然你可以使用Java 6或7的Spring Boot，但我們通常推薦Java 8。

所以本部落格系列統一使用Java 1.8，Spring Boot 1.5.1.RELEASE以及Maven3.3.9版本。開發工具使用IDEA（強烈推薦，可以看我另外一篇介紹IDEA入門文章，內有官方中文教程:Java人員正確使用 IntelliJ IDEA的方式）

光速入門-開發一個web服務

沒有比較就沒有傷害，讓我們先看看傳統Spring MVC開發一個簡單的Hello World Web應用程式，你應該做什麼，我能想到一些基本的需求。

一個專案結構，其中有一個包含必要依賴的Maven或者Gradle構建檔案，最起碼要有Spring MVC和Servlet API這些依賴。
一個web.xml檔案（或者一個WebApplicationInitializer實現），其中宣告瞭Spring的DispatcherServlet。
一個啟動了Spring MVC的Spring配置
一控制器類，以“hello World”相應HTTP請求。
一個用於部署應用程式的Web應用伺服器，比如Tomcat。

最讓人難以接受的是，這份清單裡面只有一個東西是和Hello World功能相關的，即控制器，剩下的都是Spring開發的Web應用程式必需的通用模板。

接下來看看Spring Boot如何搞定？
很簡單，我僅僅只需要非常少的幾個配置就可以迅速方便的搭建起來一套web專案

初始化Spring Boot專案

構建一個Sping Boot的Maven專案，強烈推薦Spring Initializr,它從本質上來說就是一個Web應用程式，它能為你生成Spring Boot專案結構。
Spring Initializr有幾種用法：

通過Web介面使用
1. 訪問：http://start.spring.io/
2. 選擇構建工具Maven Project、Spring Boot版本1.5.1以及一些工程基本資訊，可參考下圖所示
3. 點選Generate Project下載專案壓縮包
4. 匯入到你的工程，如果是IDEA，則需要：
  a.選單中選擇File–>New–>Project from Existing Sources...
  b.選擇解壓後的專案資料夾，點選OK
  c.點選Import project from external model並選擇Maven，點選Next到底為止。
  d.若你的環境有多個版本的JDK，注意到選擇Java SDK的時候請選擇Java 7以上的版本
通過IntelliJ IDEA使用(個人推薦)
IntelliJ IDEA是非常流行的IDE，IntelliJ IDEA 14.1已經支援Spring Boot了。
建立Spring Boot操作步驟如下：
在File選單裡面選擇 New > Project,然後選擇Spring Initializr，接著如下圖一步步操作即可。

專案結構

根據上面的操作已經初始化了一個Spring Boot的框架了，專案結構如下：

如你所見，專案裡面基本沒有程式碼，除了幾個空目錄外，還包含如下幾樣東西。

pom.xml：Maven構建說明檔案。
Chapter1Application.java：一個帶有main()方法的類，用於啟動應用程式（關鍵）。
Chapter1ApplicationTests.java：一個空的Junit測試類，它載入了一個使用Spring Boot字典配置功能的Spring應用程式上下文。
application.properties：一個空的properties檔案，你可以根據需要新增配置屬性。

解析pom.xml

大家跟我一起移步pom.xml,看看Spring Boot的跟普通Spring MVC工程的Maven配置有啥不一樣

<?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>

    <groupId>com.dudu</groupId>
    <artifactId>chapter1</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>chapter1</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <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>複製程式碼

可以看出，有幾個配置是不大一樣的,我們挑幾個重要的說說，要是客觀不想過早的瞭解這些，自行跳過這一知識點即可。

Spring Boot父級依賴

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>複製程式碼

這塊配置就是Spring Boot父級依賴，有了這個，當前的專案就是Spring Boot專案了，spring-boot-starter-parent是一個特殊的starter,它用來提供相關的Maven預設依賴，使用它之後，常用的包依賴可以省去version標籤。關於Spring Boot提供了哪些jar包的依賴，可檢視C:\Users\使用者.m2\repository\org\springframework\boot\spring-boot-dependencies\1.5.1.RELEASE\spring-boot-dependencies-1.5.1.RELEASE.pom
這裡我就貼一點點意思意思，如下：

<properties>
        <!-- Dependency versions -->
        <activemq.version>5.14.3</activemq.version>
        <antlr2.version>2.7.7</antlr2.version>
        <appengine-sdk.version>1.9.48</appengine-sdk.version>
        <artemis.version>1.5.2</artemis.version>
        <aspectj.version>1.8.9</aspectj.version>
        <assertj.version>2.6.0</assertj.version>
        <atomikos.version>3.9.3</atomikos.version>
        <bitronix.version>2.1.4</bitronix.version>
        <caffeine.version>2.3.5</caffeine.version>
        <cassandra-driver.version>3.1.3</cassandra-driver.version>
        <classmate.version>1.3.3</classmate.version>
        <commons-beanutils.version>1.9.3</commons-beanutils.version>
        <commons-collections.version>3.2.2</commons-collections.version>
        <spring-data-releasetrain.version>Ingalls-RELEASE</spring-data-releasetrain.version>
        ......
</properties>複製程式碼

如果你不想使用某個依賴預設的版本，您還可以通過覆蓋自己的專案中的屬性來覆蓋各個依賴項，例如，要升級到另一個Spring Data版本系列，您可以將以下內容新增到pom.xml中。

<properties>
    <spring-data-releasetrain.version>Fowler-SR2</spring-data-releasetrain.version>
</properties>複製程式碼

原本預設版本是Ingalls-RELEASE的（看上面最後一行有說明Ingalls-RELEASE），現在就使用Fowler-SR2版本了，簡單吧。

並不是每個人都喜歡繼承自spring-boot-starter-parent POM。您可能有您需要使用的自己的公司標準parent，或者您可能更喜歡顯式宣告所有的Maven配置。
如果你不想使用spring-boot-starter-parent，您仍然可以通過使用scope = import依賴關係來保持依賴關係管理：

<dependencyManagement>
     <dependencies>
        <dependency>
            <!-- Import dependency management from Spring Boot -->
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>1.5.1.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>複製程式碼

該設定不允許您使用如上所述的屬性(properties)覆蓋各個依賴項，要實現相同的結果，您需要在spring-boot-dependencies項之前的專案的dependencyManagement中新增一個配置，例如，要升級到另一個Spring Data版本系列，您可以將以下內容新增到pom.xml中。

<dependencyManagement>
    <dependencies>
        <!-- Override Spring Data release train provided by Spring Boot -->
        <dependency>
            <groupId>org.springframework.data</groupId>
            <artifactId>spring-data-releasetrain</artifactId>
            <version>Fowler-SR2</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>1.5.1.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>複製程式碼

起步依賴 spring-boot-starter-xx

Spring Boot提供了很多”開箱即用“的依賴模組，都是以spring-boot-starter-xx作為命名的。舉個例子來說明一下這個起步依賴的好處，比如組裝桌上型電腦和品牌機，自己組裝的話需要自己去選擇不同的零件，最後還要組裝起來，期間有可能會遇到零件不匹配的問題。耗時又消力，而品牌機就好一點，買來就能直接用的，後續想換零件也是可以的。相比較之下，後者帶來的效果更好點（這裡就不討論價格問題哈），起步依賴就像這裡的品牌機，自動給你封裝好了你想要實現的功能的依賴。就比如我們之前要實現web功能，引入了spring-boot-starter-web這個起步依賴。我們來看看spring-boot-starter-web到底依賴了哪些,如下圖：

嘿嘿嘿，看來依賴了好多呢，如果讓我自己弄估計要調半天，所以Spring Boot通過提供眾多起步依賴降低專案依賴的複雜度。起步依賴本質上是一個Maven專案物件模型（Project Object Model，POM），定義了對其他庫的傳遞依賴，這些東西加在一起即支援某項功能。很多起步依賴的命名都暗示了它們提供的某種或者某類功能。

Spring Boot Maven外掛

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>複製程式碼

上面的配置就是Spring Boot Maven外掛，Spring Boot Maven外掛提供了許多方便的功能：

把專案打包成一個可執行的超級JAR（uber-JAR）,包括把應用程式的所有依賴打入JAR檔案內，併為JAR新增一個描述檔案，其中的內容能讓你用java -jar來執行應用程式。
搜尋public static void main()方法來標記為可執行類。

應用入口類

Chapter1Application是一個很關鍵的啟動類，程式的入口就是這裡,為了演示簡單，我們不再新建控制類，而是直接在這個入口類中編寫，新增@RestController以及index方法，如下：

package com.dudu;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@SpringBootApplication
public class Chapter1Application {

    @RequestMapping("/")
    public String index(){
        return "Hello Spring Boot";
    }
    public static void main(String[] args) {
        SpringApplication.run(Chapter1Application.class, args);
    }
}複製程式碼