Junit5 架构、新特性及基本使用（常用注解与套件执行）

本文为霍格沃兹测试学院优秀学员 Junit 学习笔记。测试开发技能进阶，文末加群。

一、Junit 简介与架构

什么是 Junit5，在 Junit5 的官方介绍文档中这写到：

Junit5 由JUnit Platform + JUnit Jupiter + JUnit Vintage3部分构成，借用 IBM
Developer 的一张图来说明 JUnit 5 的架构 ：

JUnit Platform :

其主要作用是在 JVM 上启动测试框架。它定义了一个抽象的 TestEngine API
来定义运行在平台上的测试框架；也就是说其他的自动化测试引擎或开发人员⾃⼰定制的引擎都可以接入 Junit
实现对接和执行。同时还支持通过命令行、Gradle 和 Maven 来运行平台（这对于我们做自动化测试至关重要）。

JUnit Jupiter :

这是 Junit5 的核心，可以看作是承载 Junit4 原有功能的演进，包含了 JUnit 5 最新的编程模型和扩展机制；很多丰富的新特性使
JUnit ⾃动化测试更加方便、功能更加丰富和强大。也是测试需要重点学习的地方；Jupiter 本身也是⼀一个基于 Junit Platform
的引擎实现，对 JUnit 5 而言，JUnit Jupiter API 只是另一个 API！。

JUnit Vintage :

Junit 发展了10数年，Junit 3 和 Junit 4 都积累了大量的⽤用户，作为新一代框 架，这个模块是对 JUnit3，JUnit4
版本兼容的测试引擎，使旧版本 junit 的⾃动化测试脚本也可以顺畅运行在 Junit5 下，它也可以看作是基于 Junit Platform
实现的引擎范例。

JUnit 5 对 Java 运行环境的最低要求是 Java 8。

二、Junit5 的新特性

• 嵌套单元测试

• Lambda支持

• 参数化测试

• 重复测试

• 动态测试

JUnit 4 与 JUnit 5 中的注解比较

三、JUnit 5 常用注解

3.1 Junit5 常用注解

3.2 实操演示

• 1）创建 maven 工程 XUnit，pom.xml中添加Junit5的依赖。

  <dependency>  
      <groupId>org.junit.platform</groupId>  
      <artifactId>junit-platform-launcher</artifactId>  
      <version>1.5.2</version>  
      <scope>test</scope>  
  </dependency>  
  <dependency>  
      <groupId>org.junit.jupiter</groupId>  
      <artifactId>junit-jupiter-engine</artifactId>  
      <version>5.5.2</version>  
      <scope>test</scope>  
  </dependency>  
  <dependency>  
      <groupId>org.junit.vintage</groupId>  
      <artifactId>junit-vintage-engine</artifactId>  
      <version>5.5.2</version>  
      <scope>test</scope>  
  </dependency>  
  

• 2）其余的 XUnit 框架通用的设计运行规则可参考：《 如何利用 xUnit 框架对测试用例进行维护》。

• 3）添加用例@Test，再在用例执行前后添加@BeforeEach、@AfterEach:

• 运行结果：

• 4）在测试类执行前后添加@BeforeAll和@AfterAll：

• 测试结果：

• 5）在测试用例test1上加入注解@Disabled，使test1失效。

• 测试结果：

• 从测试结果中我们可以看到 test1 用例被 ignore，没有被执行。

• 6）分别将test1和test2用@DisplayName加上用例展示名称。

• 测试结果：

• 7）对测试用例2加上注解@RepeatedTest,使其 额外 重复执行3次：

• 测试结果：

• 从测试结果中我们可以看到测试用例2被额外重复执行了3次

• 8）对于@Nested嵌套执行举例如下：

• 测试结果：

• 由测试结果可以看出，@Nested的执行顺序为先执行@Nested嵌套外层的用例，再以倒叙形式执行@Nested用例，然后再执行第二层嵌套的用例：外层->倒叙嵌套->第二层嵌套。

四、Junit5 套件执行

@RunWith 是从Junit4迁移过来的，@RunWith 连同它的参数 JUnitPlatform.class（一个基于 JUnit 4 且理解
JUnit Platform 的 Runner）让您可以在 Eclipse 内运行 JUnit Jupiter 单元测试。Eclipse 尚未原生支持
JUnit 5。未来，Eclipse 将提供原生的 JUnit 5 支持，那时我们不再需要此注解；Junit5官方给出了替代它的注解：

4.1 @RunWith+@SelectPackages

• 有两个包testcasedemo, junit5demo,利用 @RunWith+@SelectPackages 将包中测试类依次运行。

套件类：

测试结果：

4.2 @RunWith+@SelectPackages+@IncludePackages

• @RunWith+@SelectPackages+@IncludePackages配合使用过滤出需要执行的测试包testcasedemo.demo2。

套件类：

测试结果：

4.3 @RunWith+@SelectPackages+@ExcludePackages

• @RunWith+@SelectPackages+@ExcludePackages配合使用过滤出不需要执行的测试包testcasedemo.demo2。

套件类：

测试结果：

4.4 @RunWith+@SelectPackages+@IncludeClassNamePatterns

• 将 junit5demo 包下的 TestJunit5demo 和 testcasedemo.demo2 所有测试类过滤出来并执行。

套件类：

测试结果：

4.5 @RunWith+@SelectPackages+@IncludeTags

在testcasedemo.demo2.TestDemo2的方法testDemo2上加上注解@Tag:

过滤并执行方法testDemo2：

套件类：

测试结果：

5、参考文档：

Junit5官网：

• https://junit.org/junit5/docs/current/user-guide/#overview

IBM Developer:

• https://www.ibm.com/developerworks/cn/java/j-introducing-junit5-part1-jupiter-api/index.html

• https://www.ibm.com/developerworks/cn/java/j-junit5/index.html

** _
来霍格沃兹测试开发学社，学习更多软件测试与测试开发的进阶技术，知识点涵盖web自动化测试 app自动化测试、接口自动化测试、测试框架、性能测试、安全测试、持续集成/持续交付/DevOps，测试左移、测试右移、精准测试、测试平台开发、测试管理等内容，课程技术涵盖bash、pytest、junit、selenium、appium、postman、requests、httprunner、jmeter、jenkins、docker、k8s、elk、sonarqube、jacoco、jvm-sandbox等相关技术，全面提升测试开发工程师的技术实力
QQ交流群：484590337
公众号 TestingStudio
点击获取更多信息