简介
MockMvc是一种基于Java和JUnit的测试框架，旨在测试Spring MVC应用程序的控制器层。它可以帮助我们模拟HTTP请求，检查响应值，以及发送表单数据和文件等。 MockMvc可以与其他测试组件（如JUnit和Hamcrest）结合使用，以模拟REST API端点或用户界面的操作。
Get请求
简单示例
创建一个简单的Controller：
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/mockMcv")
public class MockMvcController {
@GetMapping("/first/connect")
public String testConnect() {
String result = "Hello MockMVC";
return result;
}
}
创建测试类，使用MockMVC
import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
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.MvcResult;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import org.springframework.test.web.servlet.result.MockMvcResultMatchers;
// webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT：
// 指示Spring Boot在随机且可用的端口上启动Web服务器，避免端口冲突
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
// 自动配置MockMvc和Spring IOC容器
@AutoConfigureMockMvc
@RunWith(SpringRunner.class)
public class MockMvcControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
public void testConnect() throws Exception {
MvcResult mvcResult = mockMvc.perform(
// Get请求，url为：/mockMcv/first/connect
MockMvcRequestBuilders.get("/mockMcv/first/connect"))
// 检查响应状态码是否为200
.andExpect(MockMvcResultMatchers.status().isOk())
// 返回一个MvcResult回调对象
.andReturn();
// 获取响应文本
String content = mvcResult.getResponse().getContentAsString();
// 通过断言来验证返回是否正确
Assert.assertTrue(content.equals("Hello MockMVC"));
}
}
直接启动Debug启动，请求成功：
注意点
上述示例中需要注意，@SpringBootTest注解需要括号中的内容
去掉@SpringBootTest括号中的内容，运行结果：
原因：@SpringBootTest注释用于在测试与Spring Boot应用程序的集成中启用Spring上下文，如果使用默认配置，那就是Mock模式，即加载一个伪造的Web环境，其中一些内容（例如HTTP会话和重定向）不实际触发，而只是返回一个默认值。
所以在测试期间尝试模拟HTTP请求并使用不实际存在的Session时，可能会从该会话对象中出现NullPointerException。
Get带参数
controller中新加一个带参数的Get请求：
@GetMapping("/connect/withParam")
public String testConnectWithParam(@RequestParam("id") Long id, @RequestParam("name") String name) {
String result = "id:" + id + ",name:" + name;
return result;
}
测试类新增对应的测试方法：
@Test
public void testConnectWithParam() throws Exception {
MvcResult mvcResult = mockMvc.perform(
MockMvcRequestBuilders.get("/mockMcv/connect/withParam")
// 通过param()存放各个请求参数
.param("id", "1")
.param("name", "MockMVC"))
.andExpect(MockMvcResultMatchers.status().isOk())
.andReturn();
String content = mvcResult.getResponse().getContentAsString();
Assert.assertTrue(content.contains("MockMVC"));
}
Debug启动，请求成功：
Post请求
示例
controller中新加一个带Body的Post请求：
@PostMapping("/connect/withBody")
public String testConnectWithBody(@RequestBody Map<String,String> requestBody) {
String result = JSONArray.toJSONString(requestBody);
return result;
}
新增一个Java对象存放值：
import lombok.Data;
import java.io.Serializable;
@Data
public class MockMVCInfo implements Serializable {
private static final Long serializableID = -1L;
private Long id;
private String name;
}
测试类新增对应的测试方法：
@Test
public void testConnectWithBody() throws Exception {
MockMVCInfo mockMVCInfo = new MockMVCInfo();
mockMVCInfo.setId(3L);
mockMVCInfo.setName("MockMVC");
MvcResult mvcResult = mockMvc.perform(
MockMvcRequestBuilders.post("/mockMcv/connect/withBody")
// 指定 header中的 Content-Type为 application/json
.header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
// 通过content()存放Body的Json
.content(JSON.toJSONString(mockMVCInfo)))
.andExpect(MockMvcResultMatchers.status().isOk())
.andReturn();
String content = mvcResult.getResponse().getContentAsString();
Assert.assertTrue(content.contains("MockMVC"));
}
Debug启动，请求成功：
注意点
1.通过RequestBody传递值，就得使用.content()方法存放Json
2.Body中使用Json，需要在header中指定Content-Type为application/json，参考Postman：
