Spring Boot 单元测试

一、使用mock进行单元测试

Spring框架提供了MockMvc对象，可以在服务端完成对Controller的启动。测试开始之前需要建立测试环境，setup方法被@Before修饰。通过MockMvcBuilders工具，使用WebApplicationContext对象作为参数，创建一个MockMvc对象。
示例：

@RunWith(SpringRunner.class)
//这里的CodedictCustomApplication是springboot的启动类名
@SpringBootTest(classes = CodedictCustomApplication.class)
public class CodeDictControllerTest {

  @Autowired
  private WebApplicationContext wac;

  private MockMvc mvc;

  @Before
  public void setupMockMvc(){
    //初始化MockMvc对象
    mvc = MockMvcBuilders.webAppContextSetup(wac).build();
  }

  /**
   * mockMvc.perform执行一个请求
   * MockMvcRequestBuilders.get(“/user/1”)构造一个请求，Post请求就用.post方法
   * contentType(MediaType.APPLICATION_JSON_UTF8)代表发送端发送的数据格式是application/json;charset=UTF-8
   * accept(MediaType.APPLICATION_JSON_UTF8)代表客户端希望接受的数据类型为application/json;charset=UTF-8
   * ResultActions.andExpect添加执行完成后的断言
   * ResultActions.andExpect(MockMvcResultMatchers.status().isOk())方法看请求的状态响应码是否为200如果不是则抛异常，测试不通过
   * ResultActions.andExpect(MockMvcResultMatchers.jsonPath("$.showValue").value("证件类型")),这里jsonPath用来获取showValue字段比对是否为证件类型,不是就测试不通过
   * ResultActions.andDo添加一个结果处理器，表示要对结果做点什么事情，比如此处使用MockMvcResultHandlers.print()输出整个响应结果信息
   * @throws Exception
   */
  @Test
  public void getAllCatalog() throws Exception {
    mvc.perform(MockMvcRequestBuilders.get("/getAllCatalog")
            .accept(MediaType.APPLICATION_JSON_UTF8)
            .contentType(MediaType.APPLICATION_JSON_UTF8)
    )
    .andExpect(MockMvcResultMatchers.status().isOk())
    .andDo(MockMvcResultHandlers.print());

  }

  @Test
  public void getItem() throws Exception {
    mvc.perform(MockMvcRequestBuilders.get("/getItem")
            .param("rid","ZJLX")
            .accept(MediaType.APPLICATION_JSON_UTF8)
            .contentType(MediaType.APPLICATION_JSON_UTF8)
    )
    .andExpect(MockMvcResultMatchers.status().isOk())
    .andExpect(MockMvcResultMatchers.jsonPath("$.showValue").value("证件类型"))
    .andExpect(MockMvcResultMatchers.jsonPath("$.catalogId").value("#"))
    .andDo(MockMvcResultHandlers.print());
  }

  @Test
  // 单元测试的时候如果不想造成垃圾数据，可以开启事物功能，记在方法或者类头部添加@Transactional注解即可
  @Transactional
  public void modifyItem()throws Exception{
    mvc.perform(MockMvcRequestBuilders.get("/modifyItem")
            .param("rid","ZJLX")
            .param("code","ZJLX")
            .param("catalogId","#")
            .param("sortValue","1")
            .param("showValue","证件")
            .accept(MediaType.APPLICATION_JSON_UTF8)
            .contentType(MediaType.APPLICATION_JSON_UTF8)
    )
    .andExpect(MockMvcResultMatchers.status().isOk())
    .andDo(MockMvcResultHandlers.print());

    mvc.perform(MockMvcRequestBuilders.get("/getItem")
            .param("rid","ZJLX")
            .accept(MediaType.APPLICATION_JSON_UTF8)
            .contentType(MediaType.APPLICATION_JSON_UTF8)
    )
    .andExpect(MockMvcResultMatchers.status().isOk())
    .andExpect(MockMvcResultMatchers.jsonPath("$.showValue").value("证件"))
    .andExpect(MockMvcResultMatchers.jsonPath("$.sortValue").value("1"))
    .andDo(MockMvcResultHandlers.print());
  }
}

二、新断言assertThat使用

JUnit 4.4 结合 Hamcrest 提供了一个全新的断言语法——assertThat。程序员可以只使用 assertThat 一个断言语句，结合 Hamcrest 提供的匹配符，就可以表达全部的测试思想，我们引入的版本是Junit4.12所以支持assertThat。
基本的语法：

assertThat( [value], [matcher statement] );

• value:是接下来想要测试的变量值；
• matcher statement:是使用 Hamcrest 匹配符来表达的对前面变量所期望的值的声明，如果 value 值与 matcher statement 所表达的期望值相符，则测试成功，否则测试失败。

示例：

