本章主要目标完成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工具産生基礎項目
通路:
http://start.spring.io/選擇建構工具Maven Project、Spring Boot版本1.3.2以及一些工程基本資訊,可參考下圖所示SPRING INITIALIZR
點選Generate Project下載下傳項目壓縮包
解壓項目包,并用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:核心子產品,包括自動配置支援、日志和YAML
<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>
引入Web子產品,需添加spring-boot-starter-web子產品:
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
編寫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子產品實作了一個簡單的請求處理。