JUnit 5学习心得

JUnit 5简介

与之前的版本不同，JUnit 5 由三个不同的模块组成。第一个模块是 JUnit 平台，其主要作用是在 JVM 上启动测试框架。它定义了一个抽象的 TestEngine API 来定义运行在平台上的测试框架，同时还支持通过命令行、Gradle 和 Maven 来运行平台。
JUnit 5 对 Java 运行环境的最低要求是 Java 8。可以在 Eclipse 和 IntelliJ IDEA 上运行 JUnit 5 测试。

JUnit 5新更新

JUnit 5允许在断言中使用Lambda表达式（Lambda表达式是Java SE 8中一个重要的新特性。lambda表达式允许你通过表达式来代替功能接口。 lambda表达式就和方法一样,它提供了一个正常的参数列表和一个使用这些参数的主体(body,可以是一个表达式或一个代码块。Lambda表达式还增强了集合库 ）。
JUnit 5不再是单个库，而是模块化结构的集合，整个API分成了：自己的模块，引擎，launcher，针对Gradle和Surefire的集成模块。
JUnit 5还提供了全新的一套注释集合，断言方法从JUnit4的org.junit.Assert包移动到JUnit5的org.junit.gen5.api.Assertions包。
JUnit 5有分组断言这个新功能（分组断言允许执行一组断言，且会一起报告）。

JUnit 5基本注解

以下只简单的介绍几种常用的基本注解
@Test（表明一个测试方法）
@BeforeAll(执行一次，执行时机是在所有测试和 @BeforeEach 注解方法之前)
@BeforeEach(在每个测试执行之前执行)
@AfterEach(在每个测试之后执行)
@AfterAll（只执行一次，执行时机是在所有测试和@AfterEach注解方法之后）
@Disabled（禁止测试类或方法）
@Displayname（测试类或方法的显示名称）

JUnit 5断言

用来对满足的条件进行验证，断言方法都是静态方法。
一下介绍几个常用的基本断言方法
assertEquals（判断两个对象或两个原始类型是否相等）
assertNotEquals（判断两个对象或两个原始类型是否不相等）
assertSame（判断两个对象引用是否指向同一个对象）
assertNotSame（判断两个对象引用是否指向不同的对象）
assertTrue（判断给定的布尔值是否为 true）
assertFalse（判断给定的布尔值是否为 false）
assertNull （判断给定的对象引用是否为 null）
assertNotNull（判断给定的对象引用是否不为 null）

注：以上介绍的这些断言方法都有多个重载方法。

JUnit 5前置条件

JUnit 5 中的前置条件（assumptions）类似于断言，不同之处在于不满足的断言会使得测试方法失败，而不满足的前置条件只会使得测试方法的执行终止。前置条件可以看成是测试方法执行的前提，当该前提不满足时，就没有继续执行的必要。在如下案例中，assumeTrue 和 assumFalse 确保给定的条件为 true 或 false，不满足条件会使得测试执行终止。assumingThat 的参数是表示条件的布尔值和对应的 Executable 接口的实现对象。只有条件满足时，Executable 对象才会被执行；当条件不满足时，测试执行并不会终止。

@DisplayName("Assumptions")
public class AssumptionsTest {
 private final String environment = "DEV";
 
 @Test
 @DisplayName("simple")
 public void simpleAssume() {
    assumeTrue(Objects.equals(this.environment, "DEV"));
    assumeFalse(() -> Objects.equals(this.environment, "PROD"));
 }
 
 @Test
 @DisplayName("assume then do")
 public void assumeThenDo() {
    assumingThat(
       Objects.equals(this.environment, "DEV"),
       () -> System.out.println("In DEV")
    );
 }
}

扩展机制

JUnit 5 提供了标准的扩展机制来允许开发人员对 JUnit 5 的功能进行增强。JUnit 5 提供了很多的标准扩展接口，第三方可以直接实现这些接口来提供自定义的行为。通过@ExtendWith 注解可以声明在测试方法和类的执行中启用相应的扩展。
扩展的启用是继承的，这既包括测试类本身的层次结构，也包括测试类中的测试方法。也就是说，测试类会继承其父类中的扩展，测试方法会继承其所在类中的扩展。除此之外，在一个测试上下文中，每一个扩展只能出现一次。

创建扩展

JUnit 5 中的扩展非常容易创建，只是实现了特定接口的 Java 类。JUnit 5 的扩展都需要实现 org.junit.jupiter.api.extension.Extension 接口，不过该接口只是一个标记接口，并没有任何需要实现的具体方法。真正起作用的是 Extension 的子接口，作为 JUnit 5 提供的扩展点。

测试执行条件

ContainerExecutionCondition 和 TestExecutionCondition 接口用来配置是否启用测试类或测试方法。前面提到的@Disabled 注解也是通过这样的机制来实现的。ContainerExecutionCondition 接口对应的是测试类，而 TestExecutionCondition 接口对应的是测试方法。
ContainerExecutionCondition 接口的 evaluate 方法接受 ContainerExtensionContext 接口作为参数，并返回 ConditionEvaluationResult 类的对象作为结果。通过 ContainerExtensionContext 接口可以获取到当前测试类的上下文信息，而 ConditionEvaluationResult 类则表示该测试类是否被启用。
TestExecutionCondition 接口也是包含一个 evaluate 方法，只不过参数类型是 TestExtensionContext，其返回结果也是 ConditionEvaluationResult 类的对象。
通过扩展的方式禁用的测试类和方法，可以通过 JVM 参数 junit.conditions.deactivate 来重新启用，只需要把相应的条件类禁用即可。

支持Hamcrest匹配和AssertJ断言库

JUnit 5支持Hamcrest匹配和AssertJ断言库，可以用它们来代替JUnit 5的方法。

动态测试

目前所介绍的 JUnit 5 测试方法的创建都是静态的，在编译时刻就已经存在。JUnit 5 新增了对动态测试的支持，可以在运行时动态创建测试并执行。通过动态测试，可以满足一些静态测试无法解的需求，也可以完成一些重复性很高的测试。比如，有些测试用例可能依赖运行时的变量，有时候会需要生成上百个不同的测试用例。这些场景都是动态测试可以发挥其长处的地方。动态测试是通过新的@TestFactory 注解来实现的。测试类中的方法可以添加@TestFactory 注解的方法来声明其是创建动态测试的工厂方法。这样的工厂方法需要返回 org.junit.jupiter.api.DynamicTest 类的集合，可以是 Stream、Collection、Iterable 或 Iterator 对象。每个表示动态测试的 DynamicTest 对象由显示名称和对应的 Executable 接口的实现对象来组成。

@TestFactory
public Collection<DynamicTest> simpleDynamicTest() {
 return Collections.singleton(dynamicTest("simple dynamic test", () -> assertTrue(2 > 1)));
}
DynamicTest 提供了一个静态方法 stream 来根据输入生成动态测试，如清单 14 所示。

@TestFactory
public Stream<DynamicTest> streamDynamicTest() {
 return stream(
       Stream.of("Hello", "World").iterator(),
       (word) -> String.format("Test - %s", word),
       (word) -> assertTrue(word.length() > 4)
 );
}

嵌套测试

在嵌套的类上添加 @Nested 注解，类中的所有方法即会被引擎执行