在您第1次接觸和學(xué)習(xí)Spring框架的時(shí)候,是否因?yàn)槠浞彪s的配置而退卻了?在你第n次使用Spring框架的時(shí)候,是否覺得一堆反復(fù)黏貼的配置有一些厭煩?那么您就不妨來試試使用Spring Boot來讓你更易上手,更簡單快捷地構(gòu)建Spring應(yīng)用!
Spring Boot讓我們的Spring應(yīng)用變的更輕量化。我們不必像以前那樣繁瑣的構(gòu)建項(xiàng)目、打包應(yīng)用、部署到Tomcat等應(yīng)用服務(wù)器中來運(yùn)行我們的業(yè)務(wù)服務(wù)。通過Spring Boot實(shí)現(xiàn)的服務(wù),只需要依靠一個(gè)Java類,把它打包成jar,并通過java -jar
命令就可以運(yùn)行起來。這一切相較于傳統(tǒng)Spring應(yīng)用來說,已經(jīng)變得非常的輕便、簡單。
總結(jié)一下Spring Boot的主要優(yōu)點(diǎn):
- 為所有Spring開發(fā)者更快的入門
- 開箱即用,提供各種默認(rèn)配置來簡化項(xiàng)目配置
- 內(nèi)嵌式容器簡化Web項(xiàng)目
- 沒有冗余代碼生成和XML配置的要求
快速入門
本文我們將學(xué)習(xí)如何快速的創(chuàng)建一個(gè)Spring Boot應(yīng)用,并且實(shí)現(xiàn)一個(gè)簡單的Http請(qǐng)求處理。通過這個(gè)例子對(duì)Spring Boot有一個(gè)初步的了解,并體驗(yàn)其結(jié)構(gòu)簡單、開發(fā)快速的特性。
一、創(chuàng)建基礎(chǔ)項(xiàng)目
Spring官方提供了非常方便的工具Spring Initializropen in new window來幫助我們創(chuàng)建Spring Boot應(yīng)用。
1、使用Spring Initializr頁面創(chuàng)建
第一步:訪問Spring Initializr:https://start.spring.io/
如圖所示,幾個(gè)選項(xiàng)說明:
- Project:使用什么構(gòu)建工具,Maven還是Gradle;本教程將采用大部分Java人員都熟悉的Maven,以方便更多讀者入門學(xué)習(xí)。
- Language:使用什么編程語言,Java、Kotlin還是Groovy;本教程將采用Java為主編寫,以方便更多讀者入門學(xué)習(xí)。
- Spring Boot:選用的Spring Boot版本;這里將使用當(dāng)前最新的
2.1.3
版本。 - Project Metadata:項(xiàng)目的元數(shù)據(jù);其實(shí)就是Maven項(xiàng)目的基本元素,點(diǎn)開More options可以看到更多設(shè)置,根據(jù)自己組織的情況輸入相關(guān)數(shù)據(jù),比如:
- Dependencies:選擇要加入的Spring Boot組件;本文將實(shí)現(xiàn)一個(gè)Http接口,所以可以選擇Web組件,只需要輸入Web,頁面會(huì)自動(dòng)聯(lián)想顯示匹配的可選組件:
點(diǎn)擊”+“之后,就如下圖所示:
第二步:點(diǎn)擊”Generate Project“按鈕生成項(xiàng)目;此時(shí)瀏覽器會(huì)下載一個(gè)與上面Artifact
名稱一樣的壓縮包。
第三步:解壓項(xiàng)目包,并用編譯器以Maven項(xiàng)目導(dǎo)入,以IntelliJ IDEA為例:
- 菜單中選擇:File –> New –> Project from Existing Sources...
- 選擇解壓后的項(xiàng)目文件夾,點(diǎn)擊OK
- 點(diǎn)擊:Import project from external model,并選擇Maven,點(diǎn)擊Next到底為止。
- 若你的環(huán)境有多個(gè)版本的JDK,注意到選擇Java SDK的時(shí)候請(qǐng)選擇Java 8(具體根據(jù)你在第一步中選擇的Java版本為準(zhǔn))
2、使用IntelliJ IDEA創(chuàng)建
如果是使用IntelliJ IDEA來寫Java程序的話,那么還可以直接在編譯器中創(chuàng)建Spring Boot應(yīng)用。
第一步:菜單欄中選擇:File => New => Project..,我們可以看到如下圖所示的創(chuàng)建功能窗口。
其中Initial Service Url指向的地址就是Spring官方提供的Spring Initializr工具地址,所以這里創(chuàng)建的工程實(shí)際上也是基于它的Web工具來實(shí)現(xiàn)的。
第二步:點(diǎn)擊Next,等待片刻后,我們可以看到如下圖所示的工程信息窗口:
其實(shí)內(nèi)容就跟我們用Web版的Spring Initializr是一模一樣的,跟之前在頁面上一樣填寫即可。
第三步:繼續(xù)點(diǎn)擊Next,進(jìn)入選擇Spring Boot版本和依賴管理的窗口:
在這里值的我們關(guān)注的是,它不僅包含了Spring Boot Starter POMs中的各個(gè)依賴,還包含了Spring Cloud的各種依賴。
第四步:點(diǎn)擊Next,進(jìn)入最后關(guān)于工程物理存儲(chǔ)的一些細(xì)節(jié)。最后,點(diǎn)擊Finish就能完成工程的構(gòu)建了。
Intellij中的Spring Initializr雖然還是基于官方Web實(shí)現(xiàn),但是通過工具來進(jìn)行調(diào)用并直接將結(jié)果構(gòu)建到我們的本地文件系統(tǒng)中,讓整個(gè)構(gòu)建流程變得更加順暢,還沒有體驗(yàn)過此功能的Spring Boot/Cloud愛好者們不妨可以嘗試一下這種不同的構(gòu)建方式。
二、項(xiàng)目結(jié)構(gòu)解析
通過上面步驟完成了基礎(chǔ)項(xiàng)目的創(chuàng)建。如上圖所示,Spring Boot的基礎(chǔ)結(jié)構(gòu)共三個(gè)文件(具體路徑根據(jù)用戶生成項(xiàng)目時(shí)填寫的Group所有差異):
src/main/java
下的程序入口:Chapter11Application
src/main/resources
下的配置文件:application.properties
src/test/
下的測試入口:Chapter11ApplicationTests
生成的Chapter11Application
和Chapter11ApplicationTests
類都可以直接運(yùn)行來啟動(dòng)當(dāng)前創(chuàng)建的項(xiàng)目,由于目前該項(xiàng)目未配合任何數(shù)據(jù)訪問或Web模塊,程序會(huì)在加載完Spring之后結(jié)束運(yùn)行。
三、項(xiàng)目依賴解析
打開pom.xml
,一起來看看Spring Boot項(xiàng)目的依賴:
4.0.0
org.springframework.boot
spring-boot-starter-parent
2.1.3.RELEASE
com.didispace
chapter1-1
0.0.1-SNAPSHOT
chapter1-1
Demo project for Spring Boot
1.8
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-test
test
org.springframework.boot
spring-boot-maven-plugin
如上所示,主要有四個(gè)部分:
- 項(xiàng)目元數(shù)據(jù):創(chuàng)建時(shí)候輸入的Project Metadata部分,也就是Maven項(xiàng)目的基本元素,包括:groupId、artifactId、version、name、description等
- parent:繼承
spring-boot-starter-parent
的依賴管理,控制版本與打包等內(nèi)容 - dependencies:項(xiàng)目具體依賴,這里包含了
spring-boot-starter-web
用于實(shí)現(xiàn)HTTP接口(該依賴中包含了Spring MVC);spring-boot-starter-test
用于編寫單元測試的依賴包。更多功能模塊的使用我們將在后面的教程中逐步展開。 - build:構(gòu)建配置部分。默認(rèn)使用了
spring-boot-maven-plugin
,配合spring-boot-starter-parent
就可以把Spring Boot應(yīng)用打包成JAR來直接運(yùn)行。
四、編寫一個(gè)HTTP接口
- 創(chuàng)建package命名為com.didispace.web(根據(jù)實(shí)際情況修改)
- 創(chuàng)建
HelloController
類,內(nèi)容如下:
@RestController
public class HelloController {
@RequestMapping("/hello")
public String index() {
return "Hello World";
}
}
- 啟動(dòng)主程序,使用PostMan等工具發(fā)起請(qǐng)求:
http://localhost:8080/hello
,可以看到頁面返回:Hello World
五、編寫單元測試用例
打開的src/test/
下的測試入口Chapter11ApplicationTests
類。下面編寫一個(gè)簡單的單元測試來模擬http請(qǐng)求,具體如下:
import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@RunWith(SpringRunner.class)
@SpringBootTest
public class Chapter11ApplicationTests {
private MockMvc mvc;
@Before
public void setUp() throws Exception {
mvc = MockMvcBuilders.standaloneSetup(new HelloController()).build();
}
@Test
public void getHello() throws Exception {
mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
.andExpect(status().isOk())
.andExpect(content().string(equalTo("Hello World")));
}
}
使用MockServletContext
來構(gòu)建一個(gè)空的WebApplicationContext
,這樣我們創(chuàng)建的HelloController
就可以在@Before
函數(shù)中創(chuàng)建并傳遞到MockMvcBuilders.standaloneSetup()
函數(shù)中。
注意引入下面內(nèi)容,讓status、content、equalTo函數(shù)可用
import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
至此已完成目標(biāo),通過Maven構(gòu)建了一個(gè)空白Spring Boot項(xiàng)目,再通過引入web模塊實(shí)現(xiàn)了一個(gè)簡單的請(qǐng)求處理。
注:本文轉(zhuǎn)載自“程序猿DD”,如有侵權(quán),請(qǐng)聯(lián)系刪除!