随笔- 261 文章- 0 评论- 12 阅读- 45万

Springboot 2.x 单元测试 JUnit 5

一、JUnit5 简介

Spring Boot 2.2.0 版本开始引入 JUnit5 作为单元测试默认库, JUnit5作为最新版本的 JUnit框架, 它与之前版本的 JUnit框架有很大的不同,由三个不同子项目的几个不同模块组成.

1	`JUnit5 = JUnitPlatform + JUnitJupiter + JUnitVintage`

JUnitPlatform: JUnitPlatform 是在 JVM 上启动测试框架的基础,不仅支持 JUnit自制的测试引擎,其它测试引擎也都可以接入.

JUnitJupiter: JUnitJupiter 提供了JUnit5 的新的编程模型,是 JUnit5 新特性的核心.内部包含了一个测试引擎,用于在 JUnitPlatform 上运行.

JUnitVintage: 由于 JUnit已经发展多年,为了照顾老的项目,JUnitVintage 提供了兼容 JUnit 4.x,JUnit 3.x 的测试引擎.

注意：
SpringBoot 2.4 以上版本移除了默认对 Vintage 的依赖.如果需要兼容 JUnit4.x 版本,需要自行引入（不能使用junit4的功能 @Test）

打开项目发布信息 ----> 选择 v 2.4 这个版本

该版本的变更中说明了已经移除了 JUnit5 了

二、整合 JUnit5

未整合 JUnit 之前

1	`@SpringBootTest` `+` `@RunWith(SpringTest.class)`

Springboot 整合 Junit 以后
编写测试方法：@Test标注（注意需要使用 junit5 版本的注解）
Junit类具有 Spring 的功能, 例如 @Autowired、@Transactional (标注测试方法，测试完成后自动回)

我们只需要引入 spring-boot-starter-test 依赖即可完成整合,其它的 Springboot 底层都已经帮我们自动配置好了

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

三、Junit 5 常用注解

具体的使用规范可以参考官网 JUnit 5 官网 https://junit.org/junit5/

JUnit5 的注解与JUnit4 的注解有所变化,具体可以参考官方文档 https://junit.org/junit5/docs/current/user-guide/#writing-tests-annotations

注解	说明
@Test	表示方法是测试方法,但是与 JUnit4 的 @Test 不同,它的职责非常单一不能声明任何属性,拓展的测试将会由 Jupiter 提供额外测试
@DisplayName	为测试类或者测试方法设置展示名称
@BeforeAll	表示在所有单元测试之前执行
@BeforeEach	表示在每个单元测试之前执行
@Timeout	表示测试方法运行如果超过了指定时间将会返回错误
@Disabled	表示测试类或测试方法不执行
@RepeatedTest	表示方法可重复执行
@ExtendWith	为测试类或测试方法提供扩展类引用
@AfterEach	表示在每个单元测试之后执行
@AfterAll	表示在所有单元测试之后执行

我们就选取几个测试注解来使用一下

1、测试类

@DisplayName("测试类")
@SpringBootTest
class DatasourceApplicationTests {
 
    @Test
    @BeforeAll
    public static void beforeAll() {
        System.out.println("@BeforeAll: 表示在所有单元测试之前执行");
    }
 
    @BeforeEach
    public void beforeEach() {
        System.out.println("@BeforeEach: 表示在每个单元测试之前执行");
    }
 
    @Test
    @DisplayName("测试方法一")
    public void test01() {
        System.out.println("@DisplayName: 为测试类或者测试方法设置展示名称");
    }
 
    @Test
    @DisplayName("测试方法二")
    @Timeout(value=1,unit=TimeUnit.MICROSECONDS)
    public void test02() {
        System.out.println("@Timeout: 表示测试方法运行如果超过了指定时间将会返回错误");
    }
}