001-JUnit之断言assert

一、简介以及pom

JUnit4.4引入了Hamcrest框架，Hamcest提供了一套匹配符Matcher，这些匹配符更接近自然语言，可读性高，更加灵活；
使用全新的断言语法：assertThat，结合Hamcest提供的匹配符，只用这一个方法，就可以实现所有的测试；

pom引入

        <!--单元测试使用-->

        <dependency>

            <groupId>junit</groupId>

            <artifactId>junit</artifactId>

            <version>4.12</version>

            <scope>test</scope>

        </dependency>

        <dependency>

            <groupId>org.hamcrest</groupId>

            <artifactId>hamcrest-library</artifactId>

            <version>2.1</version>

            <scope>test</scope>

        </dependency>

        <dependency>

            <groupId>org.hamcrest</groupId>

            <artifactId>hamcrest-core</artifactId>

            <version>2.1</version>

            <scope>test</scope>

        </dependency>

二、语法简介

assertThat语法如下：

    assertThat(T actual, Matcher<T> matcher);

    assertThat(String reason, T actual, Matcher<T> matcher);

其中actual为需要测试的变量，matcher为使用Hamcrest的匹配符来表达变量actual期望值的声明；

示例

assertThat(frank.changeUserInfo(),equalTo("男"));

注意事项

　　1. 必须导入JUnit4.4之后的版本才能使用assertThat方法；

　　2. 不需要继承TestCase类，但是需要测试方法前必须加“@Test”

三、assertThat使用

3.1、一般匹配方法

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

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

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

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

5、取反判断
assertThat( testedString, not( “developerWorks” ) );
注释：not匹配符和is匹配符正好相反，表明如果前面待测的object不等于后面给出的object，则测试通过

3.2、字符串相关匹配符

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”则测试通过，注意：字符串中的空格不能被忽略

3.3、数值相关匹配符

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则测试通过

3.4、collection相关匹配符

1、map包含测试
assertThat( mapObject, hasEntry( “key”, “value” ) );
注释：hasEntry匹配符表明如果测试的Map对象mapObject含有一个键值为”key”对应元素值为”value”的Entry项则测试通过

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

3、map包含key测试
assertThat( mapObject, hasKey ( “key” ) );
注释： hasKey匹配符表明如果测试的Map对象mapObject含有键值“key”则测试通过

4、map包含value测试
assertThat( mapObject, hasValue ( “key” ) );
注释：hasValue匹配符表明如果测试的Map对象mapObject含有元素值“value”则测试通过