Spring Boot 永遠(yuǎn)滴神！10分鐘快速入門(mén)

為什么是 SpringBoot

因?yàn)槟壳伴_(kāi)發(fā) WEB 應(yīng)用，Spring Boot 是啟動(dòng) Spring 項(xiàng)目最快最流行的方式了。無(wú)論我們要構(gòu)建一個(gè)什么樣的應(yīng)用，它都可以讓我們盡可能快的啟動(dòng)運(yùn)行起來(lái)。前期基本上無(wú)需配置啥東西，而且內(nèi)置應(yīng)用服務(wù)器，讓我們兩三下就可以搞一個(gè) 生產(chǎn)級(jí)別應(yīng)用出來(lái)，這對(duì)于 Java 程序員來(lái)說(shuō)，只能用倆字來(lái)形容了，那就是幸福！

SpringBoot 和 Spring 的關(guān)系

可能因?yàn)?SpringBoot 實(shí)在是太驚艷了，網(wǎng)上有很多言論可能對(duì)很多小伙伴造成了一些誤解。這里我列舉幾個(gè)，看看你中了沒(méi)？

1. SpringBoot不是應(yīng)用服務(wù)器；

之所以有這個(gè)誤解，是因?yàn)?SpringBoot 可以將Web應(yīng)用程序打包成可執(zhí)行的 jar 文件，不用部署到我們傳統(tǒng)的Java應(yīng)用服務(wù)器就可以運(yùn)行。這是因?yàn)?SpringBoot 內(nèi)置了一個(gè)Servlet容器（Tomcat、Jetty等），所以這個(gè)功能并不是 SpringBoot 本身的而是內(nèi)嵌的 Servlet容器提供的。

2. SpringBoot 沒(méi)有實(shí)現(xiàn) JPA 或者 JMS（Java消息服務(wù)）等企業(yè)級(jí) Java 規(guī)范。

只不過(guò)是自動(dòng)配置了支持這些特性的 Bean，比如自動(dòng)配置了 Hibernate ，這些都是之前已經(jīng)有的技術(shù)，并不是SpringBoot新實(shí)現(xiàn)的；

SpringBoot 就是 Spring，它做了那些沒(méi)有它我們也會(huì)自己去做的 Spring Bean 配置。它利用的是 Spring4 的條件化配置特性，以及 Maven 和 Gradle 提供的傳遞依賴(lài)。

Spring Boot 相比于 Spring 主要包含了以下四個(gè)核心功能：

1. 自動(dòng)配置；

2. 起步依賴(lài)：告訴 Spring Boot 需要什么功能，它就能引入需要的庫(kù)。

3. 命令行界面：這個(gè)可以讓我們無(wú)須構(gòu)建項(xiàng)目只寫(xiě)代碼就可以完成完整的應(yīng)用程序；

4. Actuator：應(yīng)用監(jiān)測(cè)和監(jiān)控；

搞清楚了 Spring Boot 其實(shí)就是一種開(kāi)發(fā) Spring 應(yīng)用程序的快捷方式，那接下來(lái)，讓我們一起來(lái)感受疾風(fēng)吧，看看它到底有多便捷。

創(chuàng)建 SpringBoot 應(yīng)用

這里先說(shuō)一下，本文我使用的 Spring Boot 版本是 2.5.2 ，要求你本地安裝的 JDK 至少是 1.8 或者更高的版本，Spring Boot 2.x 以上的版本最低要求就是 JDK 1.8 了。官方推薦的版本目前是 jdk8 和 jdk11，因?yàn)檫@倆版本目前是長(zhǎng)期維護(hù)的。構(gòu)建打包工具 Gradle 4+ or Maven 3.2+，最后就是宇宙最強(qiáng) IDE，IntellJ IDEA，沒(méi)有之一。

既然是入門(mén)，我們今天就以 Spring5 開(kāi)始支持的響應(yīng)式編程為例，讓大家感受下使用 Spring Boot 是如何開(kāi)發(fā)響應(yīng)式項(xiàng)目的。

