Spring Boot 簡單使用


本篇將介紹 Spring Boot 的簡單使用方式,會通過一個HelloWorldDemo來說明。


構建 Spring Boot 項目文件系統

這里推薦使用項目自動化構建工具,可以提高效率。本文使用的是Gradle,具體步驟可以參考《工具使用——如何使用Gradle創建一個Spring Boot項目》

在這里有一點需要注意,即在Gradle引入項目依賴時,官方推薦的是忽略掉所依賴的jar包的版本號。這是因為Spring Boot 的 Gradle 插件會提供 Dependencies Management(依賴管理),依賴管理在沒有指明依賴的版本號時,自動更新所引用的依賴包,并使所有依賴的包之間也可以相互協作。但若是手動指定版本,可能會因為依賴包間的版本沖突,產生問題。


關于starters依賴描述符

在引入 Spring Boot 依賴時,會根據所要完成的應用的需求,引入許多如spring-boot-starter-*形式命名的依賴。這些依賴統稱為 Spring Boot Starters。它們包含了完成一定功能的,應用所需要的依賴描述符
為了便于項目構建,這些Starters都可以通過一站式商店直接獲取。這樣就可以不必同伙寫代碼、復制粘貼等步驟到處搜索。
下面列出了幾個基本的Web Application會用到的Starters:

| 名稱 | 作用 |
| : ------ : | : ------ : |
| spring-boot-starter-web | 用于構建Web,包含了RESTful,使用Spring MVC作為基礎框架,并使用 Tomcat 作為默認的內嵌容器。 |
| spring-boot-starter-test | 包含了 Spring Boot 應用測試所需要的依賴庫。如JUnit、Hamcret和Mockito。|
| spring-boot-starter-jdbc | 用于Spring Boot 應用配置,告知使用 Tomcat JDBC 連接池。|
| spring-boot-starter-jpa | 用于告知 Spring Boot 配置,通過Hibernate持久層框架使用 Spring Data JPA。|
| spring-boot-starter-hateoas | 用于構建基于超媒體 RESTful 的 Web 應用,使用了Spring MVC 和Spring HATEOAS|
當然,還有很多其他的依賴可供使用,在需要時可以去“Maven central"查找。


構筑代碼

Spring Boot 并不強行要求開發者按照某種代碼結構去書寫才能正常運行,但是會有一些最佳實踐。

  1. 注意默認包(default package)的使用
    當沒有聲明包名的情況下,當前類會被視為放在default package中,而這時,使用 @ComponentScan@EnableAutoConfiguration@SpringBootApplication 等注解都可能會出現問題。因此,官方推薦在構筑代碼時,最好采用 com.example.project 的形式將所有會用到的類都放入對應的命名包中。
  2. 注意包含 main 方法的 Application 類的位置
    由于該類中會含有 @ComponentScan@EnableAutoConfiguration@SpringBootApplication 等注解,其中 @EnableAutoConfiguration 會對當前package下所有的package進行查找以便找到配置所需的明確條目。而@ComponentScan 會根據之前查找到的明確的條目,將這些組件注冊到Spring容器中。那么,將Application 類放置在項目的 root package 下的好處就顯而易見了,這樣做可以使 @ComponentScan 在無需明確指定要掃描的package的條件下,就掃描到所有的組件,從而順利完成自動配置。最終達到簡化配置的目的。
項目的包結構,以及Application類的位置

Spring Boot 的配置類

Spring Boot 同樣支持 XML 配置和基于 Java 的配置。但是相比之下,更加推薦使用基于 Java 的配置。這種配置方式需要開發者在主要的配置類中添加一個main()方法,并將其委托給 SpringApplication 類的run() 方法執行。基于 Java 的配置類需要通過@Configuration注解標明,或者通過@Import 注解引入到主要的配置類中。如果一定要使用 XML 配置文件,可以通過 @ImportResource 注解將 XML 文件引入到主要配置類中。


Spring Boot 的自動配置

Spring Boot 的自動配置是根據當前添加的項目依賴(jar包)去自動完成相關配置的。例如添加了 spring-boot-starter-web 依賴包,Spring Boot 就會自動按照Web Application的默認形式去完成與 web.xml 基本工作等價的配置。當開發者想要應用自動配置功能時,就需要在標注了@Configuration 的配置類類中添加 @EnableAutoConfiguration 注解。
當然,完全依賴自動配置會限制 Web 應用的功能。因此,Spring Boot 推薦開發者根據需求逐步替換自動配置。能做到這一點,也是因為Spring Boot 提供的自動配置是非侵入性的,使得開發者可以從任意一點切入去更改默認配置而不影響項目其他部分。
另外,當開發者使用了多個配置類時,可以通過@EnableAutoConfiguration 提供的 exclude = SomeConfiguration.classexcludeName = someConfigurationInstance 屬性來指定不去應用某個配置類


