Junit原生断言和hamcrest断言的不同与使用

Junit 断言与 Hamcrest的区别

平常用的Junit 断言只能做一些简单的判断，像两个值是否相等之类
Hamcrest 提供了更丰富的断言方法，可以随心所欲的使用

使用Hamcrest

maven依赖：

<dependency><groupId>org.hamcrest</groupId><artifactId>hamcrest-core</artifactId><version>2.1</version><scope>test</scope>
</dependency>

Hamcrest方法

1、startsWith：匹配字符串以 XX 开头

assertThat("myStringOfNote", startsWith("my"))

2、containsString：匹配是否包含指定字符串

assertThat("myStringOfNote", containsString("ring"))

3、equalTo：基于传入对象的 equals 方法匹配方式，如果是数组比较每个元素是否相等。

assertThat("foo", equalTo("foo"));
assertThat(new String[] {"foo", "bar"}, equalTo(new String[] {"foo", "bar"}));

4、allOf：匹配所有指定的匹配项，可指定多个匹配条件

assertThat("myValue", allOf(startsWith("my"), containsString("Val")));

5、anyOf：匹配其中任意一个匹配项，可指定多个匹配条件

assertThat("myValue", anyOf(startsWith("foo"), containsString("Val")))

6、both：两个选项都匹配

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

7、either：匹配其中任意一个匹配项

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

8、describedAs：自定义描述匹配
describedAs(
参数1：自定义描述，可以使用占位符%0,%1,%2…
参数2：匹配器
参数3：自定义描述中需要替换的变量按先后顺序匹配);

assertThat(120,describedAs("自定义期望值：%0", equalTo(110), 110));

输出：Expected: 自定义期望值：<110>
9、everyItem：匹配现实 Iterable 接口类中的每个元素是否符合要求

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

10、is：装饰另一个匹配器，保留其行为。

assertThat(cheese, is(equalTo(smelly)))

替代

assertThat(cheese, equalTo(smelly))

11、instanceOf：匹配对象是属于哪个类

assertThat(new Canoe(), instanceOf(Canoe.class));

12、isA：instanceOf 的快捷方式

assertThat(cheese, isA(Cheddar.class))

替代

assertThat(cheese, is(instanceOf(Cheddar.class)))

使用Hamcrest

hamcrest会统一先使用assertThat来声明一个断言，然后再在内部进行具体匹配器的断言细节，期望值和实际值进行对比

equalTo: 判断相等

在失败时可以看到打印了我的说明：actual value equal to 10以及失败的对比，<>表示原始类型
closeTo:接近于多少，给定误差值
需要给定两个double类型的参数，一个是你要操作的数值，一个是误差范围；另外要注意的是实际值也必须是double类型才可以进行对比：

anyOf : 后面可跟上多个匹配器，只要其中任何一个满足条件就通过

allOf : 后面可跟上多个匹配器，只要其中任何一个不满足条件都不通过

另外还有很多常用的匹配器，比如
hasItem, hasItems ,contains,等；具体的可以参考官方文档和类库

参考链接

hamcrest官方文档：http://hamcrest.org/JavaHamcrest/tutorial
Junit4官方GitHub：https://github.com/junit-team/junit4/wiki/Matchers-and-assertthat
Mvnrepository：https://mvnrepository.com/artifact/org.hamcrest/hamcrest-core/2.1