要做好测试驱动开发,意识习惯最重要,其次也得回编写优雅的单元测试。java测试框架很多,各种断言和注解,有点混乱,编写测试时老师搞不清该用哪个。
本文简单梳理java常用的几个测试工具:Junit,AssertJ,hamcrest,Mockito,JSONassert。
一、Junit
Junit可以说是java测试的标准,谁都知道,经常用,或者在其他框架下使用。但一般只用到几个注解(@Test,@Before,@After)和断言。
API
Assert: 断言的方法集合 TestCase:运行多重测试的固定装置 TestResult: 执行测试样例的结果 TestSuite: 测试集合
注解
- @Test:测试方法标志
- @RunWith: 套件测试
@RunWith(Suite.class)
@Suite.SuiteClasses({
TestJunit1.class,
TestJunit2.class
})
public class JunitTestSuite {
}
- @Ignore: 忽略测试
- @test(timeout): 测试用例执行时间超时失败
- @Test(expected = xxException.class):异常断言
- @Parameters: 测试数据集合
- @Rule:有点像拦截器,可以自己定义。
- @DisplayName: 测试用例名字(junit 5)
断言
- assertEquals
- assertSame
- assertTrue
- 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包都不需要引入了。