assertThat使用方法

assertThat使用方法，转载自：http://hi.baidu.com/shenhuanyu09/item/2bcfcb981aa3188e581461b4

 

 

一般匹配符
1、assertThat( testedNumber, allOf( greaterThan(8), lessThan(16) ) );

 

注释： allOf匹配符表明如果接下来的所有条件必须都成立测试才通过，相当于“与”（&&）

 

2、assertThat( testedNumber, anyOf( greaterThan(16), lessThan(8) ) );

 

注释：anyOf匹配符表明如果接下来的所有条件只要有一个成立则测试通过，相当于“或”（||）
3、assertThat( testedNumber, anything() );

 

注释：anything匹配符表明无论什么条件，永远为true
4、assertThat( testedString, is( "developerWorks" ) );

 

注释： is匹配符表明如果前面待测的object等于后面给出的object，则测试通过
5、assertThat( testedString, not( "developerWorks" ) );

 

注释：not匹配符和is匹配符正好相反，表明如果前面待测的object不等于后面给出的object，则测试通过

字符串相关匹配符
1、assertThat( testedString, containsString( "developerWorks" ) );

 

注释：containsString匹配符表明如果测试的字符串testedString包含子字符串"developerWorks"则测试通过

 

2、assertThat( testedString, endsWith( "developerWorks" ) ); 

 

注释：endsWith匹配符表明如果测试的字符串testedString以子字符串"developerWorks"结尾则测试通过

 

3、assertThat( testedString, startsWith( "developerWorks" ) ); 

 

注释：startsWith匹配符表明如果测试的字符串testedString以子字符串"developerWorks"开始则测试通过

 

4、assertThat( testedValue, equalTo( expectedValue ) ); 

 

注释： equalTo匹配符表明如果测试的testedValue等于expectedValue则测试通过，equalTo可以测试数值之间，字
符串之间和对象之间是否相等，相当于Object的equals方法

 

5、assertThat( testedString, equalToIgnoringCase( "developerWorks" ) ); 

 

注释：equalToIgnoringCase匹配符表明如果测试的字符串testedString在忽略大小写的情况下等于"developerWorks"则测试通过

 

6、assertThat( testedString, equalToIgnoringWhiteSpace( "developerWorks" ) );

 

注释：equalToIgnoringWhiteSpace匹配符表明如果测试的字符串testedString在忽略头尾的任意个空格的情况下等

 

于"developerWorks"则测试通过，注意：字符串中的空格不能被忽略

 

数值相关匹配符

 

1、assertThat( testedDouble, closeTo( 20.0, 0.5 ) );

 

注释：closeTo匹配符表明如果所测试的浮点型数testedDouble在20.0±0.5范围之内则测试通过

 

2、assertThat( testedNumber, greaterThan(16.0) );

 

注释：greaterThan匹配符表明如果所测试的数值testedNumber大于16.0则测试通过

 

3、assertThat( testedNumber, lessThan (16.0) );

 

注释：lessThan匹配符表明如果所测试的数值testedNumber小于16.0则测试通过

 

4、assertThat( testedNumber, greaterThanOrEqualTo (16.0) );

 

注释： greaterThanOrEqualTo匹配符表明如果所测试的数值testedNumber大于等于16.0则测试通过

 

5、assertThat( testedNumber, lessThanOrEqualTo (16.0) );

 

注释：lessThanOrEqualTo匹配符表明如果所测试的数值testedNumber小于等于16.0则测试通过

 

collection相关匹配符

 

1、assertThat( mapObject, hasEntry( "key", "value" ) );

 

注释：hasEntry匹配符表明如果测试的Map对象mapObject含有一个键值为"key"对应元素值为"value"的Entry项则测试通过

 

2、assertThat( iterableObject, hasItem ( "element" ) );

 

注释：hasItem匹配符表明如果测试的迭代对象iterableObject含有元素“element”项则测试通过

 

3、assertThat( mapObject, hasKey ( "key" ) );

 

