单元测试
JUnit5
1、Spring Boot 2.2.0 版本开始引入 JUnit 5 作为单元测试默认库
2、JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage
(1)JUnit Platform:在 JVM 上启动测试框架的基础,不仅支持 Junit 自制的测试引擎,可以接入其他测试引擎
(2)JUnit Jupiter:提供 JUnit5 新的编程模型,是 JUnit 5 新特性核心,内部包含一个测试引擎,在 Junit Platform 上运行
(3)JUnit Vintage:提供兼容 JUnit4.x,Junit3.x 的测试引擎
3、注意:Spring Boot 2.4 以上版本移除 JUnit Vintage 依赖,兼容 JUnit 4 需要自行引入
4、使用
(1)引入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
(2)编写测试方法 + 标注 @Test
(3)Junit 类具有 Spring 功能,如:@Transactional 标注测试方法,测试完成后自动回滚
5、注解
(1)@Test:表示方法是测试方法,但与 JUnit 4 @Test 不同,JUnit 5 @Test 职责单一,不能声明任何属性,拓展的测试由 Jupiter 提供额外测试
(2)@ParameterizedTest:表示方法是参数化测试
(3)@RepeatedTest:表示方法可重复执行,是用于重复测试的测试模板
(4)@DisplayName:表示为测试类或测试方法设置展示名称
(5)@BeforeEach:表示在每个单元测试之前执行
(6)@AfterEach:表示在每个单元测试之后执行
(7)@BeforeAll:表示在所有单元测试之前执行,方法必须为静态
(8)@AfterAll:表示在所有单元测试之后执行,方法必须为静态方法
(9)@Tag:表示单元测试类别,类似于 JUnit 4 中的 @Categories
(10)@Disabled:表示测试类或测试方法不执行,类似于 JUnit 4 中的 @Ignore
(11)@Timeout:表示如果测试方法运行超过指定时间,将会返回错误
(12)@ExtendWith:为测试类或测试方法提供扩展类引用,如:@SpringBootTest 含 @ExtendWith
(13)@TestFactory:表示方法是用于动态测试的测试工厂
(14)@TestInstance:用于为被注解的测试类配置测试实例生命周期
(15)@TestTemplate:表示方法是测试用例的模板,设计为被调用多次,调用次数取决于自注册的提供者返回的调用上下文
(16)@Nested:表示被注解的类是一个嵌套的非静态测试类。除非使用“per-class”测试实例生命周期,否则 @BeforeAll 和 @AfterAll 方法不能直接在 @Nested 测试类中使用
断言(assertions)
1、测试方法中的核心部分
2、断言方法都是 org.junit.jupiter.api.Assertions 中的静态方法
3、作用
(1)对测试需要满足的条件进行验证
(2)检查业务逻辑返回的数据是否合理
(3)所有测试运行结束后,生成一个详细测试报告
4、简单断言:对单个值进行简单的验证
方法 | 说明 |
assertEquals | 判断两个对象或两个原始类型是否相等 |
assertNotEquals | 判断两个对象或两个原始类型是否不相等 |
assertSame | 判断两个对象引用是否指向同一个对象 |
assertNotSame | 判断两个对象引用是否指向不同的对象 |
assertTrue | 判断给定的布尔值是否为 true |
assertFalse | 判断给定的布尔值是否为 false |
assertNull | 判断给定的对象引用是否为 null |
assertNotNull | 判断给定的对象引用是否不为 null |
5、数组断言
(1)通过 assertArrayEquals 方法,判断两个对象或原始类型的数组是否相等
(2)示例
@Test
public void array() {
assertArrayEquals(new int[]{1, 2}, new int[] {1, 2});
}
6、组合断言
(1)assertAll 方法接受多个 org.junit.jupiter.api.Executable 函数式接口的实例作为要验证的断言,可以通过 lambda 表达式提供这些断言
(2)示例
@Test
public void all() {
assertAll("Math",
() -> assertEquals(2, 1 + 1),
() -> assertTrue(1 > 0)
);
}
7、异常断言
(1)assertThrows(),测试方法的异常情况,配合函数式编程即可使用
(2)示例
@Test
void testException() {
//断定业务逻辑一定出现异常
assertThrows(ArithmeticException.class, () -> {
int i = 10 / 2;
}, "业务逻辑正常运行");
}
8、超时断言
(1)assertTimeout() 为测试方法设置超时时间
(2)示例
@Test
public void timeoutTest() {
//如果测试方法时间超过1s将会异常
Assertions.assertTimeout(Duration.ofMillis(1000), () -> Thread.sleep(500));
}
9、快速失败
(1)fail() 直接使得测试失败
(2)示例
@Test
public void shouldFail() {
fail("This should fail");
}
前置条件
1、assumptions:假设
2、前置条件可以看成是测试方法执行的前提,当该前提不满足时,则没有继续执行的必要
3、类似于断言,不满足的断言会使得测试方法失败,而不满足的前置条件只会使得测试方法的执行终止
4、附带 JUnit 4 提供的一些 assumption 方法的子集,并增加了一些适合与 lambda 一起使用的方法
5、所有假设方法都是 org.junit.jupiter.Asumptions 类中的静态方法
6、assumeTrue 和 assumFalse 确保给定的条件为 true 或 false,不满足条件会使得测试执行终止
7、assumingThat 的参数是表示条件的布尔值,和对应的 Executable 接口的实现对象,只有条件满足时,Executable 对象才会被执行;当条件不满足时,测试执行并不会终止
嵌套测试
1、JUnit 5 可以通过 Java 中的内部类和 @Nested 实现嵌套测试,从而可以更好的把相关的测试方法组织在一起
2、规则
(1)在内部类中可以使用 @BeforeEach 和 @AfterEach
(2)嵌套的层次没有限制
(3)外层 Test 不能驱动内层 BeforeEach、AfterEach、BeforeAll、AfterAll 之类的方法提前 / 延后运行
(4)内层 Test 可以驱动外层 BeforeEach、AfterEach、BeforeAll、AfterAll 之类的方法提前 / 延后运行
参数化测试
1、JUnit 5 新特性,可以用不同的参数多次运行测试
2、使用 @ParameterizedTest
3、需要添加对 junit-jupiter-params 构建的依赖
4、注解
(1)@ValueSource:为参数化测试指定入参来源,支持八大基础类、String 类型、Class 类型,可以指定一个原生类型的数组,并且只能为每次调用提供一个参数
(2)@NullSource:表示为参数化测试提供一个 null 的入参
(3)@EnumSource:表示为参数化测试提供一个枚举入参
(4)@CsvFileSource:表示读取指定 CSV 文件内容作为参数化测试入参
(5)@CsvSource:允许将参数列表表示为 CSV,使用 ' 作为转义字符
(6)@MethodSource:表示读取指定方法的返回值作为参数化测试入参,方法返回值必须是一个 Stream、Iterable、Iterator、参数数组,方法不能接受任何参数,默认情况下,除非测试类用 @TestInstance(Lifecycle.PER_CLASS) 注解,否则必须为静态方
法
5、只需要去实现 ArgumentsProvider 接口,任何外部文件都可以作为它的入参
迁移变化
1、注解在 org.junit.jupiter.api 包中,断言在 org.junit.jupiter.api.Assertions 类中,前置条件在 org.junit.jupiter.api.Assumptions 类中
2、注解
(1)@Before 和 @After 替换成 @BeforeEach 和@ AfterEach
(2)@BeforeClass 和 @AfterClass 替换成 @BeforeAll 和 @AfterAll
(3)@Ignore 替换成 @Disabled
(4)@Category 替换成 @Tag
(5)@RunWith、@Rule 和 @ClassRule 替换成 @ExtendWith
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· 没有源码,如何修改代码逻辑?
· PowerShell开发游戏 · 打蜜蜂
· 在鹅厂做java开发是什么体验
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战