Spring Boot Beans 和 Denpendency Injection

Spring Boot 支持Spring framework 技術中的 Beans 定義和依賴注入方式。因此,開發者可以很容易的使用 @ComponentScan 找尋 Beans ,并利用 @Autowired 注解完成依賴注入。
@ComponentScan 可以講所有的應用組件都注冊到Spring容器中。
應用組件(Beans)的標注可以通過@Comtroller@Service@Repository@Component完成。
以下是以Controller為例的代碼:

import com.tw.jlhe.helloworld.model.Greeting;
import com.tw.jlhe.helloworld.service.HelloWorldService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {

    @Autowired
    HelloWorldService helloWorldService;

    @RequestMapping(value = "/greeting" , method = RequestMethod.GET)
    public ResponseEntity<?> greeting(){
        Greeting greeting = new Greeting();
        greeting.setGreetingContent(helloWorldService.greering());
        return ResponseEntity.ok(greeting);
    }
    @RequestMapping(value = "/{name}" , method = RequestMethod.GET )
    public ResponseEntity<?> greetingToSomeone(@PathVariable String name){
        Greeting greeting = new Greeting();
        greeting.setGreetingContent(helloWorldService.greetingToSomeone(name));
        return ResponseEntity.ok(greeting);
    }
    @RequestMapping(value = "/greeting/{id}" , method = RequestMethod.GET)
    public ResponseEntity<?> greetingToRepository(@PathVariable Long id){
        Greeting greeting = new Greeting();
        greeting.setGreetingContent(helloWorldService.greetingToRepository(id));
        return ResponseEntity.ok(greeting);
    }
}

其中 @RestController 注解表明當前類是一個 Controller 組件,會被注冊到Spring容器中。當有請求訪問時,Spring容器會自動創建一個該組件的實例來處理請求。在創建該實例的過程中,容器會獲取到 @Autowired 注解,并被告知此處需要注入一個HelloWorldService的實例,也就是該Controller的依賴。那么Spring容器就會根據Java類名反射機制,在 @Service 注解標注的組件中找到一個合適的Service類去創建實例,并將該實例注入到該處。這個創建實例和注入依賴的過程是一種遞歸的過程。


關于@SpringBootApplication注解

這里需要提一下,@SpringBootApplication 注解是Spring Boot 的注解,本著為開發應用提供便捷途徑的原則,Spring Boot將基于 Java 配置類中最佳實踐常用的三個注解@ComponentScan@EnableAutoConfiguration@Configuration 的功能合并成了@SpringBootApplication


了解了以上知識點,就可以使用 Spring Boot 完成一個簡單的 HelloWorldDemo了。

源碼見《HelloWorldDemo》


參考資料

http://docs.spring.io/spring-boot/docs/1.4.3.RELEASE/reference/htmlsingle/#getting-started

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,732評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,214評論 3 426
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,781評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,588評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,315評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,699評論 1 327
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,698評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,882評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,441評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,189評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,388評論 1 372
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,933評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,613評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,023評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,310評論 1 293
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,112評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,334評論 2 377

推薦閱讀更多精彩內容

  • Spring Boot 參考指南 介紹 轉載自:https://www.gitbook.com/book/qbgb...
    毛宇鵬閱讀 46,911評論 6 342
  • Spring Cloud為開發人員提供了快速構建分布式系統中一些常見模式的工具(例如配置管理,服務發現,斷路器,智...
    卡卡羅2017閱讀 134,816評論 18 139
  • 此篇翻譯的是Spring Boot官方指南 Part III. 使用 Spring Boot (Using Spr...
    K天道酬勤閱讀 6,802評論 0 21
  • 1.系統構建 2.代碼構建 3.配置類和相關注解 4.運行 基于版本:Spring Boot 1.5.7.RELE...
    白菜餅閱讀 1,984評論 0 2
  • 前兩天知悉外婆再次患上中風,生命垂危。第二天便乘上火車往家趕,兩個小時后,當我再一次踏上這條通往家的路...
    野草夏花閱讀 317評論 0 0