单元测试 - 如何断言

JUnit和Hamcrest

JUnit是一个很著名的单元测试框架，我们在使用Junit的时候，一般会使用它的Assert类下面各种assertXXX方法。Junit还包含了一个Hamcrest。这是一个断言库，我们可以用这个断言库来进行复杂的断言操作。但是Junit自带的Assert类和Hamcrest有几个缺点：

1.Junit仅依赖了Hamcrest核心包，只附带了最进本的断言功能，如果我们希望断言数字大小之类的话，还需要自己引入Hamcrest完整包；

2.缺乏更新，在Maven Central上，Hamcrest库最新的更新时间还是2014年。因此对JDK8支持可能不够充分；

3.Matcher分散在多个类中，编写困难，我们为了编写类似assertThat(reponseString,anyOf(containsString(“color”),containsString(“color”)))这样的代码，需要静态引入多个类，比较麻烦；

AssertJ

AssertJ:号称流式断言。什么是流式，常见的断言，一条断言语句只能对实际值断言一个校验点。而AssertJ支持一条断言语句对实际值同时断言多个校验点，这样使得断言的语句更加简洁适合阅读。AssertJ还支持一次性执行所有断言，然后收集所有失败的断言一起反馈。还有其他更多的特性。

AssertJ有1、2、3三个版本，分别用于JDK6、7、8（及以上），如在jdk7环境下配置依赖包：

<dependency>
    <groupId>org.assertj</groupId>
    <artifactId>assertj-core</artifactId>
    <version>2.8.0</version>
    <scope>test</scope>
</dependency>

然后在测试类中静态导入所有断言：

import static org.assertj.core.api.Assertions.*;

然后就可以在测试方法里在需要断言的地方加上assertThar即可。

assertThat(objectUnderTest).//断言操作

assertJ支持所有的Java的基本类型。所以我们只要引入这一个包就可以满足绝大多数的需求。简单方便。例子如下：

1.简单断言

assertThat(frodo.getName()).isEqualTo("Frodo");
assertThat(frodo).isNotEqualTo(sauron)
                 .isIn(fellowshipOfTheRing);

2..链式校验

// isEqualTo 相等， contains包含
assertThat("abc").as("校验abc").isEqualTo("abc").contains("d");

3.null值判断

//null值判断
Object object = null;
assertThat(object).isNotNull();

4. String断言

assertThat(frodo.getName()).startsWith("Fro")
                           .endsWith("do")
                           .isEqualToIgnoringCase("frodo");

5.断言数字

 // 断言相等  
 assertThat(42).isEqualTo(42);  
 // 断言大于 大于等于  
 assertThat(42).isGreaterThan(38).isGreaterThanOrEqualTo(38);  
 // 断言小于 小于等于  
 assertThat(42).isLessThan(58).isLessThanOrEqualTo(58);  
 // 断言0值  
 assertThat(0).isZero();  
 // 断言正数 非负数  
 assertThat(1).isPositive().isNotNegative();  
 // 断言负数 非正数  
 assertThat(-1).isNegative().isNotPositive();  

6.断言日期

// 断言与指定日期相同 不相同 在指定日期之后 在指定日期之钱  
assertThat(Dates.parse("2014-02-01")).isEqualTo("2014-02-01").isNotEqualTo("2014-01-01")  
.isAfter("2014-01-01").isBefore(parse("2014-03-01"));  
// 断言 2014 在指定年份之前 在指定年份之后  
assertThat(DateTime.now().toDate()).isBeforeYear(2020).isAfterYear(2013);  
// 断言时间再指定范围内 不在指定范围内  
assertThat(parse("2014-02-01")).isBetween("2014-01-01", "2014-03-01").isNotBetween(  
parse("2014-02-02"), parse("2014-02-28"));  
// 断言两时间相差100毫秒  
Date d1 = new Date();  
Date d2 = new Date(d1.getTime() + 100);  
assertThat(d1).isCloseTo(d2, 100);  
// sets dates differing more and more from date1  
Date date1 = Dates.parseDatetimeWithMs("2003-01-01T01:00:00.000");  
Date date2 = parseDatetimeWithMs("2003-01-01T01:00:00.555");  
Date date3 = parseDatetimeWithMs("2003-01-01T01:00:55.555");  
Date date4 = parseDatetimeWithMs("2003-01-01T01:55:55.555");  
Date date5 = parseDatetimeWithMs("2003-01-01T05:55:55.555");  
// 断言 日期忽略毫秒，与给定的日期相等  
assertThat(date1).isEqualToIgnoringMillis(date2);  
// 断言 日期与给定的日期具有相同的年月日时分秒  
assertThat(date1).isInSameSecondAs(date2);  
// 断言 日期忽略秒，与给定的日期时间相等  
assertThat(date1).isEqualToIgnoringSeconds(date3);  
// 断言 日期与给定的日期具有相同的年月日时分  
assertThat(date1).isInSameMinuteAs(date3);  
// 断言 日期忽略分，与给定的日期时间相等  
assertThat(date1).isEqualToIgnoringMinutes(date4);  
// 断言 日期与给定的日期具有相同的年月日时  
assertThat(date1).isInSameHourAs(date4);  
// 断言 日期忽略小时，与给定的日期时间相等  
assertThat(date1).isEqualToIgnoringHours(date5);  
// 断言 日期与给定的日期具有相同的年月日  
assertThat(date1).isInSameDayAs(date5);  

7.集合断言

// 断言 列表是空的  
assertThat(newArrayList()).isEmpty();  
// 断言 列表的开始 结束元素  
assertThat(newArrayList(1, 2, 3)).startsWith(1).endsWith(3);  
// 断言 列表包含元素 并且是排序的  
assertThat(newArrayList(1, 2, 3)).contains(1, atIndex(0)).contains(2, atIndex(1)).contains(3)  
.isSorted();  
// 断言 被包含与给定列表  
assertThat(newArrayList(3, 1, 2)).isSubsetOf(newArrayList(1, 2, 3, 4));  
// 断言 存在唯一元素  
assertThat(Lists.newArrayList("a", "b", "c")).containsOnlyOnce("a");  
//断言 列表大小
assertThat(fellowshipOfTheRing).hasSize(9)
.contains(frodo, sam)
.doesNotContain(sauron);

8.Map断言

// 断言 map 不为空 size  
assertThat(foo).isNotEmpty().hasSize(3);  
// 断言 map 包含元素  
assertThat(foo).contains(entry("A", 1), entry("B", 2));  
// 断言 map 包含key  
assertThat(foo).containsKeys("A", "B", "C");  
// 断言 map 包含value  
assertThat(foo).containsValue(3);  

9.Class断言

// 断言 是注解  
assertThat(Magical.class).isAnnotation();  
// 断言 不是注解  
assertThat(Ring.class).isNotAnnotation();  
// 断言 存在注解  
assertThat(Ring.class).hasAnnotation(Magical.class);  
// 断言 不是借口  
assertThat(Ring.class).isNotInterface();  
// 断言 是否为指定Class实例  
assertThat("string").isInstanceOf(String.class);  
// 断言 类是给定类的父类  
assertThat(Person.class).isAssignableFrom(Employee.class);  

10.as()添加错误提示信息

assertThat(frodo.getAge()).as("check %s's age", frodo.getName()).isEqualTo(33);

11.是否在某个范围内

List list = new ArrayList();
assertThat(list).isIn(new ArrayList(), new HashMap());
assertThat(list).isNotIn(new ArrayList(), new HashMap());

还有许多请参考官方文档

http://joel-costigliola.github.io/assertj/index.html