在软件测试中，尤其是在单元测试和集成测试阶段，我们经常需要对同一段逻辑或同一个接口的不同实现进行验证。传统的做法可能是为每种实现编写一个独立的测试方法，但这会导致代码冗余和维护成本增加。依赖注入（DI）的思想在测试中同样适用，即在运行时向测试方法提供其所需的依赖对象，从而使测试逻辑能够复用于不同的对象实例。
JUnit 5 提供了强大的参数化测试功能，这正是实现自定义对象依赖注入的关键机制。虽然 JUnit 5 自身可以注入 TestInfo、TestReporter 等测试上下文对象，但对于注入自定义的业务对象或数据对象，我们需要利用参数化测试来动态提供。
核心概念：参数化测试与依赖注入
JUnit 5 的参数化测试允许我们使用不同的参数多次运行同一个测试方法。当这些参数是待测试的依赖对象时，就实现了测试层面的依赖注入。其中，@ParameterizedTest 注解用于标记一个参数化测试方法，而 @MethodSource 注解则指定一个静态方法作为参数的来源。
@MethodSource 注解指向的方法需要返回一个 Stream extends Arguments> 或 Stream> 类型的数据流，其中 Arguments.of() 方法用于封装单个测试执行所需的参数。通过这种方式，我们可以构造并提供任何类型的对象实例给测试方法。
实现步骤与代码示例
为了演示如何在 JUnit 5 中实现自定义对象的依赖注入，我们假设有一个 Base 类及其几个派生类 Class1、Class2 和 Class3。我们的目标是编写一个测试方法，能够接收 Base 类型的对象，并针对 Class1、Class2 和 Class3 的实例分别执行测试。
1. 定义基类和派生类
首先，我们定义一个基类 Base 以及继承自 Base 的派生类 Class1、Class2 和 Class3。这些类可以包含任何数据或方法，这里仅作简单示例。
// Base.java
class Base {
// 可以在这里添加公共属性或方法
@Override
public String toString() {
return "Base instance";
}
}
// Class1.java
class Class1 extends Base {
@Override
public String toString() {
return "Class1 instance";
}
}
// Class2.java
class Class2 extends Base {
@Override
public String toString() {
return "Class2 instance";
}
}
// Class3.java
class Class3 extends Base {
@Override
public String toString() {
return "Class3 instance";
}
}2. 创建参数源方法
接下来，我们需要创建一个静态方法，该方法将作为参数的来源。这个方法必须返回 Stream
import org.junit.jupiter.params.provider.Arguments;
import java.util.stream.Stream;
public class Test1 {
// ... (其他代码，如测试方法)
/**
* 提供测试方法 myTest 所需参数的静态方法。
* 必须是静态方法，且返回 Stream。
* 每个 Arguments.of() 调用提供一组参数。
*
* @return 包含不同 Base 派生类实例的参数流
*/
static Stream myTest_Arguments() {
return Stream.of(
Arguments.of(new Class1()), // 提供 Class1 实例
Arguments.of(new Class2()), // 提供 Class2 实例
Arguments.of(new Class3()) // 提供 Class3 实例
);
}
} 3. 编写参数化测试方法
最后，我们编写测试方法。使用 @ParameterizedTest 注解标记该方法，并通过 @MethodSource 注解指定参数源方法的名称。测试方法的参数类型应与参数源方法中提供的参数类型匹配。
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.Arguments;
import org.junit.jupiter.params.provider.MethodSource;
import java.util.stream.Stream;
// 定义基类和派生类（同上）
class Base { /* ... */ }
class Class1 extends Base { /* ... */ }
class Class2 extends Base { /* ... */ }
class Class3 extends Base { /* ... */ }
public class Test1 {
/**
* 参数化测试方法，接收一个 Base 类型的对象。
* 该方法将为 myTest_Arguments() 方法提供的每个参数执行一次。
*
* @param baseObj 通过依赖注入提供的 Base 或其派生类实例
*/
@ParameterizedTest
@MethodSource("myTest_Arguments") // 指定参数来源方法
public void myTest(Base baseObj){
// 在这里编写针对 baseObj 的测试逻辑
System.out.println("Testing with: " + baseObj);
// 例如，可以使用断言来验证 baseObj 的行为
// Assertions.assertNotNull(baseObj);
// Assertions.assertTrue(baseObj instanceof Base);
}
/**
* 提供测试方法 myTest 所需参数的静态方法。
* 必须是静态方法，且返回 Stream。
*
* @return 包含不同 Base 派生类实例的参数流
*/
static Stream myTest_Arguments() {
return Stream.of(
Arguments.of(new Class1()),
Arguments.of(new Class2()),
Arguments.of(new Class3())
);
}
} 当运行 myTest 方法时，JUnit 5 会自动调用 myTest_Arguments() 方法获取参数流，然后为流中的每个 Arguments 对象执行一次 myTest 方法，并将相应的对象注入到 baseObj 参数中。
Maven 依赖配置
为了使上述 JUnit 5 参数化测试能够正常运行，您需要在项目的 pom.xml 文件中添加以下 Maven 依赖：
org.junit.jupiter junit-jupiter-api 5.9.0 test org.junit.jupiter junit-jupiter-params 5.9.0 test org.junit.jupiter junit-jupiter-engine 5.9.0 test
请确保 version 标签中的版本号与您项目中使用的 JUnit 5 版本一致。
注意事项与总结
- 参数源方法的可见性与静态性： @MethodSource 注解引用的方法必须是 static 的，且通常是 private 或 package-private。它不能是实例方法。
-
返回类型： 参数源方法必须返回 Stream
。Arguments.of() 是一个便捷的方法，用于将多个参数封装成一个 Arguments 对象。如果您的测试方法只有一个参数，也可以直接返回 Stream - 类型匹配： 参数源方法提供的参数类型必须与 @ParameterizedTest 方法的参数类型兼容。在上述示例中，我们提供了 Class1、Class2、Class3 的实例，它们都兼容 Base 类型。
- 灵活性： @MethodSource 提供了极大的灵活性，您可以从数据库、文件、外部配置等任何来源动态生成测试数据对象。
- 替代方案： 除了 @MethodSource，JUnit 5 还提供了其他参数源，如 @ValueSource（用于基本类型和字符串）、@CsvSource（用于CSV格式数据）、@EnumSource（用于枚举类型）等。但对于自定义对象或复杂数据结构，@MethodSource 是最强大的选择。
通过将依赖注入与 JUnit 5 的参数化测试相结合，我们能够编写出更健壮、更灵活且更易于维护的测试代码。这种方法特别适用于测试多态性行为、不同配置下的功能验证，或任何需要用不同对象实例重复执行相同测试逻辑的场景。
