使用MockMvc测试Controller

最新推荐文章于 2024-03-11 13:50:04 发布

makesailing

最新推荐文章于 2024-03-11 13:50:04 发布

阅读量4.8k

点赞数 1

分类专栏： Test测试文章标签： Test

本文链接：https://blog.csdn.net/qq_37653556/article/details/82831462

版权

Test测试专栏收录该内容

1 篇文章 0 订阅

订阅专栏

1. 概述

对模块进行集成测试时,希望能够通过输入URL对controller进行测试,如果通过启动服务器,建立http client进行测试,这样会使得测试的变得的很麻烦,比如: 启动速度慢、测试验证不方便、依赖网络环境等,这样会导致测试无法进行,为了可以对Controller进行测试,可以通过引入MockMVC进行解决.

2.运行配置

引入的jar :

<!-- 单元测试 -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
    </dependency>
<!-- spring test -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>4.3.5.RELEASE</version>
    </dependency>

用到的注解 :

1.@RunWith(SpringJunit4ClassRunner.class) : 表示使用Spring Test组件进行单元测试 .

2.@WebAppConfiguration : 使用这个Annotaion会在跑单元测试时真实的启动一个web服务,然后开始调用Controller的Restful API,待单元测试跑完之后再将web服务停掉.

3.@ContextConfiguration({ "classpath:spring-mvc.xml", "classpath:applicationContext.xml"}) : 指定Bean的配置文件信息,可以有多种方式,这个例子使用的文件路径形式,如果有多个配置文件,可以将括号中的信息配置为一个字符串数组来表示.

3. 基本框架

**测试 : **

package com.makesailing.neo;

import org.junit.Before;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.context.WebApplicationContext;
@RunWith(SpringJUnit4ClassRunner.class)
@WebAppConfiguration
@ContextConfiguration({ "classpath:spring-mvc.xml", "classpath:applicationContext.xml"})
public class BaseControllerTest {
	// 注入web环境的ApplicationContext容器
	@Autowired
	protected WebApplicationContext webApplicationContext;

	/**
	 * 模拟mvc测试对象
	 */
	protected MockMvc mockMvc;


	/**
	 * 所有测试方法执行之前执行该方法
	 */
	@Before // 这个注解的作用,在每个方法之前都会执行一遍
	public void before() {
		//获取mockmvc对象实例
		mockMvc = MockMvcBuilders.webAppContextSetup(webApplicationContext).build();
	}
}

// 配置事务的回滚,对数据库的增删改都会回滚,便于测试用例的循环利用
@TransactionConfiguration(transactionManager = "transactionManager", defaultRollback = true)
@Transactional
public class UserControllerTest extends BaseControllerTest {

  /**
   * Method: getUserDetailById(@PathVariable(name = "id") Long id)
   */
  @Test
  public void testGetUserDetailById() throws Exception {
    RequestBuilder request = null;
    request = get('v1/user/{id}/detail", 1);
    String responseString = mockMvc.perform(request)
        .andExpect(status().isOk()) // 返回的状态是200
        .andDo(print()) // 打印出请求和相应的内容
        .andReturn().getResponse().getContentAsString(); // 将数据转换为字符串
    Assert.assertNotNull(responseString);
    System.out.println(responseString);

  }
}

Controller层 :

@RestController
public class UserController {

 @Autowired
 private UserService userService;


