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.

@Test



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.

@Test



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.

@Test



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.

@Test



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对象 都有 namefullName 两个属性,断言 fullName 是startwith name 属性。

1. 

2.

@Test



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.

@Test



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.



上面的这几个时我遇到几个情况。如果大牛有更好的做法,欢迎指点。