Spring Framework测试工具MockMvc介绍

news2025/2/27 16:45:39

一、基本概念

二、主要特点

三、使用场景

四、工作原理

五、示例代码

接口创建

测试类创建

六、注解解释

@AutoConfigureMockMvc

@WebMvcTest

一、基本概念

MockMvc实现了对Http请求的模拟，能够直接使用网络的形式，转换到Controller的调用。它允许开发者创建一个虚拟的HTTP环境，发送各种HTTP请求，并验证控制器的处理结果。通过MockMvc，开发者可以模拟用户的请求行为，测试控制器层的业务逻辑，而不需要启动完整的Web服务器。

二、主要特点

无需启动服务器：MockMvc可以在不启动实际服务器的情况下对Spring MVC控制器进行测试，从而加快了测试速度并减少了测试环境的复杂性。
支持多种HTTP请求：MockMvc支持GET、POST、PUT、DELETE等多种HTTP请求方法，可以模拟用户在实际应用中可能发出的各种请求。
验证响应结果：MockMvc提供了丰富的验证工具，可以对控制器的响应状态码、响应体、响应头等进行验证，确保控制器的行为符合预期。
易于集成：MockMvc可以与其他测试框架（如JUnit）和测试工具（如Hamcrest）结合使用，提供了灵活的测试选项。

三、使用场景

单元测试：对控制器层进行单元测试，验证控制器的业务逻辑是否正确。
集成测试：虽然MockMvc测试更接近集成测试（因为它测试了控制器、视图和模型的交互），但由于它不需要部署应用程序或连接到数据库，因此通常仍然被归类为单元测试。然而，通过MockMvc，开发者可以在一定程度上模拟集成测试的场景。
接口调试：在没有实际后端服务的情况下，使用MockMvc可以测试控制器与后端服务的交互，帮助开发者调试和验证接口行为。

四、工作原理

构造MockMvc实例：使用MockMvcBuilder构造一个MockMvc的实例，或者在测试类上添加@WebMvcTest注解后通过自动注入创建MockMvc实例。
执行测试：通过MockMvc的perform方法执行一个HTTP请求，该方法接受一个RequestBuilder对象的参数，用于调用控制器的业务处理逻辑。
获得返回结果对象：perform方法返回一个实现了ResultActions接口的对象（即控制器的响应结果），开发者可以在该对象上进行下一步的操作，如进行验证、执行一个处理或继续将结果封装为MvcResult对象。
对结果进行验证：对ResultActions对象进行验证时，接受一个实现了ResultMatcher接口的对象作为参数。开发者可以实现两种验证方式：对请求结果进行验证或对请求返回的内容进行验证。

五、示例代码

接口创建

创建一个简单的Controller接口，获取版本结束时间

@RestController
@RequestMapping("/MockMvc")
public class MockMvcController {
    @Autowired
    private AITestService aITestService;

    @PostMapping(value = "/getGroupVersionEndTime")
    public String getGroupVersionEndTime(@RequestBody GetGroupVersionEndTimeRequest request)   {
        return aITestService.getGroupVersionEndTime(request);
    }
}

测试类创建

创建测试类，使用MockMvc进行测试，这里有两种不同的测试方式

一种是使用@AutoConfigureMockMvc与@SpringBootTest一起使用，用于集成测试。它会自动配置MockMvc实例，且测试范围是整个Spring Boot应用程序的上下文。这意味着在测试过程中，会加载整个应用程序的Bean和配置，包括服务层、数据层等组件。因此，这种测试方式相对较重，但能够更全面地验证应用程序的行为。

@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest
@AutoConfigureMockMvc
public class MockMvcControllerTest {
    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testGetGroupVersionEndTime() throws Exception {
        String request = "{\"allocateGroupCode\":\"G000000003\",\"effStartTime\":\"2020-08-05\",\"effStatus\":\"A\"}";

        MvcResult mvcResult = mockMvc.perform(MockMvcRequestBuilders.post("/MockMvc/getGroupVersionEndTime")
                        .contentType("application/json;charset=UTF-8")
                        .content(request))
                .andDo(MockMvcResultHandlers.print())
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andExpect(MockMvcResultMatchers.jsonPath("$.responseMsg").value("请求成功"))
                .andReturn();

        String content = mvcResult.getResponse().getContentAsString();
        System.out.println(content);
    }
}

一种是使用@WebMvcTest这个注解专门用于测试Spring MVC的控制器层。它会自动配置与MVC相关的组件，如控制器、视图解析器、消息转换器等，但不会加载整个应用程序的上下文。因此，@WebMvcTest提供了一种轻量级的测试方式，专注于控制器层的行为验证，可以理解为切片测试。

import static org.mockito.Mockito.when;

@RunWith(SpringJUnit4ClassRunner.class)
@WebMvcTest(MockMvcController.class)
public class MockMvcControllerWebMvcTest {
    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private AITestService aiTestService; // 如果控制器依赖于服务，可以使用@MockBean注解来模拟这些服务

    @Test
    public void testGetGroupVersionEndTime() throws Exception {
        String request1 = "{\"allocateGroupCode\":\"G000000003\",\"effStartTime\":\"2020-08-05\",\"effStatus\":\"A\"}";
        GetGroupVersionEndTimeRequest request = new GetGroupVersionEndTimeRequest();
        request.setAllocateGroupCode("G000000003");
        request.setEffStartTime("2020-08-05");
        request.setEffStatus("A");
        // 模拟服务方法的返回值
        when(aiTestService.getGroupVersionEndTime(request)).thenReturn("2025-02-26");

        MvcResult mvcResult = mockMvc.perform(MockMvcRequestBuilders.post("/MockMvc/getGroupVersionEndTime")
                        .contentType("application/json;charset=UTF-8")
                        .content(request1))
                .andDo(MockMvcResultHandlers.print())
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andReturn();

        String content = mvcResult.getResponse().getContentAsString();
        System.out.println(content);
    }
}