快速搭建一個 Spring Boot 項目
部分參考於《深入實踐Spring Boot》、《Spring實戰 第四版》與程序猿DD的有關博客。
Spring Boot 優點
- 輕量化
- 提供 Spring 框架各種默認配置來簡化項目配置
- 內嵌 Web 容器
- 沒有冗餘代碼生成和XML配置要求
Maven 導包
spring-boot-starter
:核心模塊,包括了自動配置支持、日誌和YAMLspring-boot-starter-test
:測試模塊,包括JUnit、Hamcrest、Mockitospring-boot-starter-web
:Web模塊
開工
一個 Spring Boot 案例應該包括四個部分(主加載類、邏輯實現類、單元測試類、以及資源配置文件)。
1. 資源配置文件:這個文件主要記錄了框架下各種設置;前面,我們提到過 Spring Boot 提供 Spring 的默認設置,所以一開始並不需要對這個文件做任何修改,讓框架內嵌的Web容器加載該文件即可。* 注意:命名爲application.properties
*,並且默認端口爲8080。
2. 主加載類:Spring Boot 框架下,最重要的一個類,也是啓動整個框架的入口。一般有兩種代碼模板,好像也沒有什麼區別。這裏先寫一種:
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
3. 邏輯實現類:就是我們提供的服務接口,一般就是我們的Controller層。這裏實現一個簡單的”hello world!”的Controller,便於測試。
啓動項目後,訪問 http://localhost:8080/hello 來訪問這個控制器。
@RestController
public class HelloController {
@RequestMapping("/hello")
public String index(){
return "hello world!";
}
}
4. 單元測試類:顧名思義,就是一個用來測試我們的邏輯實現類的類。
這裏使用 JUnit 模擬一個 http 請求來測試我們的 HelloController。
同時,這裏涉及到Spring AOP
的@Before
,有興趣的也可以去查看一下。
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = MockServletContext.class)
@WebAppConfiguration
//測試環境使用,用來表示測試環境使用的ApplicationContext將是WebApplicationContext類型的
public class ApplicationTest {
private MockMvc mvc;
@Before
public void setUp() throws Exception{
//通過MockMvcBuilders.xxxSetup().build()創建一個MockMvc進行測試;
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!")))
.andDo(MockMvcResultHandlers.print())
.andReturn();
}
/**
* 1、mockMvc.perform執行一個請求。
* 2、MockMvcRequestBuilders.get("XXX")構造一個請求。
* 3、ResultActions.andExpect添加執行完成後的斷言。
* 4、ResultActions.andDo添加一個結果處理器,表示要對結果做點什麼事情
* 比如此處使用MockMvcResultHandlers.print()輸出整個響應結果信息。
* 5、ResultActions.andReturn表示執行完成後返回相應的結果。
*/
}
最後附上, http 請求響應後的報文。
MockHttpServletRequest:
HTTP Method = GET
Request URI = /hello
Parameters = {}
Headers = {Accept=[application/json]}
Handler:
Type = qg.fangrui.boot.web.HelloController
Method = public java.lang.String qg.fangrui.boot.web.HelloController.index()
Async:
Async started = false
Async result = null
Resolved Exception:
Type = null
ModelAndView:
View name = null
View = null
Model = null
FlashMap:
Attributes = null
MockHttpServletResponse:
Status = 200
Error message = null
Headers = {Content-Type=[application/json;charset=ISO-8859-1], Content-Length=[12]}
Content type = application/json;charset=ISO-8859-1
Body = hello world!
Forwarded URL = null
Redirected URL = null
Cookies = []