10分鐘完成Spring Boot 實戰

原文:https://www.jianshu.com/p/2c1471869659

目前沒有系統學習過 Spring 框架,參與工作時,直接參與到了 Spring Boot 項目的開發。目前還比較菜,所以,你要是和我一樣,不妨也跳過 Spring 框架的學習,直接學習 Sring Boot。

官方文檔 的一段介紹:

Spring Boot makes it easy to create stand-alone, production-grade Spring-based Applications that you can run. We take an opinionated view of the Spring platform and third-party libraries, so that you can get started with minimum fuss. Most Spring Boot applications need very little Spring configuration.

You can use Spring Boot to create Java applications that can be started by using java -jar or more traditional war deployments. We also provide a command line tool that runs “spring scripts”.

大體意思是說,Spring Boot 可以輕鬆創建可以運行的獨立的,基於生產級 Spring 的應用程序。這個框架簡化了我們 Spring 的配置。可以使用 Spring Boot 創建 Java 應用,只需要使用 java -jarwar 包部署方式就可以啓動。也內嵌了 Tomcat ,在開發時無需以 war 包也可以運行應用。

環境

下面是本文編寫時,我機器的環境:

  • Java 1.8.0_181
  • Maven 3.5.4

創建項目

本文目的是創建一個基本的 RESTful Web 服務。創建 Spring Boot 服務的方式主要有兩種:

  • 在 IDEA 中使用 Spring Initializr 創建,我個人比較傾向這種方式,方便快捷;
  • 訪問網站 Spring Initializr 網站,勾選相關項目依賴,最後生成一個初始化項目,導入 IDE。

image

下面主要介紹 IDEA 如何初始化一個 Sring Boot 項目:

1.File-New-Porject,選擇 Spring Initializr ,選擇 SDK 版本;

2.輸入項目的元數據信息,關係到項目的路徑、 pom 文件中項目的 Maven 座標( GAV ),;

3.選擇需要的 Maven 依賴,這裏 Spring Boot 版本,我選擇了 2.1.6 版本;

4.最後一步指定項目存放位置;

  • src/main/java 中有項目代碼文件,根目錄下是入口類: SpringBootHelloWorldApplication 類。 @SpringBootApplication 註解,這是整個 Spring Boot 的核心註解,它的目的就是開啓 Spring Boot 的自動配置。
  • src/main/resources 下是配置文件: application.properties
  • src/test/ 下的測試入口:Chapter1ApplicationTests

添加控制器類 —— Controller

通常在項目中對外提供的 API 都會放在叫做 Controller 的包下。
這裏向大家推薦一個測試交流圈q裙:790047143。
我們創建一個 Controller 的包,並添加一個叫做 HelloWorld 的類:

@RestController
public class HelloWorld {

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello World";
    }

}

  • @RestController 註解加在這個類上,使之變爲一個 Controller

這是我們啓動項目,便可以通過地址 localhost:8080/hello127.0.0.1:8080/hello 看到 sayHello 函數執行的內容。

查看控制檯的輸出,我們可以知道 Spring Boot 項目啓動時,默認的端口是 8080

Profile

官方文檔中有關於 Profile 的描述。 Prorile輪廓、外形、簡況 的含義,這裏我就把它理解爲「配置描述」好了。

在實際項目中,生產、beta 不同環境將採用不同的配置,比如數據庫配置等等。這時候,我們只需要創建多分 Profile 文件即可。

除了 application.properties 文件,配置文件還可以採用下面的命名規則 application-{profile}.properties 。Environment 中具有一組可選的值。如果沒有設置需要激活什麼配置文件,就默認激活 default 配置,即 application-default.properties

指定的配置文件都是從同一個位置被激活,即從標準的配置文件 application.properties

如果指定了多個配置文件,採取 last-win 策略,即「最後獲勝側率」。這句話意思是什麼呢,就是說,在你的 application.properties 中如果指定了激活好幾個配置文件,那麼,最後指定的那個配置文件纔會生效。

我們分別創建兩個環境配置文件:

  • application-dev.properties 測試環境

       server.port=8081

  • application-prod.properties 生產環境

      #server.port=8082
 

通過 application.prperties 指定 Profile

applcation.properties 公共配置文件。激活 Dev 配置文件,需要在 application.properties 設置:

#這裏定義8080主要是爲了看端口設置是否會被 dev 覆蓋
server.port=8080
spring.profiles.active=dev

這時候啓動程序時,我們查看控制檯就可看到 Dev 環境被激活了,應用端口是 8081 。這時候觀察 application.properties 的端口設置是否會會生效。經過測試可以發現,此時 8080 端口被 Dev 的配置覆蓋了。

接着,我們激活 Prod 配置,注意,此時我將 Prod 端口配置註釋掉了,這時候觀察 application.properties 的端口設置是否會會生效。經過測試可以發現,此時 8080 端口生效了。

通過 Environment 指定 Profile

除了上面在 application.properties 指定激活的配置外,還可以在 Envirionment 中設置相關環境變量激活:

image

經過測試,我在 Environment 中設置環境變量激活了 Dev 的配置,然後在 application.properties 激活的是 Prod 的配置,最終控制檯日誌顯示, Dev 配置被激活。

