快速入門
本章主要目標完成Spring Boot基礎項目的構建,並且實現一個簡單的Http請求處理,通過這個例子對Spring Boot有一個初步的瞭解,並體驗其結構簡單、開發快速的特性。
系統要求:
- Java 7及以上
- Spring Framework 4.1.5及以上
本文采用Java 1.8.0_73
、Spring Boot 1.3.2
調試通過。
使用Maven構建項目
- 通過
SPRING INITIALIZR
工具產生基礎項目 - 解壓項目包,並用IDE以
Maven
項目導入,以IntelliJ IDEA 14
爲例:- 菜單中選擇
File
–>New
–>Project from Existing Sources...
- 選擇解壓後的項目文件夾,點擊
OK
- 點擊
Import project from external model
並選擇Maven
,點擊Next
到底爲止。 - 若你的環境有多個版本的JDK,注意到選擇
Java SDK
的時候請選擇Java 7
以上的版本
- 菜單中選擇
項目結構解析
通過上面步驟完成了基礎項目的創建,如上圖所示,Spring Boot的基礎結構共三個文件(具體路徑根據用戶生成項目時填寫的Group所有差異):
src/main/java
下的程序入口:Chapter1Application
src/main/resources
下的配置文件:application.properties
src/test/
下的測試入口:Chapter1ApplicationTests
生成的Chapter1Application
和Chapter1ApplicationTests
類都可以直接運行來啓動當前創建的項目,由於目前該項目未配合任何數據訪問或Web模塊,程序會在加載完Spring之後結束運行。
引入Web模塊
當前的pom.xml
內容如下,僅引入了兩個模塊:
spring-boot-starter
:核心模塊,包括自動配置支持、日誌和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服務
- 創建
package
命名爲com.didispace.web
(根據實際情況修改) - 創建
HelloController
類,內容如下
@RestController
public class HelloController {
@RequestMapping("/hello")
public String index() {
return "Hello World";
}
}
- 啓動主程序,打開瀏覽器訪問
http://localhost:8080/hello
,可以看到頁面輸出Hello World
-
編寫單元測試用例
打開的
src/test/
下的測試入口Chapter1ApplicationTests
類。下面編寫一個簡單的單元測試來模擬http請求,具體如下:
@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
來構建一個空的WebApplicationContext
,這樣我們創建的HelloController
就可以在@Before
函數中創建並傳遞到MockMvcBuilders.standaloneSetup()
函數中。 - 注意引入下面內容,讓
status
、content
、equalTo
函數可用
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;
至此已完成目標,通過Maven構建了一個空白Spring Boot項目,再通過引入web模塊實現了一個簡單的請求處理。
完整項目的源碼來源 技術支持1791743380