Tag

JUnit5可以使用

@Tag

tag应该遵循以下规则：

• 不能为null或者为空。
• 不能包含空格。
• 不能包含ISO控制字符。
• 不能包含保留字符：

  ,

  (

  )

  &

  |

  !

示例代码：

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

@Tag("fast")
@Tag("model")
class TaggingDemo {

@Test
@Tag("taxes")
void testingTaxCalculation() {
}

}

@Tag

Filter

打好了tag后，在执行时可以进行过滤，比如Maven配置：

<!-- ... -->
<build>
<plugins>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.2</version>
<configuration>
<groups>acceptance | !feature-a</groups>
<excludedGroups>integration, regression</excludedGroups>
</configuration>
</plugin>
</plugins>
</build>
<!-- ... -->

groups用来指定包含哪些tag，excludedGroups用来指定排除哪些tag。

Order

JUnit5默认使用了某种算法来确定test方法的执行顺序。我们可以通过

@TestMethodOrder

内置类如下：

• DisplayName 按DisplayName的字母数字顺序
• OrderAnnotation 通过

  @Order

  注解指定顺序
• Random 随机顺序
• Alphanumeric 按test方法名和参数列表的字母数字顺序

示例：

import org.junit.jupiter.api.MethodOrderer.OrderAnnotation;
import org.junit.jupiter.api.Order;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestMethodOrder;

@TestMethodOrder(OrderAnnotation.class)
class OrderedTestsDemo {

@Test
@Order(1)
void nullValues() {
// perform assertions against null values
}

@Test
@Order(2)
void emptyValues() {
// perform assertions against empty values
}

@Test
@Order(3)
void validValues() {
// perform assertions against valid values
}

}

也可以配置全局的JUnit5的默认执行顺序，比如在

src/test/resources/junit-platform.properties

junit.jupiter.testmethod.order.default = \
org.junit.jupiter.api.MethodOrderer$OrderAnnotation

Lifecycle

JUnit5默认会在执行测试方法前给每个测试类创建一个实例对象，让测试方法相互独立，这叫做

per-method

如果想让每个测试类只创建一个实例对象，测试方法共用这一个实例，那么可以使用注解

@TestInstance(Lifecycle.PER_CLASS)

pre-class

pre-class

• 在实例中存储变量，然后通过

  @BeforeEach

  或

  @AfterEach

  修改。

• @BeforeAll

  、

  @AfterAll

  可以作用于非静态方法和接口

  default

  方法。

• @BeforeAll

  、

  @AfterAll

  可以作用于

  @Nested

  嵌套测试类。

有两种方式可以设置全局的生命周期模式，第一种是JVM启动参数：

-Djunit.jupiter.testinstance.lifecycle.default=per_class

第二种方式是配置文件，比如

src/test/resources/junit-platform.properties

junit.jupiter.testinstance.lifecycle.default = per_class

小结

本文首先介绍了给测试类和测试方法打tag进行分组，然后可以在运行时根据tag进行过滤，接着介绍了如何制定测试方法的执行顺序，最后介绍了两种生命周期：

per-method

pre-class