Rest接口单元测试

Get请求url不超过4000字节

Rest成熟度：level 0：使用http作为传输方式，leve 1：引入资源概念，每个资源有对应的url，level 2：使用http方法进行不同操作，使用http状态码表示不同结果，level 3：使用超媒体，在资源表达式中包含链接信息，一般做到level 2

测试依赖：org.springframework.boot:spring-boot-starter-test

测试类：

package com.example.security;

import org.junit.Before;

import org.junit.runner.RunWith;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.boot.test.context.SpringBootTest;

import org.springframework.test.context.junit4.SpringRunner;

import org.springframework.test.web.servlet.MockMvc;

import org.springframework.test.web.servlet.setup.MockMvcBuilders;

import org.springframework.web.context.WebApplicationContext;

@RunWith(SpringRunner.class) //使用SpringRunner运行

@SpringBootTest //表明这是一个测试用例

public class SecurityApplicationTests {

@Autowired

private WebApplicationContext wac; //注入web环境，但是并不会启动Tomcat，所以很快

private MockMvc mockMvc; //模拟web环境

@Before //@Before会在每个@Test之前执行，在里面初始化模拟的web环境

public void setup() {

mockMvc = MockMvcBuilders.webAppContextSetup(wac).build();

}

}

Rest请求单元测试举例（推荐先写好测试用例，执行，失败红色，然后去写Rest api，过程中不断执行测试用例，直到测试用例通过）：

@Test

public void queryUsersOK() throws Exception {

mockMvc.perform(MockMvcRequestBuilders.get("/users")

.contentType(MediaType.APPLICATION_JSON_UTF8))

.andExpect(MockMvcResultMatchers.status().isOk())

.andExpect(MockMvcResultMatchers.jsonPath("$.length()").value(2));

}

该测试用例向/users发送get请求，contentType为application/json;charset=UTF-8,期望响应状态码200，期望响应json字符串数组长度为2。其中jsonPath是用来解析响应的json。请求格式错误会报400。请求的method不匹配会报405。

这里的$代表返回的json文档，具体可在github搜索jsonPath第一个项目json-path/JsonPath即可，具体使用参考, size=10, sort = "username, asc") Pageable page) {

page.getPageNumber();

page.getPageSize();

page.getSort();

return new ArrayList<>();

}

\",\"date\":" + System.currentTimeMillis()+ "}";

String result = mockMvc.perform(post("/user").contentType(MediaType.APPLICATION_JSON_UTF8).content(content)) //put与post的测试用例写法相同，只是把post改成put，url改成如/usr/1

.andExpect(status().isOk()).andExpect(jsonPath("$.id").value("1"))

.andReturn().getResponse().getContentAsString();

System.out.println(result); //时间属性，向后台传参是System.currentTImeMillis();，返回的是2019-08-24T04:06:49.154+0000

}

如果参数对象有Date属性，可以用yyyy-MM-dd或yyyy-MM-dd HH:mm:ss等时间格式字符串转换，但是需要转换且需要适配不同的展示格式，因此直接在json中传递时间戳（毫秒值）更方便，入库存时间戳，前台展示什么样式由js控制。前台时间戳和后台Date类型能够自由转换(经测试，从浏览器url传的date=时间戳转换失败)。

删除单元测试（请求方法使用多了，直接引用*即可）：

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;

@Test

public void deleteUser() throws Exception {

mockMvc.perform(delete("/user/1").contentType(MediaType.APPLICATION_JSON_UTF8)).andExpect(status().isOk());

}