JUnit5 类级参数化测试

java kotlin junit5 parameterized-unit-test

2022-09-01 00:40:45

是否可以使用 JUnit5 的参数化新功能来运行测试类来接收测试参数，而不是在方法级别执行此操作？

使用JUnit 4，可以使用诸如plus继承之类的运行器将参数数组传递给子类，但我不确定是否可以实现等效的东西，但使用新的JUnit 5 api。@RunWith(Parameterized::class)

答案 1

简短的回答
，没有办法按照JUnit 4的风格用JUnit 5参数化类创建。

幸运的是，分离测试逻辑和测试输入数据（参数）的意图可以以不同的方式实现。

JUnit 5 有自己的方法来进行参数化测试，当然，它与 JUnit 4 不同。新方法不允许在类级别使用参数化夹具，即通过其每个测试方法。因此，每个参数化测试方法都应该使用指向参数的链接进行显式注释。

JUnit 5 提供了大量参数源类型，可以在文档和指南中找到

在您的情况下，从 Junit 4 迁移的最简单方法是使用或 .@Parameters@MethodSource@ArgumentsSourceorg.junit.jupiter.params.provider.*

JUnit 4：

@RunWith(Parameterized.class)
public class MyTestWithJunit4 {
    @Parameters
    public static Collection<Object[]> data() {
      return Arrays.asList(new Object[][] {     
               { 0, 0, 0 },
               { 1, 2, 3 }, 
               { 5, 3, 8 } 
      });
    }

    int first;
    int second;
    int sum;

    public MyTestWithJunit4(int first, int second, int sum) {
      this.first = first;
      this.second = second;
      this.sum = sum;
    }

    @Test
    public void test() {
      assertEquals(sum, first + second));
    }
}

JUnit 5（带@MethodSource）：

class MyTestWithJunit5 {

  @DisplayName("Test with @MethodSource")
  @ParameterizedTest(name = "{index}: ({0} + {1}) => {2})")
  @MethodSource("localParameters")
  void test(int first, int second, int sum) {
    assertEquals(sum, first + second);
  }

  static Stream<Arguments> localParameters() {
    return Stream.of(
        Arguments.of(0, 0, 0),
        Arguments.of(1, 2, 3),
        Arguments.of(5, 3, 8)
    );
  }
}

JUnit 5（带@ArgumentsSource）：

class MyTestWithJunit5 {
  @DisplayName("Test with @ArgumentsSource")
  @ParameterizedTest(name = "{index}: ({0} + {1}) => {2})")
  @ArgumentsSource(Params.class)
  void test(int first, int second, int sum) {
    assertEquals(sum, first + second);
  }

  static class Params implements ArgumentsProvider {
    @Override
    public Stream<? extends Arguments> provideArguments(ExtensionContext context) {
      return Stream.of(
          Arguments.of(0, 0, 0),
          Arguments.of(1, 2, 3),
          Arguments.of(5, 3, 8)
      );
    }
  }
}

考虑一下，in 中的方法和中的类可以在任何地方描述，而不仅仅是在测试方法所在的同一类内。还允许提供多个源方法，因为它是.@MethodSource@ArgumentsSource@MethodSourcevalueString[]

一些评论和比较

在 JUnit 4 中，我们只能有一个提供参数的工厂方法，并且测试应该围绕这些参数构建。相反，JUnit 5 在绑定参数方面提供了更多的抽象和灵活性，并将测试逻辑与其参数（次要参数）分离。这允许独立于参数源构建测试，并在需要时轻松更改它们。

依赖关系要求

参数化测试功能不包括在核心中，而是位于一个单独的依赖关系 junit-jupiter-params 中。junit-jupiter-engine

答案 2

创建指定参数化的元注释，并将其应用于测试方法：

public class MyTest {
    @ParameterizedTest(name = "{0}")
    @MethodSource("allImplementations")
    @Retention(RetentionPolicy.RUNTIME)
    private @interface TestAllImplementations {
    }

    static Stream<Arguments> allImplementations() {
        return Stream.of(
             Arguments.of("Serial", new SerialWidget()),
             Arguments.of("Concurrent", new ConcurrentWidget())
        );
    }

    @TestAllImplementations
    void myFirstTest(String name, Widget implementation) {
        /* ... */
    }

    @TestAllImplementations
    void mySecondTest(String name, Widget implementation) {
        /* ... */
    }
}