@Test
  public void assertThatUse(){
    //1.使用匹配符 Matcher 和不使用之间的比较
    // 想判断某个字符串 s 是否含有子字符串 "developer" 或 "Works" 中间的一个
    // JUnit 4.4 以前的版本：assertTrue(s.indexOf("developer")>-1||s.indexOf("Works")>-1 );
    // JUnit 4.4：
    assertThat("s",anyOf(containsString("developer"), containsString("Works")));
    // 匹配符 anyOf 表示任何一个条件满足则成立，类似于逻辑或 "||"， 匹配符 containsString 表示是否含有参数子
    // 字符串，文章接下来会对匹配符进行具体介绍

    //2.Matcher 匹配符联合使用
    // 联合匹配符not和equalTo表示“不等于”
    assertThat( "s", not( equalTo( "developer" )));
    // 联合匹配符not和containsString表示“不包含子字符串”
    assertThat( "s", not( containsString( "Works")));
    // 联合匹配符anyOf和containsString表示“包含任何一个子字符串”
    assertThat("s", anyOf(containsString("developer"), containsString("Works")));


    //3.默认提供一些可读的描述性错误信息
    String s = "hello world!";
    assertThat( s, anyOf( containsString("developer"), containsString("Works") ) );
    // 如果出错后，系统会自动抛出以下提示信息：
    // java.lang.AssertionError:
    // Expected: (a string containing "developer" or a string containing "Works")
    // but: was "s"
    // Expected :(a string containing "developer" or a string containing "Works")
  }

其它使用示例：

字符相关匹配符
/**equalTo匹配符断言被测的testedValue等于expectedValue，
* equalTo可以断言数值之间，字符串之间和对象之间是否相等，相当于Object的equals方法
*/
assertThat(testedValue, equalTo(expectedValue));
/**equalToIgnoringCase匹配符断言被测的字符串testedString
*在忽略大小写的情况下等于expectedString
*/
assertThat(testedString, equalToIgnoringCase(expectedString));
/**equalToIgnoringWhiteSpace匹配符断言被测的字符串testedString
*在忽略头尾的任意个空格的情况下等于expectedString，
*注意：字符串中的空格不能被忽略
*/
assertThat(testedString, equalToIgnoringWhiteSpace(expectedString);
/**containsString匹配符断言被测的字符串testedString包含子字符串subString**/
assertThat(testedString, containsString(subString) );
/**endsWith匹配符断言被测的字符串testedString以子字符串suffix结尾*/
assertThat(testedString, endsWith(suffix));
/**startsWith匹配符断言被测的字符串testedString以子字符串prefix开始*/
assertThat(testedString, startsWith(prefix));
一般匹配符
/**nullValue()匹配符断言被测object的值为null*/
assertThat(object,nullValue());
/**notNullValue()匹配符断言被测object的值不为null*/
assertThat(object,notNullValue());
/**is匹配符断言被测的object等于后面给出匹配表达式*/
assertThat(testedString, is(equalTo(expectedValue)));
/**is匹配符简写应用之一，is(equalTo(x))的简写，断言testedValue等于expectedValue*/
assertThat(testedValue, is(expectedValue));
/**is匹配符简写应用之二，is(instanceOf(SomeClass.class))的简写，
*断言testedObject为Cheddar的实例
*/
assertThat(testedObject, is(Cheddar.class));
/**not匹配符和is匹配符正好相反，断言被测的object不等于后面给出的object*/
assertThat(testedString, not(expectedString));
/**allOf匹配符断言符合所有条件，相当于“与”（&&）*/
assertThat(testedNumber, allOf( greaterThan(8), lessThan(16) ) );
/**anyOf匹配符断言符合条件之一，相当于“或”（||）*/
assertThat(testedNumber, anyOf( greaterThan(16), lessThan(8) ) );
数值相关匹配符
/**closeTo匹配符断言被测的浮点型数testedDouble在20.0¡À0.5范围之内*/
assertThat(testedDouble, closeTo( 20.0, 0.5 ));
/**greaterThan匹配符断言被测的数值testedNumber大于16.0*/
assertThat(testedNumber, greaterThan(16.0));
/** lessThan匹配符断言被测的数值testedNumber小于16.0*/
assertThat(testedNumber, lessThan (16.0));
/** greaterThanOrEqualTo匹配符断言被测的数值testedNumber大于等于16.0*/
assertThat(testedNumber, greaterThanOrEqualTo (16.0));
/** lessThanOrEqualTo匹配符断言被测的testedNumber小于等于16.0*/
assertThat(testedNumber, lessThanOrEqualTo (16.0));
集合相关匹配符
/**hasEntry匹配符断言被测的Map对象mapObject含有一个键值为"key"对应元素值为"value"的Entry项*/
assertThat(mapObject, hasEntry("key", "value" ) );
/**hasItem匹配符表明被测的迭代对象iterableObject含有元素element项则测试通过*/
assertThat(iterableObject, hasItem (element));
/** hasKey匹配符断言被测的Map对象mapObject含有键值“key”*/
assertThat(mapObject, hasKey ("key"));
/** hasValue匹配符断言被测的Map对象mapObject含有元素值value*/
assertThat(mapObject, hasValue(value));