1. 打開(kāi) https://start.spring.io/,  選擇語(yǔ)言和構(gòu)建工具以及依賴(lài)項(xiàng)，點(diǎn)擊如下圖所示；

2. 點(diǎn)擊 Generate 下載；

3. 解壓下載的壓縮包，進(jìn)入到項(xiàng)目根目錄,然后使用 IDEA 打開(kāi) pom.xml ;

需要注意的是，上面一步，需要先設(shè)置 pom.xml 的默認(rèn)打開(kāi)應(yīng)用程序?yàn)?IDEA，或者你可以選擇 File --> New --> Project from Existing Sources... 然后選擇 pom.xml 效果也是一樣的，如下圖所示。

4. 打開(kāi)后，刷新 Maven 依賴(lài)（第一次會(huì)有點(diǎn)慢，耐心等待），我們就可以得到下圖項(xiàng)目結(jié)構(gòu)了；

訪問(wèn)數(shù)據(jù)庫(kù)

Spring Boot 無(wú)縫集成了 關(guān)系型數(shù)據(jù)庫(kù) 和 NOSQL 數(shù)據(jù)庫(kù) 。并且 Spring Boot 也提供了響應(yīng)式的數(shù)據(jù)庫(kù)訪問(wèn)支持。

那我們?nèi)绻胧褂?Spring Boot 訪問(wèn)數(shù)據(jù)庫(kù)，都需要做什么呢？穩(wěn)住，你可能會(huì)震驚的。

下面給大家看下我寫(xiě)的響應(yīng)式編程數(shù)據(jù)庫(kù)訪問(wèn)的測(cè)試代碼，為了不依賴(lài)任何環(huán)境，讓大家可以快速、直觀的感受，我使用的是內(nèi)存數(shù)據(jù)庫(kù) h2。

• 將下面的代碼，放到你的 Spring Boot 專(zhuān)屬啟動(dòng)類(lèi)中。

@SpringBootApplication
public class Springroad01Application {

    public static void main(String[] args) {
        SpringApplication.run(Springroad01Application.class, args);
    }

}
// 測(cè)試數(shù)據(jù)庫(kù)訪問(wèn)，容器啟動(dòng)后會(huì)執(zhí)行run方法
@Component
class DataWriter implements ApplicationRunner {

    private Logger log = LoggerFactory.getLogger(DataWriter.class);

    private DatabaseClient client;

    private UsersDao usersDao;

    public DataWriter(DatabaseClient client, UsersDao usersDao) {
        this.client = client;
        this.usersDao = usersDao;
    }

    @Override
    public void run(ApplicationArguments args) {

        List<String> statements = Arrays.asList(
                "DROP TABLE IF EXISTS USERS;",
                "CREATE TABLE IF NOT EXISTS USERS ( id SERIAL PRIMARY KEY, name VARCHAR(100) NOT NULL);");

        statements.forEach(sql -> client.sql(sql).fetch().rowsUpdated()
                .doOnSuccess(count -> log.info("Schema created, rows updated: {}", count))
                .doOnError(error -> log.error("got error : {}",error.getMessage(),error))
                .subscribe()
        );

        Flux.just("sevenluo","tonyzhu","jameschen").flatMap(name -> usersDao.save(new Users(null,name))).subscribe(user -> log.info("User saved: {}",user));


    }
}
// DAO 接口，不需要加注解，繼承了 ReactiveCrudRepository 會(huì)自動(dòng)生成實(shí)例的
interface UsersDao extends ReactiveCrudRepository<Users, String> {
}

@Data
@AllArgsConstructor
@NoArgsConstructor
class Users {
    @Id
    private Integer id;
    private String name;

}

• 執(zhí)行 main 方法，輸入結(jié)果；

就是這么赤雞，結(jié)束了，啥配置沒(méi)有，直接寫(xiě)了幾行代碼就可以訪問(wèn)數(shù)據(jù)庫(kù)了。

REST 接口開(kāi)發(fā)

