JUnit 5基础指南

准备

添加maven依赖：

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.1.0</version>
    <scope>test</scope>
</dependency>

基础注解

1. @BeforeAll and @BeforeEach

@BeforeAll
static void setup() {
    log.info("@BeforeAll - executes once before all test methods in this class");
}

@BeforeEach
void init() {
    log.info("@BeforeEach - executes before each test method in this class");
}

⚠️：@BeforeAll 注解的方法必须是static的，否则代码无法编译。

2. @DisplayName and @Disabled

@DisplayName("Single test successful")
@Test
void testSingleSuccessTest() {
    log.info("Success");
}

@Test
@Disabled("Not implemented yet")
void testShowSomething() {
}

@DisplayName：指定该测试显示的名称

@Disabled：禁用某个测试，并指定该测试的显示名称

3. @AfterEach and @AfterAll

@AfterEach
void tearDown() {
    log.info("@AfterEach - executed after each test method.");
}

@AfterAll
static void done() {
    log.info("@AfterAll - executed after all test methods.");
}

⚠️：@AfterAll 注解的方法必须是static的，否则代码无法编译。

---

断言和假设

断言

断言已移至org.junit.jupiter.api.Assertions，并且已得到明显改善。如前所述，您现在可以在断言中使用lambda：

@Test
void lambdaExpressions() {
    assertTrue(Stream.of(1, 2, 3)
      .stream()
      .mapToInt(i -> i)
      .sum() > 5, () -> "Sum should be greater than 5");
}

尽管上面的示例很简单，但是将lambda表达式用于断言消息的一个优点是可以对它进行延迟计算，如果消息的构建成本很高，则可以节省时间和资源。

现在还可以使用assertAll（）来对断言进行分组，这将使用MultipleFailuresError报告组内任何失败的断言：

@Test
void groupAssertions() {
    int[] numbers = {0, 1, 2, 3, 4};
    assertAll("numbers",
        () -> assertEquals(numbers[0], 1),
        () -> assertEquals(numbers[3], 3),
        () -> assertEquals(numbers[4], 1)
    );
}

这意味着现在进行更复杂的断言更加安全，因为您将能够查明任何故障的确切位置。

假设

假设仅在满足某些条件时才用于运行测试。这通常用于测试正常运行所需的外部条件，但这些条件与所测试的内容没有直接关系。

您可以使用assumeTrue（），assumeFalse（）和assumptionThat（）来声明一个假设。

@Test
void trueAssumption() {
    assumeTrue(5 > 1);
    assertEquals(5 + 2, 7);
}

@Test
void falseAssumption() {
    assumeFalse(5 < 1);
    assertEquals(5 + 2, 7);
}

@Test
void assumptionThat() {
    String someString = "Just a string";
    assumingThat(
        someString.equals("Just a string"),
        () -> assertEquals(2 + 2, 4)
    );
}

如果假设失败，则抛出TestAbortedException，并且仅跳过测试。 假设也理解lambda表达式。

异常测试

JUnit 5中有两种异常测试方法。这两种方法都可以通过使用assertThrows（）方法来实现：

@Test
void shouldThrowException() {
    Throwable exception = assertThrows(UnsupportedOperationException.class, () -> {
      throw new UnsupportedOperationException("Not supported");
    });
    assertEquals(exception.getMessage(), "Not supported");
}

@Test
void assertThrowsException() {
    String str = null;
    assertThrows(IllegalArgumentException.class, () -> {
      Integer.valueOf(str);
    });
}

第一个示例用于验证引发的异常的更多详细信息，第二个示例仅用于验证异常的类型。

测试套件

添加maven依赖：

<dependency>
    <groupId>org.junit.platform</groupId>
    <artifactId>junit-platform-runner</artifactId>
    <version>1.6.1</version>
    <scope>test</scope>
</dependency>

为了继续使用JUnit 5的新特性，我们将尝试了解在一个测试套件中聚合多个测试类的概念，以便我们可以一起运行这些类。JUnit 5提供了两个注释：@SelectPackages和@SelectClasses来创建测试套件。

@RunWith(JUnitPlatform.class)
@SelectPackages("com.baeldung")
public class AllUnitTest {}

@SelectPackage用于指定运行测试套件时要选择的包的名称。在我们的示例中，它将运行所有测试。第二个注释@SelectClasses用于指定运行测试套件时要选择的类：

@RunWith(JUnitPlatform.class)
@SelectClasses({AssertionTest.class, AssumptionTest.class, ExceptionTest.class})
public class AllUnitTest {}

例如，上面的类将创建一个包含三个测试类的套件。请注意，这些类不必在一个包中。

动态测试

我们要介绍的最后一个主题是JUnit 5动态测试功能，该功能允许声明和运行在运行时生成的测试用例。与静态测试在编译时定义了固定数量的测试用例相反，动态测试允许我们在运行时动态定义测试用例。

动态测试可以通过带有@TestFactory注释的工厂方法来生成。让我们看一下代码示例：

@TestFactory
public Stream<DynamicTest> translateDynamicTestsFromStream() {
  List<String> in = Lists.newArrayList("1", "2", "3");
  List<String> out = Lists.newArrayList("one", "two", "three");
  return in.stream()
    .map(word ->
         DynamicTest.dynamicTest("Test translate " + word, () -> {
           int id = in.indexOf(word);
           assertThat(out.get(id).length()).isGreaterThan(2);
         })
        );
}

这个例子非常简单易懂。我们想使用分别命名为in和out的两个ArrayList翻译单词。工厂方法必须返回Stream，Collection，Iterable或Iterator。在本例中，我们选择Java 8 Stream。

请注意，@ TestFactory方法不得为私有或静态。测试的数量是动态的，并且取决于ArrayList的大小。

总结

我们可以看到JUnit 5的体系结构发生了很大变化，这与平台启动器，与构建工具，IDE，其他单元测试框架的集成等有关。此外，JUnit 5与Java 8的集成程度更高，尤其是与Lambdas和Stream概念。

---

注：本文翻译自原文：https://www.baeldung.com/junit-5 ，并且在此基础上有改动。