注释： hasKey匹配符表明如果测试的Map对象mapObject含有键值“key”则测试通过

 

4、assertThat( mapObject, hasValue ( "key" ) );

 

注释：hasValue匹配符表明如果测试的Map对象mapObject含有元素值“value”则测试通过

 

 

补充转载：转载务必注明出处Taobao QA Team，原文地址：http://qa.taobao.com/?p=3541

 

 

 

1. 引言
JUnit4提供的新断言语法具有很多优点且使用简单，这已经不再是新鲜事了，可发现在实际测试代码中仍未被普及应用，特发此文，以期更多的人能掌握运用。
2. assertThat基本语法
Hamcrest 是一个测试辅助工具，提供了一套通用的匹配符 Matcher，灵活使用这些匹配符定义的规则，程序员可以更加精确的表达自己的测试思想，指定所想设定的测试条件。
Junit4结合Hamcrest提供了新的断言语句-assertThat，只需一个assertThat语句，结合Hamcrest提供的匹配符，就可以表达全部的测试思想。
assertThat的基本语法如下：

 

assertThat(T actual, Matcher matcher)
assertThat(String reason, T actual, Matcher matcher)

 

actual 是接下来想要验证的值；
matcher是使用 Hamcrest 匹配符来表达的对前面变量所期望的值的声明，如果 actual值与 matcher 所表达的期望值相符，则断言成功，否则断言失败。
reason是自定义的断言失败时显示的信息。
一个简单的例子：
// 如果测试的字符串testedString包含子字符串"taobao"则断言成功
assertThat( testedString, containsString( "taobao" ) );
3. assertThat优点

 

统一

 

只需一条 assertThat语句即可替代旧有的其他语句（如 assertEquals，assertNotSame，assertFalse，assertTrue，assertNotNull，assertNull 等），使断言变得简单、代码风格统一，增强测试代码的可读性和可维护性。
n

 

语法直观易懂

 

assertThat 不再像 assertEquals 那样，使用比较难懂的“谓宾主”语法模式（如：assertEquals(3, x);）。相反，assertThat 使用了类似于“主谓宾”的易读语法模式（如：assertThat(x,is(3));），使得代码更加直观、易读，符合人类思维习惯。
n

 

错误信息更具描述性

 

旧的断言语法如果断言失败，默认不会有额外的提示信息，如
assertTrue(testedString.indexOf(“taobao”) > -1);
如果该断言失败，只会抛出无用的错误信息，如java.lang.AssertionError: ，除此之外不会有更多的提示信息。
新的断言语法会默认自动提供一些可读的描述信息，如
assertThat(testedString, containsString(“taobao”));
如果该断言失败，抛出的错误提示信息如下：
java.lang.AssertionError:
Expected: a string containing “taobao”
got: “taoba”

 

n

 

跟Matcher匹配符联合使用更灵活强大

 

Matcher提供了功能丰富的匹配符，assertThat结合这些匹配符使用可更灵活更准确的表达测试思想。
// 验证字符串 s是否含有子字符串 "taobao" 或 "qa" 中间的一个
// 旧的断言，不直观，需要分析代码逻辑明白验证意图
assertTrue(s.indexOf("taobao")>-1||s.indexOf("qa")>-1);
// 新的断言，直观易懂，准确表达测试思想
assertThat(s,anyOf(containsString("taobao"),containsString("qa")));
// anyOf满足条件之一即成立，containsString包含字符串则成立
4. assertThat使用
要想发挥assetThat的威力，必须跟Hamcrest联合使用，JUnit4本身包含了一些自带了一些 Hamcrest 的匹配符 Matcher，但是只有有限的几个。因此建议你将Hamcrest包加入项目。
在pom里加入Hamcrest依赖。
<dependency>
<groupId>org.hamcrest</groupId>
<artifactId>hamcrest-all</artifactId>
<version>1.1</version>
</dependency>
在测试类里导入包
import static org.junit.Assert.*;
import static org.hamcrest.Matchers.*;
通过例子学习是有效的学习方式之一，下面通过常用的示例演示如何使用assertThat，更详细的用法请参考Hamcrest相关文档。

 

