Spring Boot基礎(chǔ)教程 ( 一 ) :基礎(chǔ)項(xiàng)目構(gòu)建,引入web模塊,完成一個(gè)簡單的RESTful API
2018-09-27 來源:importnew

簡介
在您第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è)Java類來運(yùn)行一個(gè)Spring引用。你也可以打包你的應(yīng)用為jar并通過使用java -jar來運(yùn)行你的Spring Web應(yīng)用。
Spring Boot的主要優(yōu)點(diǎn):
- 為所有Spring開發(fā)者更快的入門
- 開箱即用,提供各種默認(rèn)配置來簡化項(xiàng)目配置
- 內(nèi)嵌式容器簡化Web項(xiàng)目
- 沒有冗余代碼生成和XML配置的要求
快速入門
本章主要目標(biāo)完成Spring Boot基礎(chǔ)項(xiàng)目的構(gòu)建,并且實(shí)現(xiàn)一個(gè)簡單的Http請(qǐng)求處理,通過這個(gè)例子對(duì)Spring Boot有一個(gè)初步的了解,并體驗(yàn)其結(jié)構(gòu)簡單、開發(fā)快速的特性。
系統(tǒng)要求:
- Java 7及以上
- Spring Framework 4.1.5及以上
本文采用Java 1.8.0_73
、Spring Boot 1.3.2
調(diào)試通過。
使用Maven構(gòu)建項(xiàng)目
1. 通過SPRING INITIALIZR
工具產(chǎn)生基礎(chǔ)項(xiàng)目
- 訪問:
http://start.spring.io/
- 選擇構(gòu)建工具
Maven Project
、Spring Boot版本1.3.2
以及一些工程基本信息,可參考下圖所示 - 點(diǎn)擊
Generate Project
下載項(xiàng)目壓縮包
2. 解壓項(xiàng)目包,并用IDE以Maven
項(xiàng)目導(dǎo)入,以IntelliJ IDEA 14
為例:
- 菜單中選擇
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 7
以上的版本
項(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
下的程序入口:Chapter1Application
src/main/resources
下的配置文件:application.properties
src/test/
下的測試入口:Chapter1ApplicationTests
生成的Chapter1Application
和Chapter1ApplicationTests
類都可以直接運(yùn)行來啟動(dòng)當(dāng)前創(chuàng)建的項(xiàng)目,由于目前該項(xiàng)目未配合任何數(shù)據(jù)訪問或Web模塊,程序會(huì)在加載完Spring之后結(jié)束運(yùn)行。
引入Web模塊
當(dāng)前的pom.xml
內(nèi)容如下,僅引入了兩個(gè)模塊:
spring-boot-starter
:核心模塊,包括自動(dòng)配置支持、日志和YAMLspring-boot-starter-test
:測試模塊,包括JUnit、Hamcrest、Mockito
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies>
引入Web模塊,需添加spring-boot-starter-web
模塊:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
編寫HelloWorld服務(wù)
- 創(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)主程序,打開瀏覽器訪問
http://localhost:8080/hello
,可以看到頁面輸出Hello World
編寫單元測試用例
打開的src/test/
下的測試入口Chapter1ApplicationTests
類。下面編寫一個(gè)簡單的單元測試來模擬http請(qǐng)求,具體如下:
@RunWith(SpringJUnit4ClassRunner.class) @SpringApplicationConfiguration(classes = MockServletContext.class) @WebAppConfiguration public class Chapter1ApplicationTests { 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)求處理。
版權(quán)申明:本站文章部分自網(wǎng)絡(luò),如有侵權(quán),請(qǐng)聯(lián)系:west999com@outlook.com
特別注意:本站所有轉(zhuǎn)載文章言論不代表本站觀點(diǎn)!
本站所提供的圖片等素材,版權(quán)歸原作者所有,如需使用,請(qǐng)與原作者聯(lián)系。