Junit4 之 assertThat

一、前言

assertThat 是 Hamcrest 单元测试框架提供的方法。Hamcrest 提供了对多种语言的支持。

• 官网地址： http://hamcrest.org/
• Java 版：http://hamcrest.org/JavaHamcrest/

二、字符相关匹配符

1. equalTo

   assertThat(testedValue, equalTo(expectedValue)); 
   

   断言被测的 testedValue 等于 expectedValue，equalTo 可以断言数值之间，字符串之间和对象之间是否相等，相当于 Object 的equals 方法。
2. equalToIgnoringCase

   assertThat(testedString, equalToIgnoringCase(expectedString));
   

   断言被测的字符串 testedString 在忽略大小写的情况下等于 expectedString。
3. equalToIgnoringWhiteSpace

    assertThat(testedString, equalToIgnoringWhiteSpace(expectedString);
   

   断言被测的字符串 testedString 在忽略头尾的任意个空格的情况下等于 expectedString。（注：字符串中的空格不能被忽略）
4. containsString

    assertThat(testedString, containsString(subString));
   

   断言被测的字符串 testedString 包含子字符串 subString。
5. endsWith

    assertThat(testedString, endsWith(suffix));
   

   断言被测的字符串 testedString 以子字符串 suffix 结尾。
6. startsWith

   assertThat(testedString, startsWith(prefix));
   

   断言被测的字符串t estedString 以子字符串 prefix 开始。

三、一般匹配符

1. nullValue()

    assertThat(object,nullValue());
   

   断言被测 object 的值为 null。
2. notNullValue()

    assertThat(object,notNullValue());
   

   断言被测 object 的值不为 null。
3. is

    assertThat(testedString, is(equalTo(expectedValue)));
   

   断言被测的 object 等于后面给出匹配表达式。
   • is匹配符简写应用之一：

      assertThat(testedValue, is(expectedValue));
     

     is(equalTo(x)) 的简写，断言 testedValue 等于expectedValue。
   • is 匹配符简写应用之二：

       assertThat(testedObject, is(Cheddar.class));
     

     is(instanceOf(SomeClass.class)) 的简写，断言 testedObject 为 Cheddar 的实例
4. not

   assertThat(testedString, not(expectedString));
   

   与 is 匹配符正好相反，断言被测的 object 不等于后面给出的 object。
5. allOf

   assertThat(testedNumber, allOf( greaterThan(8), lessThan(16) ) );
   

   断言符合所有条件，相当于“与”（&&）。
6. anyOf

   assertThat(testedNumber, anyOf( greaterThan(16), lessThan(8) ) );
   

   断言符合条件之一，相当于“或”（||）。
7. both

   assertThat("fab", both(containsString("a")).and(containsString("b")));
   

   两个选项都匹配。
8. either

    assertThat("fan", either(containsString("a")).or(containsString("b")));
   

   匹配其中任意一个匹配项。
9. instanceOf

    assertThat(order, instanceOf(Order.class)); 
   

   匹配对象是属于哪个类。
10. isA

     assertThat(user, isA(User.class))
    

    作为 instanceOf 简写的方式，作用与 instanceOf 相同。

四、数值相关匹配符

1. closeTo

    assertThat(testedDouble, closeTo( 20.0, 0.5 ));
   

   断言被测的浮点型数 testedDouble 在 20.0-0.5 ~ 20.0+0.5 范围之内。
2. greaterThan

    assertThat(testedNumber, greaterThan(16.0));
   

   断言被测的数值 testedNumber 大于 16.0。
3. lessThan

    assertThat(testedNumber, lessThan (16.0));
   

   断言被测的数值 testedNumber 小于16.0。
4. greaterThanOrEqualTo

    assertThat(testedNumber, greaterThanOrEqualTo (16.0));
   

   断言被测的数值 testedNumber 大于等于 16.0。
5. lessThanOrEqualTo

    assertThat(testedNumber, lessThanOrEqualTo (16.0));
   

   断言被测的 testedNumber 小于等于 16.0。

五、集合相关匹配符

1. hasEntry

    assertThat(mapObject, hasEntry("key", "value" ) );
   

   断言被测的 Map 对象 mapObject 含有一个键值为 “key” 对应元素值为 “value” 的 Entry 项。
2. hasItem

    assertThat(iterableObject, hasItem (element));
   

   表明被测的迭代对象 iterableObject 含有元素 element 项则测试通过。
3. hasKey

    assertThat(mapObject, hasKey ("key"));
   

   断言被测的 Map 对象 mapObject 含有键值 “key”。
4. hasValue

    assertThat(mapObject, hasValue(value));
   

   断言被测的 Map 对象 mapObject 含有元素值 value。
5. everyItem

   assertThat(Arrays.asList("bar", "baz"), everyItem(startsWith("ba"))) 
   

   匹配现实 Iterable 接口类中的每个元素是否符合要求。