重复测试
JUnit Jupiter通过使用@RepeatedTest注解方法并指定所需的重复次数,提供了重复测试指定次数的功能。每次重复测试的调用都像执行常规的@Test方法一样,完全支持相同的生命周期回调和扩展。
以下示例演示了如何声明名为repeatedTest()的测试,该测试将自动重复10次。
@RepeatedTest(10)
void repeatedTest() {
// ...
}除了指定重复次数外,还可以通过@RepeatedTest注解的name属性为每次重复配置自定义显示名称。此外,显示名称可以是模式,由静态文本和动态占位符的组合而成。目前支持以下占位符:
{displayName}: @RepeatedTest方法的显示名称
{currentRepetition}: 当前重复次数
{totalRepetitions}: 重复的总次数
给定重复的默认显示名称基于以下模式生成:"repetition {currentRepetition} of {totalRepetitions}"。 因此,前面的repeatedTest()示例的单个重复的显示名称将是:repetition 1 of 10, repetition 2 of 10等等。如果您希望每个重复的名称中包含@RepeatedTest方法的显示名称,您可以定义自己的自定义模式或使用预定义的RepeatedTest.LONG_DISPLAY_NAME模式。后者相当于"{displayName} :: repetition {currentRepetition} of {totalRepetitions}",这会导致重复测试的显示名称变成这样:repeatedTest() :: repetition 1 of 10, repeatedTest() :: repetition 2 of 10等。
为了以编程方式获取有关当前重复和总重复次数的信息,开发人员可以选择将RepetitionInfo的实例注入@RepeatedTest,@BeforeEach或@AfterEach方法。
重复测试示例
本节末尾的RepeatedTestsDemo类将演示重复测试的几个示例。
repeatedTest()方法与上一节中的示例相同; 而repeatedTestWithRepetitionInfo()演示了如何将RepetitionInfo的实例注入到测试中,以获取当前重复测试的总重复次数。
接下来的两个方法演示了如何在每个重复的显示名称中包含@RepeatedTest方法的自定义@DisplayName。 customDisplayName()用自定义模式组合自定义显示名称,然后使用TestInfo来验证生成的显示名称的格式。Repeat!是来自@DisplayName,来自{displayName}声明,1/1来自{currentRepetition}/{totalRepetitions}。相反,customDisplayNameWithLongPattern()使用前面提到的预定义的RepeatedTest.LONG_DISPLAY_NAME模式。
repeatedTestInGerman()展示了将重复测试的显示名称翻译成外语的能力 - 在这种情况下是德语,从而得到单个重复的名称,例如:Wiederholung 1 von 5,Wiederholung 2 von 5等。
由于beforeEach()方法用@BeforeEach标注,所以在每次重复测试之前都会执行它。通过将TestInfo和RepetitionInfo注入到方法中,我们可以看到,有可能获得有关当前正在执行的重复测试的信息。在启用了INFO日志级别的情况下,执行RepeatedTestsDemo会得到以下输出。
在启用了unicode主题的情况下,使用ConsoleLauncher或junitPlatformTest Gradle插件时,执行RepeatedTestsDemo会将以下输出给控制台。
Last updated