1、Junit原生断言assert
作者: 月 关
打开Junit自带的Assert源码如下:
由源码中可以看到常用的一些断言,如
assertTrue
、assertEquals
、assertNotEquals
等,总体来说都是比较简单的相等语义判断的断言;例如我需要断言一个约等于的值或者有个区间波动的值,是否包含某个值等,这个时候assert
就无法直接满足我的需求了,因此下面推出一个更强大灵活的断言——hamcrest断言
2、Hamcrest断言
maven依赖:
<dependency>
<groupId>org.hamcrest</groupId>
<artifactId>hamcrest-core</artifactId>
<version>2.1</version>
<scope>test</scope>
</dependency>
hamcrest支持多中语言,这里以Java为例
进入到hamcrest
断言的Matchers
类中可以看到其中包含了相当丰富的断言匹配器,能更大程度上实现各种复杂断言场景
官网也对断言进行了分类和说明:
先来看hamcrest断言和原生断言的写法区别,在官方文档中给出了的第一个实例如下
在Junit4的官方也给出了说明:
可以看到,
hamcrest
会统一先使用assertThat
来声明一个断言,然后再在内部进行具体匹配器的断言细节,期望值和实际值进行对比;有了hamcrest断言,就可以直接摒弃原生的断言了~
3、hamcrest断言实操演示
-
equalTo: 判断相等
在失败时可以看到打印了我的说明:actual value equal to 10
以及失败的对比,<>
表示原始类型 -
closeTo:接近于多少,给定误差值
源码中使这样写的:
需要给定两个double
类型的参数,一个是你要操作的数值,一个是误差范围;另外要注意的是实际值也必须是double
类型才可以进行对比:
-
anyOf : 后面可跟上多个匹配器,只要其中任何一个满足条件就通过
-
allOf : 后面可跟上多个匹配器,只要其中任何一个不满足条件都不通过
另外还有很多常用的匹配器,比如 - hasItem, hasItems ,contains,等;具体的可以参考官方文档和类库
4、参考链接
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