Java Academy · 课时

使用 @CsvSource 和 @MethodSource 编写参数化测试

使用 @ParameterizedTest、@CsvSource 和 @MethodSource，让同一个测试运行多组输入

使用 @CsvSource 和 @MethodSource 编写参数化测试 是 CoddyKit 上的免费 Java Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Java Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Java Academy 课程共包含 4 节课。

为什么使用参数化测试？

使用多组输入运行相同的测试逻辑，可以在不复制粘贴测试方法的情况下发现边界情况。JUnit 5 通过 @ParameterizedTest 原生支持参数化测试。

@ValueSource：简单的单值测试

@ValueSource 为指定类型提供一个参数。测试会针对每个值运行一次。

@ParameterizedTest
@ValueSource(strings = {"", "  ", "\t"})
void blank_strings_are_rejected(String input) {
    assertThrows(IllegalArgumentException.class, () -> validator.validate(input));
}

@CsvSource：内联提供多个参数

@CsvSource 提供由逗号分隔的值组成的行。每一行都会触发一次测试调用。字符串值中包含逗号时，请使用单引号进行转义。

@ParameterizedTest
@CsvSource({
    "Alice, 30, true",
    "Bob,   17, false",
    "Carol, 0,  false"
})
void test_adult_check(String name, int age, boolean expectedAdult) {
    User user = new User(name, age);
    assertEquals(expectedAdult, user.isAdult());
}

使用 delimiterString 的 @CsvSource

当分隔符包含多个字符，或数据中包含逗号时，请使用 delimiterString。使用 nullValues 将占位字符串映射为 null。

@ParameterizedTest
@CsvSource(value = {
    "Alice | 30 | ADMIN",
    "Bob   | 25 | USER"
}, delimiterString = "|")
void test_roles(String name, int age, String role) { ... }

@CsvFileSource：外部数据文件

从类路径中的 CSV 文件加载测试数据。对于较大的数据集，这样可以避免测试代码过于杂乱。

@ParameterizedTest
@CsvFileSource(resources = "/test-data/users.csv", numLinesToSkip = 1)
void test_from_file(String name, int age, boolean expected) {
    assertEquals(expected, service.isEligible(name, age));
}

@MethodSource：复杂参数

@MethodSource 会调用一个返回 Stream<Arguments> 的静态工厂方法。每个 Arguments.of() 都会触发一次测试调用。它适用于复杂对象。

@ParameterizedTest
@MethodSource("provideOrders")
void test_total_calculation(Order order, BigDecimal expected) {
    assertEquals(expected, orderService.calculateTotal(order));
}
static Stream<Arguments> provideOrders() {
    return Stream.of(
        Arguments.of(new Order(List.of(item(10), item(20))), BigDecimal.valueOf(30)),
        Arguments.of(new Order(List.of()),                   BigDecimal.ZERO)
    );
}

@EnumSource：测试所有枚举值

@EnumSource 会针对每个枚举常量运行一次测试。使用 mode 和 names 可以包含或排除特定值。

@ParameterizedTest
@EnumSource(value = UserStatus.class, mode = EnumSource.Mode.EXCLUDE, names = "DELETED")
void test_active_statuses(UserStatus status) {
    assertTrue(notificationService.shouldNotify(status));
}

@NullAndEmptySource

这是测试 null 和空字符串输入的简写形式。您可以使用 @NullSource + @EmptySource 将其与 @ValueSource 组合，也可以直接使用组合注解 @NullAndEmptySource。

@ParameterizedTest
@NullAndEmptySource
void null_and_empty_are_invalid(String input) {
    assertFalse(validator.isValid(input));
}

自定义显示名称

在 @ParameterizedTest 中使用 name 设置测试显示名称的格式。占位符包括：{index}、{0}、{1} 和 {arguments}。

@ParameterizedTest(name = "age={1} should be adult={2}")
@CsvSource({"Alice, 30, true", "Bob, 17, false"})
void test_adult(String name, int age, boolean expected) { ... }

使用 @ArgumentsSource 组合参数源

实现 ArgumentsProvider，即可完全自定义参数生成方式，例如从数据库、文件或 API 动态获取数据。

public class UserArgumentsProvider implements ArgumentsProvider {
    public Stream<? extends Arguments> provideArguments(ExtensionContext ctx) {
        return Stream.of(
            Arguments.of(new User("Alice", 30)),
            Arguments.of(new User("Bob", 17))
        );
    }
}
@ParameterizedTest
@ArgumentsSource(UserArgumentsProvider.class)
void test_user(User user) { ... }

针对边界值进行参数化测试

系统地测试边界条件：min-1、min、max、max+1。参数化测试让边界覆盖范围更易读、更易维护。

@ParameterizedTest
@CsvSource({"0, false", "1, true", "100, true", "101, false"})
void test_range_boundaries(int value, boolean expected) {
    assertEquals(expected, validator.isInRange(value, 1, 100));
}

快速检查

@MethodSource 返回哪种类型来提供每次测试调用的参数？

回顾

内联表格数据使用 @CsvSource，复杂对象使用 @MethodSource，所有枚举值使用 @EnumSource，null/空值边界情况使用 @NullAndEmptySource。使用 name= 自定义名称可以提高测试的可读性。

常见问题解答

「使用 @CsvSource 和 @MethodSource 编写参数化测试」课时是免费的吗？

是的 — 「使用 @CsvSource 和 @MethodSource 编写参数化测试」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Java Academy 课程的其余内容，请升级到 CoddyKit PRO。 Java Academy 课程共包含 4 节课。

「使用 @CsvSource 和 @MethodSource 编写参数化测试」这节课中我会学到什么？

使用 @ParameterizedTest、@CsvSource 和 @MethodSource，让同一个测试运行多组输入你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Java Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Java Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「使用 @CsvSource 和 @MethodSource 编写参数化测试」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Java Academy 课中编写并运行代码吗？

能。每节 Java Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

使用 @CsvSource 和 @MethodSource 编写参数化测试
Mockito 进阶：参数捕获器与间谍
Spring Boot 测试切片：@WebMvcTest 与 @DataJpaTest
Testcontainers：真实数据库集成测试

← 返回 Java Academy