字符相关匹配符
/**equalTo匹配符断言被测的testedValue等于expectedValue，
* equalTo可以断言数值之间，字符串之间和对象之间是否相等，相当于Object的equals方法
*/
assertThat(testedValue, equalTo(expectedValue));
/**equalToIgnoringCase匹配符断言被测的字符串testedString
*在忽略大小写的情况下等于expectedString
*/
assertThat(testedString, equalToIgnoringCase(expectedString));
/**equalToIgnoringWhiteSpace匹配符断言被测的字符串testedString
*在忽略头尾的任意个空格的情况下等于expectedString，
*注意：字符串中的空格不能被忽略
*/
assertThat(testedString, equalToIgnoringWhiteSpace(expectedString);
/**containsString匹配符断言被测的字符串testedString包含子字符串subString**/
assertThat(testedString, containsString(subString) );
/**endsWith匹配符断言被测的字符串testedString以子字符串suffix结尾*/
assertThat(testedString, endsWith(suffix));
/**startsWith匹配符断言被测的字符串testedString以子字符串prefix开始*/
assertThat(testedString, startsWith(prefix));
一般匹配符
/**nullValue()匹配符断言被测object的值为null*/
assertThat(object,nullValue());
/**notNullValue()匹配符断言被测object的值不为null*/
assertThat(object,notNullValue());
/**is匹配符断言被测的object等于后面给出匹配表达式*/
assertThat(testedString, is(equalTo(expectedValue)));
/**is匹配符简写应用之一，is(equalTo(x))的简写，断言testedValue等于expectedValue*/
assertThat(testedValue, is(expectedValue));
/**is匹配符简写应用之二，is(instanceOf(SomeClass.class))的简写，
*断言testedObject为Cheddar的实例
*/
assertThat(testedObject, is(Cheddar.class));
/**not匹配符和is匹配符正好相反，断言被测的object不等于后面给出的object*/
assertThat(testedString, not(expectedString));
/**allOf匹配符断言符合所有条件，相当于“与”（&&）*/
assertThat(testedNumber, allOf( greaterThan(8), lessThan(16) ) );
/**anyOf匹配符断言符合条件之一，相当于“或”（||）*/
assertThat(testedNumber, anyOf( greaterThan(16), lessThan(8) ) );
数值相关匹配符
/**closeTo匹配符断言被测的浮点型数testedDouble在20.0¡À0.5范围之内*/
assertThat(testedDouble, closeTo( 20.0, 0.5 ));
/**greaterThan匹配符断言被测的数值testedNumber大于16.0*/
assertThat(testedNumber, greaterThan(16.0));
/** lessThan匹配符断言被测的数值testedNumber小于16.0*/
assertThat(testedNumber, lessThan (16.0));
/** greaterThanOrEqualTo匹配符断言被测的数值testedNumber大于等于16.0*/
assertThat(testedNumber, greaterThanOrEqualTo (16.0));
/** lessThanOrEqualTo匹配符断言被测的testedNumber小于等于16.0*/
assertThat(testedNumber, lessThanOrEqualTo (16.0));
集合相关匹配符
/**hasEntry匹配符断言被测的Map对象mapObject含有一个键值为"key"对应元素值为"value"的Entry项*/
assertThat(mapObject, hasEntry("key", "value" ) );
/**hasItem匹配符表明被测的迭代对象iterableObject含有元素element项则测试通过*/
assertThat(iterableObject, hasItem (element));
/** hasKey匹配符断言被测的Map对象mapObject含有键值“key”*/
assertThat(mapObject, hasKey ("key"));
/** hasValue匹配符断言被测的Map对象mapObject含有元素值value*/
assertThat(mapObject, hasValue(value));