是否可以使用 JUnit5 的参数化新特性来运行测试类来接收测试参数,而不是在方法级别进行?
使用 JUnit 4,可以使用诸如@RunWith(Parameterized::class)
plus 继承之类的运行器将参数数组传递给子类,但我不确定是否可以使用新的 JUnit 5 api 实现等效的东西。
是否可以使用 JUnit5 的参数化新特性来运行测试类来接收测试参数,而不是在方法级别进行?
使用 JUnit 4,可以使用诸如@RunWith(Parameterized::class)
plus 继承之类的运行器将参数数组传递给子类,但我不确定是否可以使用新的 JUnit 5 api 实现等效的东西。
简短
的回答没有办法按照JUnit 4的风格使用JUnit 5参数化类创建。
幸运的是,分离测试逻辑和测试输入数据(参数)的意图可以不同地实现。
JUnit 5有自己的方法来进行参数化测试,当然,它与JUnit 4不同。新方法不允许在类级别使用参数化夹具,即通过其每个测试方法。因此,每个参数化的测试方法都应该使用指向参数的链接进行显式注释。
JUnit 5提供了大量的参数源类型,可以在文档和指南中找到
在您的情况下,从Junit 4迁移的最简单方法@Parameters
是使用or of 。@MethodSource
@ArgumentsSource
org.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
和一个类 in@ArgumentsSource
可以在任何地方描述,而不仅仅是在测试方法所在的同一个类中。还@MethodSource
允许提供多个源方法,因为它value
是一个String[]
.
一些评论和比较
在JUnit 4中,我们只能有一个提供参数的工厂方法,并且应该围绕这些参数构建测试。相反,JUnit 5在绑定参数方面提供了更多的抽象和灵活性,并将测试逻辑与其参数解耦,这是次要的。这允许独立于参数源构建测试,并在需要时轻松更改它们。
依赖要求
参数化测试功能不包含在核心junit-jupiter-engine
中,但位于单独的依赖项junit-jupiter-params
中。