MockMvc入门

素颜马尾好姑娘i 2022-12-17 11:57 151阅读 0赞

## 1.使用场景 ##

对模块进行集成测试时，希望能够通过输入URL对Controller进行测试，如果通过启动服务器，建立http client进行测试，这样会使得测试变得很麻烦，比如，启动速度慢，测试验证不方便，依赖网络环境等

MockMvc实现了对Http请求的模拟，能够直接使用网络的形式，转换到Controller的调用，这样可以使得测试速度快、不依赖网络环境，而且提供了一套验证的工具，这样可以使得请求的验证统一而且很方便

## 2. 流程解析 ##

1.  MockMvcBuilder实例化MockMvc
2.  mockMvc调用perform，执行一个RequestBuilder请求，调用controller的业务处理逻辑
3.  perform返回ResultActions，返回操作结果，通过ResultActions，提供了统一的验证方式
4.  使用StatusResultMatchers对请求结果进行验证
5.  使用ContentResultMatchers对请求返回的内容进行验证

## 3. 测试 ##

#### 3.1 controller ####

package com.tcp.controller;
    
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    @RequestMapping("/tcp")
    public class TcpController { 
    
        //测试Controller所用
        @RequestMapping("/test")
        public String test(){ 
            return "success";
        }
    
        @RequestMapping("/mock")
        public String testMockMvc(String s){ 
            return "success" + s;
        }
    }

#### 3.2 测试类 ####

package com.tcp.controller;
    
    import org.junit.Before;
    import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.http.MediaType;
    import org.springframework.test.context.junit4.SpringRunner;
    import org.springframework.test.context.web.WebAppConfiguration;
    import org.springframework.test.web.servlet.MockMvc;
    
    import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
    import org.springframework.test.web.servlet.result.MockMvcResultMatchers;
    import org.springframework.test.web.servlet.setup.MockMvcBuilders;
    import org.springframework.web.context.WebApplicationContext;
    
    import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
    
    @RunWith(SpringRunner.class)
    @SpringBootTest
    @WebAppConfiguration
    public class TcpControllerTest { 
    
        MockMvc mockMvc;
    
        @Autowired
        WebApplicationContext webApplicationContext;
    
        @Before
        public void setup(){ 
            mockMvc = MockMvcBuilders.standaloneSetup(new TcpController()).build();
        }
    
    
        @Test
        public void test() throws Exception { 
            mockMvc.perform(MockMvcRequestBuilders.get("/tcp/mock")
                    .accept(MediaType.APPLICATION_JSON_UTF8_VALUE)
                    .param("s","jbp")
                     )
                    .andExpect(MockMvcResultMatchers.status().isOk())
                    .andDo(print()); //输出MvcResult到控制台
        }
    }

#### 3.3 结果 ####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZWd1Y2hlbg_size_16_color_FFFFFF_t_70_pic_center]

## 4. 部分API解析 ##

#### 4.1 MockMvc的2种实例化方式 ####

// 实例化方式一，通过参数指定一组控制器，这样就不需要从上下文获取了
    		mockMvc = MockMvcBuilders.standaloneSetup(new HelloWorldController()).build();
    		// 实例化方式二，指定WebApplicationContext，将会从该上下文获取相应的控制器并得到相应的MockMvc
    		mockMvc = MockMvcBuilders.webAppContextSetup(webApplicationContext).build();

#### 4.2 API解析 ####

//mockMvc.perform 表示执行一个请求
    mockMvc.perform(MockMvcRequestBuilders
    			.get("/xxx") //构造一个请求
    			// 设置返回值类型为utf-8，否则默认为ISO-8859-1
    			.accept(MediaType.APPLICATION_JSON_UTF8_VALUE)
    			.param("xxx", "xxx"))//添加请求传值
    			//ResultActions.andExpect 添加执行完成后的断言，验证控制器执行完成后结果是否正确
    			.andExpect(MockMvcResultMatchers.status().isOk())//验证状态码是否正确
    			.andExpect(MockMvcResultMatchers.content().string("xxx"))//验证输出内容是否一致
    			.andDo(MockMvcResultHandlers.print());

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZWd1Y2hlbg_size_16_color_FFFFFF_t_70_pic_center]: /images/20221122/03d2dd06e27b4bcf86ce5f1fb528f0bc.png