JAVA常用测试框架

要做好测试驱动开发,意识习惯最重要,其次也得回编写优雅的单元测试。java测试框架很多,各种断言和注解,有点混乱,编写测试时老师搞不清该用哪个。

本文简单梳理java常用的几个测试工具:Junit,AssertJ,hamcrest,Mockito,JSONassert。

一、Junit

Junit可以说是java测试的标准,谁都知道,经常用,或者在其他框架下使用。但一般只用到几个注解(@Test,@Before,@After)和断言。

API

Assert: 断言的方法集合
TestCase:运行多重测试的固定装置
TestResult: 执行测试样例的结果
TestSuite: 测试集合

注解

  • @Test:测试方法标志
  • @RunWith: 套件测试
    java @RunWith(Suite.class) @Suite.SuiteClasses({ TestJunit1.class, TestJunit2.class }) public class JunitTestSuite { }
  • @Ignore: 忽略测试
  • @test(timeout): 测试用例执行时间超时失败
  • @Test(expected = xxException.class):异常断言
  • @Parameters: 测试数据集合
  • @Rule:有点像拦截器,可以自己定义。
  • @DisplayName: 测试用例名字(junit 5)

断言

  1. assertEquals
  2. assertSame
  3. assertTrue
  4. assertNull
    还有些其他扩展用法和注解,其不一一。

二、AssertJ

java流式断言库。

@Test
    public void assartJTest() {
        assertThat("Frodo").isEqualTo("Frodo").isEqualToIgnoringCase("frodo");
        assertThat(42).isGreaterThan(38).isGreaterThanOrEqualTo(38);
        assertThat(Dates.parse("2014-02-01"))
                .isEqualTo("2014-02-01")
                .isNotEqualTo("2014-01-01")
                .isAfter("2014-01-01").isBefore(Dates.parse("2014-03-01"));
        assertThat(newArrayList(1, 2, 3))
                .contains(1, atIndex(0))
                .contains(2, atIndex(1))
                .contains(3).isSorted();
        assertThat(RequestMapping.class).isAnnotation();
        assertThat("string").isInstanceOf(String.class);
    }

从以上示例可知,它可以对java基本数据结构、List、Map、Class进行流式断言。

三、 Hamcrest

Hamcrest 是一个测试的框架,它提供了一套通用的匹配符 Matcher,灵活使用这些匹配符定义的规则,程序员可以更加精确的表达自己的测试思想,指定所想设定的测试条件。
都通过assertThat灵活匹配各种类型数据,下面是一些基本示例。

@Test
    public void sampleTest() {
        int a = 12;
        assertThat(a, is(12));
        assertThat(a, not(11));
        assertThat(a, greaterThan(1));

        String str = "Hello World";
        assertThat(str,containsString("Hello"));
        assertThat(str,equalToIgnoringCase("hello world"));

        List<String> stringList = new ArrayList<>();
        stringList.add("e1");
        stringList.add("e2");
        assertThat(stringList, hasItem("e1"));
        assertThat(stringList, anything());
    }

Hamcrest自带了很多匹配器,如果不能满足,还可以自定义。

四、Mockito 

上面列出的框架主要是断言,从名字知道,Mockito 是一个mock工具,用于模拟各种对象和组件,使单元测试更加独立。

Mockito可以模拟对象,模拟函数返回值,模拟void类型的异常,验证函数执行次数和顺序,对参数进行匹配和捕获。

@Test
    public void mockSample(){
        ArrayList mockList = mock(ArrayList.class);
        //stubbing
        when(mockList.get(0)).thenReturn("first").thenReturn("second");
        assertThat(mockList.get(0)).isEqualTo("first");
        assertThat(mockList.get(0)).isEqualTo("second");

        when(mockList.get(anyInt())).thenReturn("element");
        assertThat(mockList.get(0)).isEqualTo("element");
        mockList.add("third");
        mockList.clear();
        mockList.clear();

        //veryfy 执行次数
        verify(mockList,times(1)).add("third");
        verify(mockList,times(2)).clear();
        verify(mockList,atLeastOnce()).clear();

        doThrow(new RuntimeException()).when(mockList).clear();
    }

mockito 功能很多很强大,其不一一,后面又时间再补充或专门总结。还有很多实用的注解。

五、JSONassert

除了协议层的Json格式,好多地方都用到json作为数据传递格式,JSONassert是一个专门用于json断言的工具。

语法:

JSONAssert.assertEquals(expectedJSON, actualJSON, strictMode);

示例

 @Test
    public void test() throws Exception {
        //get json from server
        //language=JSON
        String jsonStr ="{\"id\":1,\"name\":\"thoreau\"}";
        JSONAssert.assertEquals("{id:1}", jsonStr, false);
//        JSONAssert.assertEquals("{id:1}", jsonStr, true);//fail
        JSONAssert.assertEquals("{id:1,name:thoreau}", jsonStr, true);
    }

结果JsonPath多读取匹配验证如:

String jsonStr ="{\"id\":1,\"name\":\"thoreau\",\"hobbies\":[\"writing\",\"music\",\"tennis\"]}";
String hobby = JsonPath.parse(jsonStr).read("$.hobbies[2]");
assertThat(hobby).isEqualTo("tennis");

java测试框架何其多,但这几个是比较常用、强大且优雅的,因此也都集成到spring-test。如果使用spring,添加spring-test的依赖,所有这些jar包都不需要引入了。

CONTENTS