26.单元测试
springboot2.2.0版本开始引入junit5作为单元测试默认库
junit5的常用注解：参考地址：https://junit.org/junit5/docs/current/user-guide/
1.@Display:为测试类或者测试方法设置展示名称
public class SpringBootJunit5Test {
@Test
@DisplayName("测试1：测试DisplayName注解(为测试类或者测试方法设置展示名称)")
void test1(){
System.out.println("测试DisplayName注解(为测试类或者测试方法设置展示名称)");
}
}运行情况如下：
2.@BeforeEach:表示每个单元测试方法执行前执行
3.@AfterEach：表示每个单元测试方法执行完成后执行
4.@BeforeAll：表示在所有单元测试方法前执行，整个只执行一遍
5.@AfterAll：表示在所有单元测试方法执行完毕后执行，整个只执行一遍
6.@Disabled：可以标注在类或者方法上，表示该类或者该方法不执行
样例：
public class SpringBootJunit5Test {
@Test
@DisplayName("测试1：测试DisplayName注解(为测试类或者测试方法设置展示名称)")
void test1(){
System.out.println("测试DisplayName注解(为测试类或者测试方法设置展示名称)");
}
@BeforeEach
void test2(){
System.out.println("每个测试方法前运行...");
}
@Test
void test3(){
System.out.println("测试方法运行...");
}
@AfterEach
void test4() {
System.out.println("每个测试方法执行完执行...");
}
@BeforeAll
static void test5() {
System.out.println("所有测试方法前运行...");
}
@AfterAll
static void test6() {
System.out.println("所有测试方法完成后运行");
}
@Disabled
void test7() {
System.out.println("该方法不执行");
}
}
输出：
所有测试方法前运行...(发现@BeforeAll标注的方法开始只执行一遍)
每个测试方法前运行...
测试DisplayName注解(为测试类或者测试方法设置展示名称)
每个测试方法执行完执行...
每个测试方法前运行...
测试方法运行...
每个测试方法执行完执行...
所有测试方法完成后运行(发现@AfterAll标注的方法最后只执行一遍)
7.@Timeout(value = 5,unit = TimeUnit.SECONDS)，设置超时时间
用法示例：
@Timeout(value = 5,unit = TimeUnit.SECONDS)
void test8() throws InterruptedException {
Thread.sleep(6);
System.out.println("测试超时...");
}
8.如果需要使用springboot容器中的东西
在类上加上该标签：@SpringBootTest
样例：
@SpringBootTest
public class SpringBootJunit5Test {
...
}
@SpringBootTest标签详解：@ExtendWith标签--->为测试类或者测试方法提供扩展类引用
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@BootstrapWith(SpringBootTestContextBootstrapper.class)
@ExtendWith({SpringExtension.class})
public @interface SpringBootTest {
...
}
9. @RepeatedTest(5)设置重复执行次数
样例如下
@RepeatedTest(5)
void test9() {
System.out.println("设置重复次数..");
}
该方法会重复执行5次断言
断言：
断言(assertions)是测试方法中的核心部分，用来对测试需要满足的条件进行验证。这些断言方法都是org.junit.jupiter.Assertions的静态方法
junit5的内置断言机制可以分为以下的几种类别
检查业务逻辑返回的数据是否合理！！！！
1.简单断言(对单个值进行简单的验证)
1.1 assertEquals(判断两个对象或者两个原始类型(如int，double，booleab等)是否相同)
使用样例：
public class SpringBootJunit5Test {
@Test
@DisplayName("测试断言机制")
void test() {
//此处肯定出错，因为3！=2+2
//第一个参数是：预期结果
//第二个参数是：业务逻辑返回参数
//第三个参数是：断言失败后的错误信息
Assertions.assertEquals(3, sum(2, 2),"返回结果跟预期不同...");
}
/**
* 模拟的业务逻辑
*/
int sum(int a,int b){
return a+b;
}
}
结论：如果断言成功，控制台不会输出什么
但是如果断言失败，控制台输出：
org.opentest4j.AssertionFailedError: 返回结果跟预期不同... ==> (输出的错误信息)
Expected :3(预期结果)
Actual :4(返回结果)
<Click to see difference>
at org.junit.jupiter.api.AssertionUtils.fail(AssertionUtils.java:55)
...
1.2assertNotEquals(判断两个对象或者两个原始类型是否不相等)
1.3assertSame(判断两个对象的引用是否指向同一个对象)
1.4assertNotSame(判断两个对象的引用是否指向两个不同的对象)
1.5assertTrue(判断给定的值是否是true)
1.6assertFalse(判断给定的值是否为false)
1.7assertNull(判断给定对象的引用是否为NULL)
1.8assertNotNull(判断给定对象的引用是否不为null)
注意点：
同一个方法中，如果断言执行失败，后续代码不会执行
例如：
@Test
@DisplayName("测试断言机制")
void test() {
Assertions.assertEquals(3, sum(2, 2),"返回结果跟预期不同...");
System.out.println("第一个断言执行完成");---------------------->不会执行
Assertions.assertEquals(4, sum(2, 2),"返回结果跟预期不同...");---->不会执行
}
2.数组断言
通过assertArrayEquals方法判断两个对象或原始类型的数组是否相同
@Test
@DisplayName("测试断言机制")
void test() {
Assertions.assertArrayEquals(new int[]{1,2}, new int[]{1,2});
}
断言成功，两个数组的元素相同，控制台不输出什么
但是如果把预期的数组元素顺序打乱
@Test
@DisplayName("测试断言机制")
void test() {
Assertions.assertArrayEquals(new int[]{2,1}, new int[]{1,2}，"数组不同..");
}
此时控制台输出：
会输出在第一个元素上就不同了..
org.opentest4j.AssertionFailedError: 数组不同.. ==> array contents differ at index [0], expected: <2> but was: <1>
at org.junit.jupiter.api.AssertionUtils.fail(AssertionUtils.java:39)
at org.junit.jupiter.api.AssertArrayEquals.failArraysNotEqual(AssertArrayEquals.java:432)
...
3.组合断言
assertAll方法接受多个org.junit.jupiter.api.Executable函数式接口的示例作为要验证的断言，可以通过lambda表达式很容易的提供这些断言
测试用例：
@Test
@DisplayName("测试组合断言")
void test1(){
//第一个参数，头消息(相当于标记)，后面的参数就是需要的断言
Assertions.assertAll("Math",
() -> Assertions.assertEquals(3, 1+1),
() -> Assertions.assertTrue(1>2)
);
//如果组合断言的任何一个除了问题，下述都不会执行
System.out.println("整体断言执行完毕");
}
此时输出：
expected: <3> but was: <2>
Comparison Failure:
Expected :3
Actual :2
<Click to see difference>
expected: <true> but was: <false>
Comparison Failure:
Expected :true
Actual :false
<Click to see difference>
org.opentest4j.MultipleFailuresError: Math (2 failures)
org.opentest4j.AssertionFailedError: expected: <3> but was: <2>
org.opentest4j.AssertionFailedError: expected: <true> but was: <false>
...
结论:发现组合断言都会执行，但是组合断言如果其中一个出错，断言后面的代码不会执行
4.异常断言
在junit4时期，想要测试方法的异常情况时，需要用@Rule注解的ExpectedException变量还是比较麻烦的。二junit5提供的断言方式Assertions.assertThrows(),配合函数时编程就可以进行使用
判断抛出某种异常！
@DisplayName("异常断言")
@Test
void testException(){
//断定业务逻辑一定会出现某种异常
Assertions.assertThrows(ArithmeticException.class, () ->{
int i=10/2;
},"业务逻辑居然不抛出异常！");
}
判断是否会抛出异常，
1.抛出异常时断言成功
2.不抛出异常时断言失败
org.opentest4j.AssertionFailedError: 业务逻辑居然不抛出异常！ ==> Expected java.lang.ArithmeticException to be thrown, but nothing was thrown.
at org.junit.jupiter.api.AssertThrows.assertThrows(AssertThrows.java:71)
at org.junit.jupiter.api.AssertThrows.assertThrows(AssertThrows.java:41)
at org.junit.jupiter.api.Assertions.assertThrows(Assertions.java:3023)
5.超时断言
junit5还提供Assertions.assertTimesout()为测试方法设置了超时时间
示例如下：
@Test
@DisplayName("超时断言测试")
void timeouttest(){
//如果测试方法超过1s将会异常
Assertions.assertTimeout(Duration.ofMillis(1000), () ->{
Thread.sleep(2000);
});
}
判断测试方法的执行时间在超时时间内，如果超时，会断言失败
6.快速失败
通过fail方法直接使测试失败
样例：
@Test
@DisplayName("测试失败fail")
void testFail(){
if(2==2){
Assertions.fail("This should fail");
}
}
控制台输出：
org.opentest4j.AssertionFailedError: This should fail
at org.junit.jupiter.api.AssertionUtils.fail(AssertionUtils.java:39)
at org.junit.jupiter.api.Assertions.fail(Assertions.java:117)
at com.wmd.springboot.SpringBootJunit5Test.testFail(SpringBootJunit5Test.java:55)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
参数化测试
参数化测试是JUnit5很重要的一个特性，它使得用不同的参数多次运行测试成为了可能，也为我们的单元测试带来了许多便利
利用@ValueSource等注解，指定入参，我们将可以使用不同的参数进行多次单元测试，而不需要每新增一个参数或新增加一个单元测试，省去了很多的多余代码
1.@ValueSource：为参数化测试指定入参来源，支持八大基础类以及String类型,Class类型
样例如下：
@DisplayName("参数化测试")
@ParameterizedTest
@ValueSource(ints={1,2,3,4,5})
void testParm(int i){
System.out.println(i);
}
测试结果如下：
1
2
3
4
5
结论：等于将入参中的ints{1,2,3,4,5}分别代入方法分别测试
2.@NulllSource:表示为参数化测试提供一个null的入参那
3.@EnumSource：表示为参数化测试提供一个枚举值
4.CsvFileSource:表示读取指定CSV文件中的内容作为参数测试入参
5.@MethodSource:表示读取指定方法的返回值作为参数化测试入参(注意方法返回需要是一个流)
样例如下：
@ParameterizedTest
@DisplayName("方法来源参数测试")
@MethodSource("method")
void testWithExplictitLocalMethodSource(String name){
System.out.println(name);
Assertions.assertNotNull(name);
}
static Stream<String> method(){
return Stream.of("apple","bannna");
}
}
