适合设计师的网站,外贸网站怎么做会吸引眼球,全国招商代理项目,wordpress菜谱JUnit 5 学习笔记 1.JUnit5的改变2.JUnit5常用注解及测试2.1 DisplayName/Disabled/BeforeEach/AfterEach/BeforeAll/AfterAll2.2 Timeout2.3 RepeatedTest 3.断言3.1 简单断言3.2 数组断言3.3 组合断言3.4 异常断言3.5 超时断言3.6 快速失败 4.前置条件5.嵌套测试6.参数化测试… JUnit 5 学习笔记 1.JUnit5的改变2.JUnit5常用注解及测试2.1 DisplayName/Disabled/BeforeEach/AfterEach/BeforeAll/AfterAll2.2 Timeout2.3 RepeatedTest 3.断言3.1 简单断言3.2 数组断言3.3 组合断言3.4 异常断言3.5 超时断言3.6 快速失败 4.前置条件5.嵌套测试6.参数化测试6.1 ValueSource6.2. EnumSource6.3 CsvSource 和 CsvFileSource6.4. MethodSource 7.JUnit4 → Junit5 1.JUnit5的改变 JUnit 5 JUnit Platform JUnit Jupiter JUnit Vintage JUnit Platform: Junit Platform是在JVM上启动测试框架的基础不仅支持Junit自制的测试引擎其他测试引擎也都可以接入。 JUnit Jupiter: JUnit Jupiter提供了JUnit5的新的编程模型是JUnit5新特性的核心。内部包含了一个测试引擎用于在Junit Platform上运行。 JUnit Vintage: 由于JUint已经发展多年为了照顾老的项目JUnit Vintage提供了兼容JUnit4.x,Junit3.x的测试引擎。 2.JUnit5常用注解及测试 JUnit5的注解与JUnit4的注解有所变化 Test :表示方法是测试方法。但是与JUnit4的Test不同他的职责非常单一不能声明任何属性拓展的测试将会由Jupiter提供额外测试ParameterizedTest :表示方法是参数化测试下方会有详细介绍RepeatedTest :表示方法可重复执行下方会有详细介绍DisplayName :为测试类或者测试方法设置展示名称BeforeEach :表示在每个单元测试之前执行AfterEach :表示在每个单元测试之后执行 BeforeAll :表示在所有单元测试之前执行AfterAll :表示在所有单元测试之后执行Tag :表示单元测试类别类似于JUnit4中的CategoriesDisabled :表示测试类或测试方法不执行类似于JUnit4中的IgnoreTimeout :表示测试方法运行如果超过了指定时间将会返回错误ExtendWith :为测试类或测试方法提供扩展类引用 2.1 DisplayName/Disabled/BeforeEach/AfterEach/BeforeAll/AfterAll
SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {//----------------------------常用注解----------------------------
//DisplayName(测试DisplayName注解---方法1)Testpublic void testDisplayName1() {System.out.println(123);}DisabledDisplayName(测试DisplayName注解---方法2)Testpublic void testDisplayName2() {System.out.println(456);}BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);}
}我们再把 testDisplayName2 方法上的Disabled注解打开。可以看到这个测试方法已经被禁用了。 2.2 Timeout
package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);}DisplayName(测试Timeout注解)Timeout(value 5, unit TimeUnit.MILLISECONDS)Testpublic void testTimeout() throws InterruptedException {Thread.sleep(1000);}
}2.3 RepeatedTest
package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);}RepeatedTest(5)Testpublic void testRepeatedTest() {System.out.println(1);}
}3.断言 断言assertions是测试方法中的核心部分用来对测试需要满足的条件进行验证。这些断言方法都是org.junit.jupiter.api.Assertions 的静态方法。JUnit 5 内置的断言可以分成如下几个类别 3.1 简单断言 用来对单个值进行简单的验证。如 方法说明assertEquals判断两个对象或两个原始类型是否相等assertNotEquals判断两个对象或两个原始类型是否不相等assertSame判断两个对象引用是否指向同一个对象assertNotSame判断两个对象引用是否指向不同的对象assertTrue判断给定的布尔值是否为 trueassertFalse判断给定的布尔值是否为 falseassertNull判断给定的对象引用是否为 nullassertNotNull判断给定的对象引用是否不为 null
package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);}//----------------------------断言---------------------------- /** * 如果前面的断言失败则后面的代码不会再执行 * * */ DisplayName(测试简单断言)Testpublic void testSimpleAssertions() {int result cal(1, 2);assertEquals(5, result, 业务逻辑计算结果出错....);Object obj1 new Object();Object obj2 new Object();assertSame(obj1, obj2);}public int cal(int x, int y) {return x y;}
}assertEquals方法判断出运算结果不同也即此时第一个断言失败了那么后面的assertSame不会再执行。 当我们修改assertEquals方法使其断言成功那么后续的assertSame将会继续执行。 3.2 数组断言 通过 assertArrayEquals 方法来判断两个对象或原始类型的数组是否相等。 package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);} //----------------------------断言---------------------------- DisplayName(测试数组断言1)Testpublic void testArrayAssertions1() {assertArrayEquals(new int[]{1, 2}, new int[]{1, 2});}DisplayName(测试数组断言2)Testpublic void testArrayAssertions2() {assertArrayEquals(new int[]{3, 4}, new int[]{1, 2}, 数组内容不相等....);}
}3.3 组合断言 assertAll 方法接受多个 org.junit.jupiter.api.Executable 函数式接口的实例作为要验证的断言可以通过 lambda 表达式很容易的提供这些断言。 组合断言中当所有断言都成功时代码才会顺利向下执行。assertTrue虽然执行成功了但是assertEquals失败了所有下面的sout不会执行。 package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);} //----------------------------断言---------------------------- DisplayName((测试组合断言))Testpublic void testAllAssertions() {assertAll(testAll, () - assertTrue(true true),() - assertEquals(1, 2));//当以上两个断言全部成功时才会打印下面的内容 System.out.println(success!!!);}
}3.4 异常断言 在JUnit4时期想要测试方法的异常情况时需要用Rule注解的ExpectedException变量还是比较麻烦的。而JUnit5提供了一种新的断言方式Assertions.assertThrows() 配合函数式编程就可以进行使用。 package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);} //----------------------------断言---------------------------- DisplayName(测试异常断言)Testpublic void testExceptionAssertions() {assertThrows(ArithmeticException.class, () - {int i 10 / 2;//此时断言会执行 // int j 10 / 0; // 此时断言不会执行 }, 业务逻辑居然正常运行);}
}如果代码执行 int i 10 / 2 运行正确不会出现 ArithmeticException 异常所以此时assertThrows断言会执行。反之则不会执行。 3.5 超时断言 Junit5还提供了Assertions.assertTimeout() 为测试方法设置了超时时间。 package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);}DisplayName(测试超时断言)Testpublic void testTimeoutAssertions() {assertTimeout(Duration.ofMillis(1000), () - Thread.sleep(2000));}
}3.6 快速失败 通过 fail 方法直接使得测试失败。 package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);}DisplayName(快速失败)Testpublic void testFailAssertions() {System.out.println(1);System.out.println(2);fail(直接走人....);System.out.println(3);System.out.println(4);}
}4.前置条件 JUnit 5 中的前置条件assumptions【假设】类似于断言不同之处在于不满足的断言会使得测试方法失败而不满足的前置条件只会使得测试方法的执行终止。前置条件可以看成是测试方法执行的前提当该前提不满足时就没有继续执行的必要。 package com.szh.boot;import org.junit.jupiter.api.*;import java.time.Duration;
import java.util.concurrent.TimeUnit;import static org.junit.jupiter.api.Assertions.*;SpringBootTest
DisplayName(Junit5功能测试类)
public class TestJunit {BeforeEachpublic void testBeforeEach() {System.out.println(测试就要开始了....);}AfterEachpublic void testAfterEach() {System.out.println(测试已经结束了....);}BeforeAllpublic static void testBeforeAll() {System.out.println(所有测试就要开始了....);}AfterAllpublic static void testAfterAll() {System.out.println(所有测试已经结束了....);} //----------------------------前置条件---------------------------- DisplayName(测试前置条件)Testpublic void testAssumptions() {Assumptions.assumeTrue(true, 结果不是true....);System.out.println(111);}
}将 Assumptions.assumeTrue(false, “结果不是true…”); 中的 true 改为 false此时因为 true ! false所以不满足该前置条件则直接导致测试方法被终止执行。 5.嵌套测试 JUnit 5 可以通过 Java 中的内部类和Nested 注解实现嵌套测试从而可以更好的把相关的测试方法组织在一起。在内部类中可以使用BeforeEach 和AfterEach 注解而且嵌套的层次没有限制。 package com.szh.boot;import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;import java.util.EmptyStackException;
import java.util.Stack;import static org.junit.jupiter.api.Assertions.*;/*** 嵌套测试中外层的Test不能驱动内层的Before(After)Each/All之类的方法提前/之后运行 * 内层的Test可以驱动外层的Before(After)Each/All之类的方法提前/之后运行*/
DisplayName(A stack)
public class TestingAStackDemo {StackObject stack;TestDisplayName(is instantiated with new Stack())void isInstantiatedWithNew() {new Stack();}NestedDisplayName(when new)class WhenNew {BeforeEachvoid createNewStack() {stack new Stack();}TestDisplayName(is empty)void isEmpty() {assertTrue(stack.isEmpty());}TestDisplayName(throws EmptyStackException when popped)void throwsExceptionWhenPopped() {assertThrows(EmptyStackException.class, stack::pop);}TestDisplayName(throws EmptyStackException when peeked)void throwsExceptionWhenPeeked() {assertThrows(EmptyStackException.class, stack::peek);}NestedDisplayName(after pushing an element)class AfterPushing {String anElement an element;BeforeEachvoid pushAnElement() {stack.push(anElement);}TestDisplayName(it is no longer empty)void isNotEmpty() {assertFalse(stack.isEmpty());}TestDisplayName(returns the element when popped and is empty)void returnElementWhenPopped() {assertEquals(anElement, stack.pop());assertTrue(stack.isEmpty());}TestDisplayName(returns the element when peeked but remains not empty)void returnElementWhenPeeked() {assertEquals(anElement, stack.peek());assertFalse(stack.isEmpty());}}}
}6.参数化测试 参数化测试是JUnit5很重要的一个新特性它使得用不同的参数多次运行测试成为了可能也为我们的单元测试带来许多便利。 利用ValueSource等注解指定入参我们将可以使用不同的参数进行多次单元测试而不需要每新增一个参数就新增一个单元测试省去了很多冗余代码。 ValueSource: 为参数化测试指定入参来源支持八大基础类以及String类型,Class类型 NullSource: 表示为参数化测试提供一个null的入参 EnumSource: 表示为参数化测试提供一个枚举入参 CsvFileSource表示读取指定CSV文件内容作为参数化测试入参 MethodSource表示读取指定方法的返回值作为参数化测试入参(注意方法返回需要是一个流) 6.1 ValueSource ValueSource 是参数化测试的最简单形式。它允许你为测试方法提供一组简单的值就像是一份精选的薯片口味列表。 应用场景 适用于测试方法只有一个参数而且这个参数的类型为简单类型如 int、long、double、float、boolean、String。 案例
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;class ValueSourceExampleTest {ParameterizedTestValueSource(strings {apple, banana, orange})void testFruitNames(String fruitName) {assertNotNull(fruitName);}
}注意事项 测试方法的参数列表中的参数类型必须与 ValueSource 中的类型相匹配。例如如果你使用 ValueSource(ints {…})那么测试方法的参数类型必须是 int 或 Integer。 6.2. EnumSource EnumSource 是针对枚举类型的参数化测试。它允许你为测试方法提供一个枚举类型的值集合就像是为不同口味的薯片定义了一个标准分类。 应用场景 适用于测试方法只有一个参数而且这个参数的类型为枚举类型。 案例
package com.example.test;import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.EnumSource;import static org.junit.jupiter.api.Assertions.assertNotNull;public class EnumSourceExampleTest {enum Size {SMALL, MEDIUM, LARGE}ParameterizedTestEnumSource(Size.class)void testSizes(Size size) {assertNotNull(size);}} 注意事项 测试方法的参数列表中的参数类型必须与 EnumSource 中指定的枚举类型相匹配。 6.3 CsvSource 和 CsvFileSource CsvSource 和 CsvFileSource 是基于 CSV 格式的参数化测试。它们允许你为测试方法提供一组 CSV 格式的值就像是一张详细的薯片销售报表。 应用场景 适用于测试方法有多个参数需要以 CSV 格式提供输入数据。 案例
package com.example.test;import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;import static org.junit.jupiter.api.Assertions.assertEquals;public class CsvSourceExampleTest {ParameterizedTestCsvSource({1, 2, 3, 4, 5, 9, 6, 7, 13})void testAddition(int a, int b, int expectedSum) {assertEquals(expectedSum, a b);}
} 对于 CsvFileSource你需要将 CSV 数据存储在一个文件中并通过 resources 属性指定文件路径。
package com.example.test;import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvFileSource;import static org.junit.jupiter.api.Assertions.assertEquals;public class CsvFileSourceExampleTest {ParameterizedTestCsvFileSource(resources /addition.csv, numLinesToSkip1)void testAddition(int a, int b, int expectedSum) {assertEquals(expectedSum, a b);}
} 注意事项 确保 CSV 数据与测试方法的参数类型和数量相匹配。对于 CsvFileSource文件应该放在项目的资源文件夹中。 6.4. MethodSource MethodSource是基于方法返回值的参数化测试。它允许你为测试方法提供一个方法的返回值作为参数就像是一个智能贩卖机根据顾客的喜好自动调整薯片口味。 应用场景 适用于测试方法有多个参数需要从方法返回值中获取输入数据。 案例
package com.example.test;import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.MethodSource;import java.util.stream.Stream;import static org.junit.jupiter.api.Assertions.assertEquals;public class MethodSourceExampleTest {ParameterizedTestMethodSource(provideStrings)void testStringLength(String input, int expectedLength) {assertEquals(expectedLength, input.length());}static StreamArguments provideStrings() {return Stream.of(Arguments.of(apple, 5),Arguments.of(banana, 6),Arguments.of(orange, 6));}
} 注意事项 确保提供方法的返回值与测试方法的参数类型和数量相匹配。提供方法必须是静态方法且无需参数。 7.JUnit4 → Junit5 在进行迁移的时候需要注意如下的变化 注解在 org.junit.jupiter.api 包中断言在 org.junit.jupiter.api.Assertions 类中前置条件在org.junit.jupiter.api.Assumptions 类中。把Before 和After替换成BeforeEach 和AfterEach。把BeforeClass 和AfterClass 替换成BeforeAll和AfterAll。把Ignore 替换成Disabled。 把Category 替换成Tag。把RunWith、Rule 和ClassRule 替换成ExtendWith。