jar 方式運行時

如果採用 mvn clean package 打出 jar 包,那麼可以使用如下方式指定 Profile:

java -jar spring-boot-hello-world-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev

Property 值獲取

我們可以在 Profile 中指定一些 propety 的值,在程序中可以獲取到。
application-dev.properties 定義如下:

server.port=8081
author.name=Michael

接着,我們在 Controller 類中使用 @Value 注,即可獲取到這個屬性:

@RestController
public class HelloWorld {
    @Value(value = "${author.name}")
    private String authorName;

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello World By " + authorName;
    }

}

定製 Banner

Banner 就是指我們在啓動應用時控制檯一開始打印的那個內容,默認是打印 Spring Boot

  1. src/main/resorces 下新建一個名爲 banner.txt 的內容;
  2. 複製你想顯示的內容到 banner.txt

個性化 Banner 來源:

送一個有趣的 Banner:

////////////////////////////////////////////////////////////////////
//                          _ooOoo_                               //
//                         o8888888o                              //
//                         88" . "88                              //
//                         (| ^_^ |)                              //
//                         O\  =  /O                              //
//                      ____/`---'\____                           //
//                    .'  \\|     |//  `.                         //
//                   /  \\|||  :  |||//  \                        //
//                  /  _||||| -:- |||||-  \                       //
//                  |   | \\\  -  /// |   |                       //
//                  | \_|  ''\---/''  |   |                       //
//                  \  .-\__  `-`  ___/-. /                       //
//                ___`. .'  /--.--\  `. . ___                     //
//              ."" '<  `.___\_<|>_/___.'  >'"".                  //
//            | | :  `- \`.;`\ _ /`;.`/ - ` : | |                 //
//            \  \ `-.   \_ __\ /__ _/   .-` /  /                 //
//      ========`-.____`-.___\_____/___.-`____.-'========         //
//                           `=---='                              //
//      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^        //
//            佛祖保佑       永不宕機     永無BUG                  //
//////////////////////////////////////////////////////////////////// 

補充知識

spring-boot-starter

Spring Boot 提供了很多”開箱即用“的依賴模塊,都是以 spring-boot-starter-xx 作爲命名的。下面列舉一些常用的模塊:

  • spring-boot-starter-logging :使用 Spring Boot 默認的日誌框架 Logback。
  • spring-boot-starter-log4j :添加 Log4j 的支持。
  • spring-boot-starter-web :支持 Web 應用開發,包含 Tomcat 和 spring-mvc。
  • spring-boot-starter-tomcat :使用 Spring Boot 默認的 Tomcat 作爲應用服務器。
  • spring-boot-starter-jetty :使用 Jetty 而不是默認的 Tomcat 作爲應用服務器。
  • spring-boot-starter-test :包含常用的測試所需的依賴,如 JUnit、Hamcrest、Mockito 和 spring-test 等。
  • spring-boot-starter-aop :包含 spring-aop 和 AspectJ 來支持面向切面編程(AOP)。
  • spring-boot-starter-security :包含 spring-security。
  • spring-boot-starter-jdbc :支持使用 JDBC 訪問數據庫。
  • spring-boot-starter-redis :支持使用 Redis。
  • spring-boot-starter-data-mongodb :包含 spring-data-mongodb 來支持 MongoDB。
  • spring-boot-starter-data-jpa :包含 spring-data-jpa、spring-orm 和 Hibernate 來支持 JPA。
  • spring-boot-starter-amqp :通過 spring-rabbit 支持 AMQP。
  • spring-boot-starter-actuator : 添加適用於生產環境的功能,如性能指標和監測等功能。

SpringBoot 目錄結構

目錄結構理解

  • controller:控制層,前端控制器,負責頁面訪問控制,主要是對外提供的API接口,用戶使用服務時的入口處,可以結合swagger生成對應的API文檔
  • service:業務層,邏輯層,主要是業務類代碼,歸檔了前端控制器中相關服務的操作方法接口類,該文件夾下包含子impl文件夾,歸檔對應的實現接口
  • domain:實體類,歸檔對應的實體(Entity),一個實體嚐嚐就對應着數據庫中一張表
  • dao:數據訪問層,實體類對應的數據庫操作接口類,它與數據庫進行交互,封裝了對數據庫的CURD操作
  • config:配置信息類
  • utils:工具類
  • constant:常量接口類

當請求來了,controller 就會將相應的請求分發到相應的 service層,在 service 層中再調用 dao 層進行數據庫交互。這裏的 dao 層其實就是之前的 model 層,封裝了對數據庫的操作。這樣一來,就把業務處理邏輯從 controller 中分離出來,從而實現瞭解耦。
感謝您的觀看,如有不足之處,歡迎批評指正。

獲取資料

本次給大家推薦一個免費的學習羣,裏面概括Java架構/分佈式/微服務/docker/高性能高併發以及面試資源等。對Java架構感興趣的程序猿,歡迎加入Q羣:790047143,不管你是剛入行得還是大牛我都歡迎,還有大牛整理的一套高效率學習路線和教程與您免費分享,同時每天更新視頻資料。
最後,祝大家早日學有所成。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章