你應(yīng)該還關(guān)心 Spring Boot 如何開(kāi)發(fā)一個(gè) REST 風(fēng)格的 WEB 接口吧？別慌，我們直接用 Spring 支持的響應(yīng)式編程來(lái)搞一個(gè) REST 應(yīng)用服務(wù)。但是對(duì)于 WEB 訪問(wèn)用戶(hù)來(lái)說(shuō)是看不出來(lái)我們使用了非阻塞的響應(yīng)式編程的，來(lái)一手潤(rùn)物細(xì)無(wú)聲。

• 將下面的代碼放到啟動(dòng)類(lèi)中，就是一個(gè)響應(yīng)式的 REST 接口就開(kāi)發(fā)好了。

• 測(cè)試一下，打開(kāi)命令行，curl 測(cè)試一下（不是非要裝逼不用瀏覽器訪問(wèn)，公司的大佬說(shuō)程序員要多用shell環(huán)境，嗯！從小事開(kāi)始練）；

溫馨提示，在 mac 上安裝 jq，直接使用 brew install jq 就會(huì)自動(dòng)幫你安裝好了。

好了，打完手工，沒(méi)啥搞頭，Spring Boot 永遠(yuǎn)滴神！

監(jiān)控和管理應(yīng)用

我們的應(yīng)用上線后，那肯定都是要上監(jiān)控的，不然哪一天神不知鬼不覺(jué)死翹翹了，麻煩就大了。這個(gè) Spring Boot 它就天生帶了可以替我們監(jiān)控和管理的 Spring 應(yīng)用的模塊工具：spring-boot-actuator 。

像什么 健康檢查、審計(jì)、統(tǒng)計(jì)和HTTP追蹤等該有的它都有。值得一提的是 spring-boot-actuator 它還很 open ，支持與其它外部監(jiān)控系統(tǒng)做整合。補(bǔ)充了它自身沒(méi)有一些好看的儀表盤(pán)、圖表、分析、告警等 酷炫吊炸天的能力。

那怎么玩呢？

確認(rèn)你的應(yīng)用添加了對(duì)應(yīng)的模塊依賴(lài)；

假如你使用的 maven，那看你的 pom.xml 中下面的依賴(lài)：

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

那如果你使用的 gradle，對(duì)應(yīng)的 build.gradle 文件中有下面的依賴(lài)：

dependencies {
    compile("org.springframework.boot:spring-boot-starter-actuator")
}

Actuator 通過(guò) endpoint 來(lái)暴露 HTTP 請(qǐng)求 來(lái)監(jiān)控和管理應(yīng)用；

應(yīng)用啟動(dòng)后，http://localhost:8080/actuator 會(huì)展示出所有通過(guò) HTTP 暴露的 endpoint。

因?yàn)樘L(zhǎng)了，我這里列出的只是一部分 endpoint，你自己一定要?jiǎng)邮衷囅隆?/span>

就比如，/health   這個(gè) endpoint，提供了關(guān)于應(yīng)用健康的基礎(chǔ)信息。

/metrics endpoint 展示了幾個(gè)非常有用的度量信息，比如 JVM內(nèi)存使用情況、系統(tǒng) CPU 使用情況、打開(kāi)的文件等等。

/loggers endpoint 展示了應(yīng)用的日志和可以讓你在運(yùn)行時(shí)改變?nèi)罩镜燃?jí)。

還有好多，下去都自己玩玩，動(dòng)手就會(huì)了。

友情提示，如果你的 http://localhost:8080/actuator 展示的 開(kāi)放端點(diǎn)很少，那是因?yàn)?actuator 的 endpoint 可以顯式的被打開(kāi)和關(guān)閉，明白了吧！

默認(rèn)情況下很多 endpoint 是被關(guān)閉掉了，你只需要在 application.properties 配置文件中增加如下配置即可。

management.endpoint.health.show-details=always //顯示詳細(xì)的健康信息
management.endpoints.web.exposure.include=*  //粗暴的全部打開(kāi)，反正自己玩，任性

