Spring Boot 永遠滴神！10分鐘快速入門

為什么是 SpringBoot

因為目前開發(fā) WEB 應用，Spring Boot 是啟動 Spring 項目最快最流行的方式了。無論我們要構建一個什么樣的應用，它都可以讓我們盡可能快的啟動運行起來。前期基本上無需配置啥東西，而且內(nèi)置應用服務器，讓我們兩三下就可以搞一個 生產(chǎn)級別應用出來，這對于 Java 程序員來說，只能用倆字來形容了，那就是幸福！

SpringBoot 和 Spring 的關系

可能因為 SpringBoot 實在是太驚艷了，網(wǎng)上有很多言論可能對很多小伙伴造成了一些誤解。這里我列舉幾個，看看你中了沒？

1. SpringBoot不是應用服務器；

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

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

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

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

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

1. 自動配置；

2. 起步依賴：告訴 Spring Boot 需要什么功能，它就能引入需要的庫。

3. 命令行界面：這個可以讓我們無須構建項目只寫代碼就可以完成完整的應用程序；

4. Actuator：應用監(jiān)測和監(jiān)控；

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

創(chuàng)建 SpringBoot 應用

這里先說一下，本文我使用的 Spring Boot 版本是 2.5.2 ，要求你本地安裝的 JDK 至少是 1.8 或者更高的版本，Spring Boot 2.x 以上的版本最低要求就是 JDK 1.8 了。官方推薦的版本目前是 jdk8 和 jdk11，因為這倆版本目前是長期維護的。構建打包工具 Gradle 4+ or Maven 3.2+，最后就是宇宙最強 IDE，IntellJ IDEA，沒有之一。

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

1. 打開 https://start.spring.io/,  選擇語言和構建工具以及依賴項，點擊如下圖所示；

2. 點擊 Generate 下載；

3. 解壓下載的壓縮包，進入到項目根目錄,然后使用 IDEA 打開 pom.xml ;

需要注意的是，上面一步，需要先設置 pom.xml 的默認打開應用程序為 IDEA，或者你可以選擇 File --> New --> Project from Existing Sources... 然后選擇 pom.xml 效果也是一樣的，如下圖所示。

4. 打開后，刷新 Maven 依賴（第一次會有點慢，耐心等待），我們就可以得到下圖項目結構了；

訪問數(shù)據(jù)庫

Spring Boot 無縫集成了 關系型數(shù)據(jù)庫 和 NOSQL 數(shù)據(jù)庫 。并且 Spring Boot 也提供了響應式的數(shù)據(jù)庫訪問支持。

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

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

• 將下面的代碼，放到你的 Spring Boot 專屬啟動類中。

@SpringBootApplication
public class Springroad01Application {

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

}
// 測試數(shù)據(jù)庫訪問，容器啟動后會執(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 會自動生成實例的
interface UsersDao extends ReactiveCrudRepository<Users, String> {
}

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

}

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

就是這么赤雞，結束了，啥配置沒有，直接寫了幾行代碼就可以訪問數(shù)據(jù)庫了。

REST 接口開發(fā)

你應該還關心 Spring Boot 如何開發(fā)一個 REST 風格的 WEB 接口吧？別慌，我們直接用 Spring 支持的響應式編程來搞一個 REST 應用服務。但是對于 WEB 訪問用戶來說是看不出來我們使用了非阻塞的響應式編程的，來一手潤物細無聲。

• 將下面的代碼放到啟動類中，就是一個響應式的 REST 接口就開發(fā)好了。

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

溫馨提示，在 mac 上安裝 jq，直接使用 brew install jq 就會自動幫你安裝好了。

好了，打完手工，沒啥搞頭，Spring Boot 永遠滴神！

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

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

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

那怎么玩呢？

確認你的應用添加了對應的模塊依賴；

假如你使用的 maven，那看你的 pom.xml 中下面的依賴：

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

那如果你使用的 gradle，對應的 build.gradle 文件中有下面的依賴：

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

Actuator 通過 endpoint 來暴露 HTTP 請求 來監(jiān)控和管理應用；

應用啟動后，http://localhost:8080/actuator 會展示出所有通過 HTTP 暴露的 endpoint。

因為太長了，我這里列出的只是一部分 endpoint，你自己一定要動手試下。

就比如，/health   這個 endpoint，提供了關于應用健康的基礎信息。

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

/loggers endpoint 展示了應用的日志和可以讓你在運行時改變?nèi)罩镜燃墶?/span>

還有好多，下去都自己玩玩，動手就會了。

友情提示，如果你的 http://localhost:8080/actuator 展示的 開放端點很少，那是因為 actuator 的 endpoint 可以顯式的被打開和關閉，明白了吧！

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

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

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

當然除了上面默認顯示的應用健康信息，我們也可以自定義一個健康指標；

我們可以選擇實現(xiàn) HealthIndicator 接口來實現(xiàn)我們的目標；

@SpringBootApplication
public class Springroad01Application {
  // 加上這個Bean就可以了
    @Bean
    HealthIndicator healthIndicator() {
        return () -> Health.up().withDetail("app", "i am so good").
                withDetail("error","開什么玩笑，老夫怎么可能有錯！").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);
    }

}

一旦你加上我們上面自定義的健康指標，重啟應用，就會看到 health 這個 endpoint 將展示出我們增加的這些信息：

安全控制

對于應用安全的支持，那就繞不開 Spring Security 了。

它可以輕松完成應用的鑒權、授權功能，同時也提供了對響應式編程的支持。

接下來就展示下如果讓你的應用快速帶上安全套。

• 加入 Spring-Security 依賴包；

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

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

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

• 驗證

直接訪問，提示 401 錯誤，這個錯誤碼應該了然于心了吧。沒錯就是沒有權限的意思。

加上用戶名、密碼我們再試試：

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

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

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

江湖再見

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

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

章節(jié)中并沒有對具體的技術細節(jié)做講解，比如 Demo 中使用響應式編程、Spring Boot Actuator 端點的詳細講解等。

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

有道無術，術可成；有術無道，止于術

歡迎大家關注Java之道公眾號

好文章，我在看??