Junit
JUnit框架用一组assert方法封装了一些常用的断言。这些assert方法可以帮我们简化单元测试的编写。这样的话,Junit就可以根据这些断言是否抛出 AssertionFailedError 错误来判断测试用例的执行结果。
Hamcrest
使用过Junit 的应该有过体验:在实际开发中,一些基本的断言,如eqaul,null,true它们的可读性并不是很好。而且很多时候我们要比较对象、集合、Map等数据结构。这样我们要么进行大段的字段获取再断言。或者干脆自己编写表达式并断言其结果。
JUnit4.4引入了Hamcrest框架,Hamcest提供了一套匹配符Matcher,这些匹配符更接近自然语言,可读性高,更加灵活。
Hamcrest 提供了大量被称为“匹配器”的方法。其中每个匹配器都设计用于执行特定的比较操作。Hamcrest的可扩展性很好,让你能够创建自定义的匹配器。最重要的是,JUnit也包含了Hamcrest的核心,提供了对Hamcrest的原生支持,可以直接使用Hamcrest。当然要使用功能齐备的Hamcrest,还是要引入对它的依赖。
看个对比例子,前者使用Junit的 断言,后者使用 Hamcrest的断言。
1.
2.
3.
public void test_with_junit_assert() {
4.
int expected = 51;
5.
int actual = 51;
6.
7.
assertEquals("failure - They are not same!", expected, actual);
8.
}
9.
10.
11.
public void test_with_hamcrest_assertThat() {
12.
int expected = 51;
13.
int actual = 51;
14.
15.
assertThat("failure - They are not same!", actual, equalTo(expected));
16.
}
17.
个人感觉有两个明显的区别:
1. 参数顺序。两者的expected 和 actual 前后顺序是相反的。
2. Hamcrest 几乎总是直接使用对象。它的语法更符合函数式编程的风格。
这点很好理解了,Junit 总是获取值后再比较,因为比较的是简单的值,因此被比较的放在前面更符合习惯。
而Hamcrest 是直接对测试结果的对象进行一些更复杂的匹配。
支持语言
Hamcrest 支持以下几种语言,详情见http://hamcrest.org/
Java
Python
Ruby
Objective-C
PHP
Erlang
Swift
Hamcrest匹配器
Hamcrest 提供了很强大的一些api 供我们进行测试断言。
1.
2.
核心:
3.
anything - 总是匹配,如果你不关心测试下的对象是什么是有用的
4.
describedAs - 添加一个定制的失败表述装饰器
5.
is - 改进可读性装饰器 - 见下 “Sugar”
6.
逻辑:
7.
allOf - 如果所有匹配器都匹配才匹配,像Java里的&&
8.
anyOf - 如果任何匹配器匹配就匹配,像Java里的||
9.
not - 如果包装的匹配器不匹配器时匹配,反之亦然
10.
对象:
11.
equalTo - 测试对象相等使用Object.equals方法
12.
hasToString - 测试Object.toString方法
13.
instanceOf, isCompatibleType - 测试类型
14.
notNullValue, nullValue - 测试null
15.
sameInstance - 测试对象实例
16.
Beans:
17.
hasProperty - 测试JavaBeans属性
18.
集合:
19.
array - 测试一个数组元素test an array’s elements against an array of matchers
20.
hasEntry, hasKey, hasValue - 测试一个Map包含一个实体,键或者值
21.
hasItem, hasItems - 测试一个集合包含一个元素
22.
hasItemInArray - 测试一个数组包含一个元素
23.
数字:
24.
closeTo - 测试浮点值接近给定的值
25.
greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo - 测试次序
26.
文本:
27.
equalToIgnoringCase - 测试字符串相等忽略大小写
28.
equalToIgnoringWhiteSpace - 测试字符串忽略空白
29.
containsString, endsWith, startsWith - 测试字符串匹配
30.
这些API 几乎覆盖了我们测试断言的所有情况。再提供良好阅读性的情况下,减少了一些取值、循环、类型判断等代码的编写。
不足
这里说的不足,只是本人使用过程中遇到的问题。如果大牛发现Hamcrest 现有的api 支持,欢迎指正。
hasProperty
先看一个复杂的层级结构。
1.
2.
public class MyPerson {
3.
private Address address;
4.
private String name;
5.
private String fullName;
6.
7.
// ...
8.
}
9.
其中 Address 类如下:
1.
2.
public class Address {
3.
4.
private String companyAddress;
5.
private String personalAddress;
6.
7.
// ...
8.
}
9.
这里我们测试一个person对象,有 companyAddress 属性。
1.
2.
3.
public void test_with_complex_property() {
4.
MyPerson p = new MyPerson();
5.
Address address = new Address();
6.
address.setCompanyAddress("");
7.
p.setAddress(address);
8.
assertThat("failure has no address property !", p, hasProperty("address"));
9.
10.
// would failed
11.
// assertThat("failure has no address.companyAddress !", p, hasProperty("address.companyAddress"));
12.
}
13.
这个单元测试的第二个断言出错。也就是说断言 hasProperty 时,不能跨层。这点就没有 rest-assured 的API 用着那么方便了。
这里我想了个办法如下:
assertThat("failure has no address property !", p, hasProperty("address", hasProperty("companyAddress")));
进行了一次嵌套后,就可以满足我们的需要了。
集合的泛型
这里我们要处理集合,断言每个元素都有属性:
1.
2.
3.
public void test_with_list_generics() {
4.
List persons = new ArrayList<MyPerson>();
5.
MyPerson p = new MyPerson();
6.
p.setName("KaKa");
7.
persons.add(p);
8.
9.
MyPerson p2 = new MyPerson();
10.
p2.setName("Hust");
11.
persons.add(p2);
12.
13.
// compile error
14.
// assertThat("failure has no address property !", persons, everyItem(hasProperty("address")));
15.
assertThat("failure has no address property !", (List<Object>)persons, everyItem(hasProperty("address")));
16.
}
17.
这我就没法理解了。显然,被注释的那句断言直接编译失败!然后向上转型后,反而成功。
对象自身属性比较
还用上面的例子,每个 person对象 都有 name 和 fullName 两个属性,断言 fullName 是startwith name 属性。
1.
2.
3.
public void test_with_list_compare_with_self() {
4.
// 加上 类型
5.
List persons = new ArrayList<MyPerson>();
6.
MyPerson p = new MyPerson();
7.
p.setName("KaKa");
8.
p.setFullName("KaKa Zhang");
9.
persons.add(p);
10.
11.
MyPerson p2 = new MyPerson();
12.
p2.setName("Hust");
13.
p.setFullName("Hust Zhang");
14.
persons.add(p2);
15.
16.
// 这里没法写, person对象 属性 startsWith 另一个属性
17.
assertThat((List<Object>)persons, everyItem(hasProperty("name", startsWith(""))));
18.
}
19.
这时候只能循环来断言,某个属性startwWith 另一个属性了。
1.
2.
3.
public void test_with_list_compare_with_self() {
4.
// 加上 类型
5.
List<MyPerson> persons = new ArrayList<MyPerson>();
6.
MyPerson p = new MyPerson();
7.
p.setName("KaKa");
8.
p.setFullName("KaKa Zhang");
9.
persons.add(p);
10.
11.
MyPerson p2 = new MyPerson();
12.
p2.setName("Hust");
13.
p2.setFullName("Hust Zhang");
14.
persons.add(p2);
15.
16.
// 还是用循环来做
17.
for (MyPerson person : persons) {
18.
assertThat(person.getFullName().startsWith(""), is(true));
19.
}
20.
}
21.
上面的这几个时我遇到几个情况。如果大牛有更好的做法,欢迎指点。
