這里我們就不多說(shuō)這些 endpoint 每個(gè)的作用了, 如果你感興趣，可以給我留言，我會(huì)根據(jù)大家需求看下是否在出一期教程詳細(xì)介紹一下。

當(dāng)然除了上面默認(rèn)顯示的應(yīng)用健康信息，我們也可以自定義一個(gè)健康指標(biāo)；

我們可以選擇實(shí)現(xiàn) HealthIndicator 接口來(lái)實(shí)現(xiàn)我們的目標(biāo)；

@SpringBootApplication
public class Springroad01Application {
  // 加上這個(gè)Bean就可以了
    @Bean
    HealthIndicator healthIndicator() {
        return () -> Health.up().withDetail("app", "i am so good").
                withDetail("error","開(kāi)什么玩笑，老夫怎么可能有錯(cuò)！").build();
    }

    @Bean
    RouterFunction<ServerResponse> routes (UsersDao usersDao) {
        return RouterFunctions.route(GET("/users"),serverRequest -> ok().body(usersDao.findAll(),Users.class));

    }

    public static void main(String[] args) {
        SpringApplication.run(Springroad01Application.class, args);
    }

}

一旦你加上我們上面自定義的健康指標(biāo)，重啟應(yīng)用，就會(huì)看到 health 這個(gè) endpoint 將展示出我們?cè)黾拥倪@些信息：

安全控制

對(duì)于應(yīng)用安全的支持，那就繞不開(kāi) Spring Security 了。

它可以輕松完成應(yīng)用的鑒權(quán)、授權(quán)功能，同時(shí)也提供了對(duì)響應(yīng)式編程的支持。

接下來(lái)就展示下如果讓你的應(yīng)用快速帶上安全套。

• 加入 Spring-Security 依賴(lài)包；

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

• 內(nèi)存中配置一個(gè)用戶(hù)，設(shè)置用戶(hù)名和密碼；

@Bean
// 內(nèi)存中配置用戶(hù)名、密碼為 admin/admin，用戶(hù)角色為 USER
MapReactiveUserDetailsService users() {
    return new MapReactiveUserDetailsService(User.withUsername("admin").password(PasswordEncoderFactories.createDelegatingPasswordEncoder().encode("admin")).roles("USER").build());
}

• 驗(yàn)證

直接訪問(wèn)，提示 401 錯(cuò)誤，這個(gè)錯(cuò)誤碼應(yīng)該了然于心了吧。沒(méi)錯(cuò)就是沒(méi)有權(quán)限的意思。

加上用戶(hù)名、密碼我們?cè)僭囋嚕?/span>

curl -vu admin:admin http://localhost:8080/actuator/health | jq

加上用戶(hù)名和密碼令人期待的結(jié)果就返回了，是不是瞬間心情大好呢。

上面我們僅僅是引入了 Spring-Security 包，然后加了兩三行代碼，沒(méi)有寫(xiě)任何的攔截器驗(yàn)證邏輯，我們的應(yīng)用就具備了安全驗(yàn)證功能，這也太 啊妹子ing 了吧。

江湖再見(jiàn)

此章節(jié)我們就完成了 Spring-Boot 的入門(mén)開(kāi)發(fā)介紹。

用10分鐘完成了包含 創(chuàng)建應(yīng)用、訪問(wèn)數(shù)據(jù)庫(kù)、REST接口開(kāi)發(fā)、監(jiān)控和管理、安全控制 的開(kāi)發(fā)。

章節(jié)中并沒(méi)有對(duì)具體的技術(shù)細(xì)節(jié)做講解，比如 Demo 中使用響應(yīng)式編程、Spring Boot Actuator 端點(diǎn)的詳細(xì)講解等。

僅僅是為了讓小伙伴們了解到 Spring Boot 的強(qiáng)大和便利，感受下 Spring 對(duì)我們程序員的友好。

有道無(wú)術(shù)，術(shù)可成；有術(shù)無(wú)道，止于術(shù)

歡迎大家關(guān)注Java之道公眾號(hào)

好文章，我在看??