JUnit单元测试之各断言

JUnit单元测试之断言整理

---

一、常用断言（Assert类的assert方法）

1、assertArrayEquals([String message],expecteds, actuals)

查看两个数组是否相等。

2、assertEquals([String message],expected, actual)

查看两个对象是否相等。类似于字符串比较使用的equals()方法
函数原型1：assertEquals([String message],expected,actual) 
函数原型2：assertEquals([String message],expected,actual,tolerance) 
参数说明： message是个可选的消息，假如提供，将会在发生错误时报告这个消息。 
expected是期望值，通常都是用户指定的内容。 actual是被测试的代码返回的实际值。
tolerance是误差参数，参加比较的两个浮点数在这个误差之内则会被认为是相等的。 

3、assertNotEquals([String message],first, second)

查看两个对象是否不相等。

4、assertNull([String message],object)

该断言用来验证给定的对象是否为null，假如不为null，则验证失败
函数原型：assertNull([String message],Object object) 
参数说明： message是个可选的消息，假如提供，将会在发生错误时报告这个消息。 object是待验证的对象。 

5、assertNotNull([String message],object)

查看对象是否不为空。

6、assertSame([String message],expected, actual)

查看两个对象的引用是否相等（expected参数和actual参数所引用的是否是同一个对象）。类似于使用“==”比较两个对象

7、assertNotSame([String message],unexpected, actual)

查看两个对象的引用是否不相等。类似于使用“!=”比较两个对象

8、assertTrue([String message],condition)

查看运行结果是否为true。

9、assertFalse([String message],condition)

查看运行结果是否为false。

10、assertThat(actual, matcher)

查看实际值是否满足指定的条件

11、fail()

让测试失败，该断言会使测试立即失败，通常用在测试不能达到的分支上（如异常）。

---

JUnit中 assertThat 的使用

㈠ 一般匹配符

1、allOf

 匹配符表明如果接下来的所有条件必须都成立测试才通过，相当于“与”（&&）
assertThat( testedNumber, allOf( greaterThan(8), lessThan(16) ) );

2、anyOf

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

3、anything

匹配符表明无论什么条件，永远为true
assertThat( testedNumber, anything() );

4、is

匹配符表明如果前面待测的object等于后面给出的object，则测试通过

assertThat( testedString, is( “developerWorks” ) );
5、not

匹配符和is匹配符正好相反，表明如果前面待测的object不等于后面给出的object，则测试通过
assertThat( testedString, not( "developerWorks" ) );

㈡ 字符串相关匹配符

---

1、containsString

 匹配符表明如果测试的字符串testedString 包含 子字符串"developerWorks"则测试通过
 assertThat( testedString, containsString( "developerWorks" ) );

2、endsWith

 匹配符表明如果测试的字符串testedString以子字符串"developerWorks"结尾则测试通过
 assertThat( testedString, endsWith( "developerWorks" ) ); 

3、startsWith

 匹配符表明如果测试的字符串testedString以子字符串"developerWorks"开始则测试通过
 assertThat( testedString, startsWith( "developerWorks" ) ); 

4、equalTo

 匹配符表明如果测试的testedValue等于expectedValue则测试通过，equalTo可以测试数值之间，字符串

 之间和对象之间是否相等，相当于Object的equals方法
 assertThat( testedValue, equalTo( expectedValue ) ); 

5、equalToIgnoringCase

 匹配符表明如果测试的字符串testedString在忽略大小写的情况下等于"developerWorks"则测试通过
 assertThat( testedString, equalToIgnoringCase( "developerWorks" ) ); 

6、equalToIgnoringWhiteSpace

 匹配符表明如果测试的字符串testedString在忽略头尾的任意个空格的情况下等于"developerWorks"则

 测试通过，注意：字符串中的空格不能被忽略
 assertThat( testedString, equalToIgnoringWhiteSpace( "developerWorks" ) );

---

㈢ 数值相关匹配符

1、closeTo

 匹配符表明如果所测试的浮点型数testedDouble在20.0±0.5范围之内则测试通过
 assertThat( testedDouble, closeTo( 20.0, 0.5 ) );

2、greaterThan

 匹配符表明如果所测试的数值testedNumber大于16.0则测试通过
 assertThat( testedNumber, greaterThan(16.0) );

3、lessThan

 匹配符表明如果所测试的数值testedNumber小于16.0则测试通过
 assertThat( testedNumber, lessThan (16.0) );

4、greaterThanOrEqualTo

 匹配符表明如果所测试的数值testedNumber大于等于16.0则测试通过
 assertThat( testedNumber, greaterThanOrEqualTo (16.0) );

5、lessThanOrEqualTo

 匹配符表明如果所测试的数值testedNumber小于等于16.0则测试通过
 assertThat( testedNumber, lessThanOrEqualTo (16.0) );

---

㈣ collection相关匹配符

1、hasEntry

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

2、hasItem

 匹配符表明如果测试的迭代对象iterableObject含有元素“element”项则测试通过
 assertThat( iterableObject, hasItem ( "element" ) );

3、hasKey

 匹配符表明如果测试的Map对象mapObject含有键值“key”则测试通过
 assertThat( mapObject, hasKey ( "key" ) );

4、hasValue

 匹配符表明如果测试的Map对象mapObject含有元素值“value”则测试通过
 assertThat( mapObject, hasValue ( "value" ) );

---