 @GetMapping("v1/user/{id}/detail")
 public String getUserDetailById(@PathVariable(name = "id") Long id) {
  User user = userService.getUserDetailById(id);
  return JSON.toJSONString(user);
 }
}

代码解析 :

perform：执行一个RequestBuider请求,自动执行SpringMvc的流程并映射到相应的控制器执行处理
get: 声明一个发送get请求的方法. public static MockHttpServletRequestBuilder get(String urlTemplate, Object... uriVars) { return new MockHttpServletRequestBuilder(HttpMethod.GET, urlTemplate, uriVars);}这是个静态方法,可以直接导入,根据uri模版和uri的变量值得到一个get请求的方法. 另外提供了其他的请求方法, 如：post、put、delete 等.
andExperct: 添加ResultMatcher验证规则,验证perform执行完成后的结果是否正确(对返回的数据进行判断)
andDo: 添加ResultHandler结果处理器,比如调试打印结果到控制台print()
andReturn: 最后返回相应的MvcResult,然后进行自定义验证/进行下一步的异步处理.

注意如果是post、put 测试,Controller使用@RequestBody User user进行接收,那么测试时也需要使用json格式数据,如下 :

/**
   * Method: saveUser(@RequestBody User user)
   */
  @Test
  public void testSaveUser() throws Exception {
    User user = new User();
    user.setEmail("12345678@qq.com");
    user.setUsername("jack");
    user.setPassword("123456");
    user.setRole("root");
    user.setStatus(1);
    user.setRegtime(new Date());
    //user.setRegip("127.0.0.1");

    String content = JSON.toJSONString(user);
    String response = mockMvc.perform(
        post(Urls.User.SAVE_USER).contentType(MediaType.APPLICATION_JSON_UTF8).content(content))
        .andDo(print())
        .andExpect(status().isOk())
        .andReturn().getResponse().getContentAsString();
    Assert.assertNotNull(response);
    Assert.assertNotEquals(response,"");
    System.out.println(response);
  }
/**
   * Method: updateUser(@RequestBody User user)
   */
  @Test
  public void testUpdateUser() throws Exception {
    User user = new User();
    user.setId(2L);
    user.setUsername("tom");

    String respone = mockMvc.perform(
        put(Urls.User.UPDATE_USER).contentType(MediaType.APPLICATION_JSON_UTF8).content(JSON.toJSONString(user)))
        .andDo(print()).andExpect(status().isOk()).andReturn().getResponse().getContentAsString();
    Assert.assertNotNull(respone);
    System.out.println(respone);
  }

4 .RequestBuilder/MockMvcRequestBuilders 相关API详细描述

RequestBuilder/MockMvcRequestBuilders

从名字可以看出，RequestBuilder用来构建请求的，其提供了一个方法buildRequest(ServletContext servletContext)用于构建MockHttpServletRequest；其主要有两个子类MockHttpServletRequestBuilder和MockMultipartHttpServletRequestBuilder（如文件上传使用），即用来Mock客户端请求需要的所有数据.

4.1 .MockMvcRequestBuilders主要API

MockHttpServletRequestBuilder get(String urlTemplate, Object… urlVariables)：根据uri模板和uri变量值得到一个GET请求方式的MockHttpServletRequestBuilder；如get(/user/{id}, 1L)；

MockHttpServletRequestBuilder post(String urlTemplate, Object… urlVariables)：同get类似，但是是POST方法；
提供自己的Http请求方法及uri模板和uri变量，如上API都是委托给这个API；
MockMultipartHttpServletRequestBuilder fileUpload(String urlTemplate, Object… urlVariables)：提供文件上传方式的请求，得MockMultipartHttpServletRequestBuilder；
RequestBuilder asyncDispatch(final MvcResult mvcResult)：创建一个从启动异步处理的请求的MvcResult进行异步分派的RequestBuilder；
MockHttpServletRequestBuilder和MockMultipartHttpServletRequestBuilder API
MockHttpServletRequestBuilder API
MockHttpServletRequestBuilder header(String name, Object… values)/MockHttpServletRequestBuilder headers(HttpHeaders httpHeaders)：添加头信息；
MockHttpServletRequestBuilder contentType(MediaType mediaType)：指定请求的contentType头信息；
MockHttpServletRequestBuilder accept(MediaType… mediaTypes)/MockHttpServletRequestBuilder accept(String… mediaTypes)：指定请求的Accept头信息；
MockHttpServletRequestBuilder content(byte[] content)/MockHttpServletRequestBuilder content(String content)：指定请求Body体内容；
MockHttpServletRequestBuilder cookie(Cookie… cookies)：指定请求的Cookie；
MockHttpServletRequestBuilder locale(Locale locale)：指定请求的Locale；
MockHttpServletRequestBuilder characterEncoding(String encoding)：指定请求字符编码；
MockHttpServletRequestBuilder requestAttr(String name, Object value) ：设置请求属性数据；
MockHttpServletRequestBuilder sessionAttr(String name, Object value)/
MockHttpServletRequestBuilder sessionAttrs(Map<\string, object=”“> \sessionAttributes)：设置请求session属性数据；
MockHttpServletRequestBuilder flashAttr(String name, Object value)/MockHttpServletRequestBuilder flashAttrs(Map<\string, object=”“>\ flashAttributes)：指定请求的flash信息，比如重定向后的属性信息；
MockHttpServletRequestBuilder session(MockHttpSession session) ：指定请求的Session；
MockHttpServletRequestBuilder principal(Principal principal) ：指定请求的Principal；
MockHttpServletRequestBuilder contextPath(String contextPath) ：指定请求的上下文路径，必须以“/”开头，且不能以“/”结尾；
MockHttpServletRequestBuilder pathInfo(String pathInfo) ：请求的路径信息，必须以“/”开头；
MockHttpServletRequestBuilder secure(boolean secure)：请求是否使用安全通道；
MockHttpServletRequestBuilder with(RequestPostProcessor postProcessor)：请求的后处理器，用于自定义一些请求处理的扩展点；

4.2 MockMultipartHttpServletRequestBuilder 主要API

MockMultipartHttpServletRequestBuilder file(String name, byte[] content)/MockMultipartHttpServletRequestBuilder file(MockMultipartFile file)：指定要上传的文件；

4.3 ResultActions

调用MockMvc.perform(RequestBuilder requestBuilder)后将得到ResultActions，通过ResultActions完成如下三件事：

ResultActions andExpect(ResultMatcher matcher) ：添加验证断言来判断执行请求后的结果是否是预期的；
ResultActions andDo(ResultHandler handler) ：添加结果处理器，用于对验证成功后执行的动作，如输出下请求/结果信息用于调试；
MvcResult andReturn() ：返回验证成功后的MvcResult；用于自定义验证/下一步的异步处理；
**ResultMatcher/MockMvcResultMatchers **

ResultMatcher用来匹配执行完请求后的结果验证，其就一个match(MvcResult result)断言方法，如果匹配失败将抛出相应的异常；spring mvc测试框架提供了很多***ResultMatchers来满足测试需求。注意这些***ResultMatchers并不是ResultMatcher的子类，而是返回ResultMatcher实例的。Spring mvc测试框架为了测试方便提供了MockMvcResultMatchers静态工厂方法方便操作；

具体的API如下：

HandlerResultMatchers handler()：请求的Handler验证器，比如验证处理器类型/方法名；此处的Handler其实就是处理请求的控制器；
RequestResultMatchers request()：得到RequestResultMatchers验证器；
ModelResultMatchers model()：得到模型验证器；
ViewResultMatchers view()：得到视图验证器；
FlashAttributeResultMatchers flash()：得到Flash属性验证；
StatusResultMatchers status()：得到响应状态验证器；
HeaderResultMatchers header()：得到响应Header验证器；
CookieResultMatchers cookie()：得到响应Cookie验证器；
ContentResultMatchers content()：得到响应内容验证器；
JsonPathResultMatchers jsonPath(String expression, Object … args)/ResultMatcher jsonPath(String expression, Matcher matcher)：得到Json表达式验证器；
XpathResultMatchers xpath(String expression, Object… args)/XpathResultMatchers xpath(String expression, Map)

makesailing

关注

1
点赞
踩
28

收藏

觉得还不错? 一键收藏
0
评论
使用MockMvc测试Controller

1. 概述对模块进行集成测试时,希望能够通过输入URL对controller进行测试,如果通过启动服务器,建立http client进行测试,这样会使得测试的变得的很麻烦,比如: 启动速度慢、测试验证不方便、依赖网络环境等,这样会导致测试无法进行,为了可以对Controller进行测试,可以通过引入MockMVC进行解决.2.运行配置引入的jar :&lt;!-- 单元测试 --&g...
复制链接

扫一扫