• 单元测试JUnit 4 (一)——keeps the bar green to keeps the code clean


    1. 导读

    Junit是一个可编写重复测试的简单框架,是基于Xunit架构的单元测试框架的实例。Junit4最大的改进是大量使用注解(元数据),很多实际执行过程都在Junit的后台做完了,而且写test case 的类不需要继承TestCase,只需要在所要做test case的方法前加@Test 注解即可。

    JUnit 4不再要求方法的名字,可以给测试方法任意命名,但是为了可读性,还是建议以test开头命名,如JUnit 3要求的那样。

    2. assertThat基本语法

      2.1  首先参照常规的assert用法

    import static org.junit.Assert.*;
    import org.junit.Test;
        @Test
        public void testAdd(){
            int z=new T().add(3,5);
            assertEquals(8,z);
            assertTrue(z>3);
            assertTrue("z is too small",z>10); 
        }

        2.2  常用assert

    assertEquals://用于判断实际值和期望值是否相同,assertEquals(预期值,实际值);
    assertSame://判断实际值和期望值是否为同一个对象
    assertArrayEquals(expecteds, actuals)    //查看两个数组是否相等。
    assertEquals(expected, actual)    //查看两个对象是否相等。类似于字符串比较使用的equals()方法
    assertNotEquals(first, second)        //查看两个对象是否不相等。
    assertNull(object)    //查看对象是否为空。
    assertNotNull(object)    //查看对象是否不为空。
    assertSame(expected, actual)       //查看两个对象的引用是否相等。类似于使用“==”比较两个对象
    assertNotSame(unexpected, actual)    //查看两个对象的引用是否不相等。类似于使用“!=”比较两个对象
    assertTrue(condition)    //查看运行结果是否为true。
    assertFalse(condition)    //查看运行结果是否为false。
    assertThat(actual, matcher)    //查看实际值是否满足指定的条件
    fail()     //让测试失败

          Hamcrest 是一个测试辅助工具,提供了一套通用的匹配符 Matcher,灵活使用这些匹配符定义的规则,程序员可以更加精确的表达自己的测试思想,

    指定所想设定的测试条件。
         Junit4结合Hamcrest提供了新的断言语句-assertThat,只需一个assertThat语句,结合Hamcrest提供的匹配符,就可以表达全部的测试思想。
    assertThat的基本语法如下:

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

    3. assertThat优点

    • 统一

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

    • 语法直观易懂

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

    • 错误信息更具描述性
      //旧的断言语法如果断言失败,默认不会有额外的提示信息,如
      assertTrue(testedString.indexOf(“taobao”) > -1);
      //如果该断言失败,只会抛出无用的错误信息,如java.lang.AssertionError: ,除此之外不会有更多的提示信息。
      //新的断言语法会默认自动提供一些可读的描述信息,如
      assertThat(testedString, containsString(“taobao”));
      //如果该断言失败,抛出的错误提示信息如下:
      Java.lang.AssertionError:
      Expected: a string containing “taobao”
      got: “taoba”
    • 跟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包加入项目。

          注意事项:
            a.必须导入JUnit4.4之后的版本才能使用assertThat方法;
            b.不需要继承TestCase类,但是需要测试方法前必须加“@Test”。
            c.需要导入Hamcrest类库:hamcrest-core-xxx.jar  |   hamcrest-library-xxx.jar
            在pom.xml文件里加入Hamcrest依赖。(Maven)
    • <dependency>
      <groupId>org.hamcrest</groupId>
      <artifactId>hamcrest-all</artifactId>
      <version>1.1</version>
      </dependency>

            在测试类里导入包

      import static org.junit.Assert.*;
      import static org.hamcrest.Matchers.*;

           4.1 字符相关匹配符

    • /**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));

           4.2 一般匹配符

    • /**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) ) );

           4.3 数值相关匹配符

    • /**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));

        4.4 集合相关匹配符

    • /**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));

    附:报错  java.lang.SecurityException: class "org.hamcrest.Matchers"'s signer information does not match signe...解决

         把原来eclipse中的junit.jar包去掉,自己引入 新的jar包

  • 相关阅读:
    大数据开发,Hadoop Spark太重?你试试esProc SPL
    不需要服务器,教你仅用30行代码搞定实时健康码识别
    学python,怎么能不学习scrapy呢!
    如何面向对象编程?程序员:我也要先有“对象”啊
    5种kafka消费端性能优化方法
    内存问题难定位,那是因为你没用ASAN
    基于DMS的数仓智能运维服务,知多少?
    云图说丨初识华为云微服务引擎CSE
    CC2530_ZigBee+华为云IOT:设计一套属于自己的冷链采集系统
    nacos config 及 自动刷新注解
  • 原文地址:https://www.cnblogs.com/zjfjava/p/6604055.html
Copyright © 2020-2023  润新知