单元测试-Junit5入门教程

  • 一、添加Junit5依赖
  • 二、Junit5 常用注解
  • 2.1、@Test
  • 2.2、@BeforeAll
  • 2.3、@AfterAll
  • 2.4、@BeforeEach
  • 2.5、@AfterEach
  • 2.6、@Nested
  • 2.7、@DisplayName
  • 2.8、@Disabled
  • 2.9、@RepeatedTest
  • 三、Junit5 套件执行


一、添加Junit5依赖

Spring Boot 2.2.0 版本开始引入 JUnit 5 作为单元测试默认库;在 Spring Boot 2.2.0 版本之前,spring-boot-starter-test 包含了 JUnit 4 的依赖;

如何查看SpringBoot的版本:

  • 第一种方法:
public static void main(String[] args) {
	 String springVersion = SpringVersion.getVersion();
	 String springBootVersion = SpringBootVersion.getVersion();
 }

运行结果:

Spring版本:5.3.18
SpringBoot版本:2.6.6
  • 第二种方法:
    看配置文件:

    因为springboot 版本为2.6.6,默认引入的就是junit5,故不需要再额外引入依赖。
    pom.xml 文件中默认依赖如下:
<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
</dependency>

但是但是, 在用junit5进行套件测试的时候发现报错无法识别 @RunWith(JUnitPlatform.class) ,我就意识到默认的依赖不全,所以直接果断引入依赖,如下:

<dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.6.2</version>
    </dependency>
    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-runner</artifactId>
        <version>1.6.2</version>
    </dependency>

二、Junit5 常用注解

2.1、@Test

表明一个测试方法

2.2、@BeforeAll

表明在所有测试方法执行之前执行的方法,且只执行一次

2.3、@AfterAll

表明在所有测试方法执行之后执行的方法,且只执行一次

2.4、@BeforeEach

表明在每个测试方法执行之前都会执行的方法

2.5、@AfterEach

表明在每个测试方法执行之后都会执行的风发

牢记junit5生命周期的洋葱模型

使用junit5测试springboot的contrller层 junit5 springboot_单元测试

2.6、@Nested

嵌套测试

  • @Nested标注内部类
  • 使得用例保持树状结构,方便用例的管理
    解释如下图所示:
  • @Nested 内嵌类,结果展示呈现树状结构,方便查看
  • 多个@Nested,执行顺序从下到上倒序进行,所以先执行TestCalculator2的内容

2.7、@DisplayName

测试类或者方法的显示名称

2.8、@Disabled

禁用测试类或者方法

2.9、@RepeatedTest

额外重复执行

使用junit5测试springboot的contrller层 junit5 springboot_spring_02

  • 如图1.1标注,@DisplayName 可以定义显示类的名称,如图1.2标注,@DisplayName 可以定义显示方法的名称
  • 如图2的标注,@Disabled ,该方法不执行,会看到方法名称前面有一个禁用的小图标
  • 如图3的标注,@RepeatedTest 设置为2,看到该方法再执行了一次之后,又额外重复执行了2遍,所以该方法总共执行了3次。

三、Junit5 套件执行

注解

作用

@RunWith(JUnitPlatform.class)

执行套件

@SelectPackage({“com.packageA”,“com.packageB”})

根据包-创建套件

@IncludePackage(“包名”)

在套件中,过滤需要执行的测试包

@ExcludePackages(“包名”)

在套件中,过滤剔除不需要执行的测试包

@SelectClasses( {a.class,b.class,c.class} )

根据类-创建套件

@IncludeClassNamePatterns(“类名”)

在套件中,过滤需要执行的测试类

@ExcludeClassNamePatterns(“类名”)

在套件中,过滤剔除不需要执行的测试类

@IncludeTags(“tag”)

在套件中,过滤需要执行的测试方法

@ExcludeTags(“tag”)

在套件中,过滤剔除不需要执行的测试方法

通过select来创建套件,通过包、类、和方法三个维度来选择需要执行的测试用例。所有条件是且的关系,求的是交集。

若交集为空,如下图效果:

使用junit5测试springboot的contrller层 junit5 springboot_java_03


若交集不为空,则执行匹配的用例:

使用junit5测试springboot的contrller层 junit5 springboot_java_04

使用classname进行匹配时,需要加上所在的包名(唉~ 好麻烦)