# 使用 JUnit 5 进行参数化单元测试 ## 概述该技能提供了使用 JUnit 5 的 @ParameterizedTest 编写高效参数化单元测试的模式。它涵盖 @ValueSource、@CsvSource、@MethodSource、@EnumSource、@ArgumentsSource 和自定义显示名称，以使用多个输入值运行相同的测试逻辑，从而减少测试重复并提高覆盖率。 ## 何时使用在以下情况下使用此技能： * 具有多个有效输入的测试方法 * 系统地测试边界值 * 测试多个无效输入的错误情况 * 希望减少重复测试 * 使用类似的断言测试多个场景 * 需要数据驱动的测试方法 ## 说明 1. **添加 junit-jupiter-params 依赖项** : 确保 junit-jupiter-params 位于测试类路径上 2. **选择适当的源** ：对于简单值使用@ValueSource，对于表格数据使用@CsvSource，对于复杂对象使用@MethodSource 3. **匹配参数类型** ：确保测试方法参数与数据源类型匹配 4. **使用描述性显示名称**：设置 `name = "..."` 以获得可读的测试输出 5. **测试边界值** ：包括参数中的边缘情况、空值和极值 6. **使用@EnumSource**：测试所有枚举值或过滤特定值 7. **创建自定义ArgumentsProvider**：为复杂场景构建可重用的数据源 8. **保持断言简单**：专注于每个参数化测试的单个断言 ## 示例 ## 设置：参数化测试 ### Maven <依赖关系> org.junit.jupiter junit-jupiter <范围>测试 <依赖关系> org.assertj assertj-core <范围>测试 ### 摇篮依赖项{ testImplementation("org.junit.jupiter:junit-jupiter") testImplementation("org.assertj:assertj-core") } ## 基本模式：@ValueSource ### 简单的值测试导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.ValueSource; 导入静态 org.assertj.core.api.Assertions.*; 类 StringUtilsTest { @参数化测试 @ValueSource(strings = {"hello", "world", "test"}) 无效shouldCapitalizeAllStrings（字符串输入）{ 字符串结果 = StringUtils.capitalize(input); assertThat(结果).startsWith(input.substring(0, 1).toUpperCase()); } @参数化测试 @ValueSource(整数 = {1, 2, 3, 4, 5}) 无效应该BePositive（整数）{ assertThat(number).isPositive(); } @参数化测试 @ValueSource(布尔值 = {true, false}) 无效shouldHandleBothBooleanValues（布尔值）{ 断言（值）.isNotNull（）; } } ## @MethodSource 用于复杂数据 ### 工厂方法数据源导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.MethodSource; 导入 java.util.stream.Stream; 类计算器测试{ 静态流additionTestCases() { 返回 Stream.of( 参数.of(1, 2, 3), 参数.of(0, 0, 0), 参数.of(-1, 1, 0), 参数.of(100, 200, 300), 参数.of(-5, -10, -15) ）； } @参数化测试 @MethodSource("additionTestCases") void shouldAddNumbersCorrectly(int a, int b, int预期) { int 结果 = Calculator.add(a, b); assertThat(结果).isEqualTo(预期); } } ## @CsvSource 用于表格数据 ### 基于 CSV 的测试数据导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.CsvSource; 类用户验证测试{ @参数化测试 @CsvSource({ “alice@example.com，真实”， “bob@gmail.com，真实”， “无效的电子邮件，错误”， “用户@，假”， “@example.com，错误”， “用户名@example.com，false” }) void shouldValidateEmailAddresses(字符串电子邮件，预期布尔值) { 布尔结果 = UserValidator.isValidEmail(email); assertThat(结果).isEqualTo(预期); } @参数化测试 @CsvSource({ “123-456-7890，真实”， “555-123-4567，真实”， “1234567890，假”， “123-45-6789，假”， “abc-def-ghij，假” }) void shouldValidatePhoneNumbers(字符串电话，需要布尔值) { 布尔结果 = PhoneValidator.isValid(phone); assertThat(结果).isEqualTo(预期); } } ## @CsvFileSource 用于外部数据 ### 基于 CSV 文件的测试导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.CsvFileSource; 价格计算测试类 { @参数化测试 @CsvFileSource(资源 = "/test-data/prices.csv", numLinesToSkip = 1) void shouldCalculateTotalPrice(字符串产品，双倍价格，整数数量，双倍预期) { 双精度总计 = PriceCalculator.calculateTotal(价格, 数量); assertThat(总计).isEqualTo(预期); } } // 测试数据/prices.csv： // 产品、价格、数量、预期 // 笔记本电脑,999.99,1,999.99 // 鼠标,29.99,3,89.97 // 键盘,79.99,2,159.98 ## @EnumSource 用于枚举测试 ### 基于枚举的测试数据导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.EnumSource; 枚举状态 { ACTIVE、INACTIVE、PENDING、DELETED } 类 StatusHandlerTest { @参数化测试 @EnumSource(状态.class) 无效shouldHandleAllStatuses（状态状态）{ 断言（状态）.isNotNull（）； } @参数化测试 @EnumSource(值 = Status.class, 名称 = {"ACTIVE", "INACTIVE"}) 无效shouldHandleSpecificStatuses（状态状态）{ assertThat(status).isIn(Status.ACTIVE, Status.INACTIVE); } @参数化测试 @EnumSource(值 = Status.class, 模式 = EnumSource.Mode.EXCLUDE, 名称 = {"DELETED"}) 无效shouldHandleStatusesExclusionDeleted（状态状态）{ assertThat(status).isNotEqualTo(Status.DELETED); } } ## 自定义显示名称 ### 可读的测试输出导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.ValueSource; 类折扣计算测试{ @ParameterizedTest(name = "应正确计算 {0}% 的折扣") @ValueSource(整数 = {5, 10, 15, 20}) 无效shouldApplyDiscount（int折扣百分比）{ 双原始价格 = 100.0; 双倍折扣= DiscountCalculator.apply(originalPrice,discountPercent); 双倍预期 = 原始价格 * (1 - 折扣百分比 / 100.0); assertThat(折扣).isEqualTo(预期); } @ParameterizedTest(name = "用户角色 {0} 应具有 {1} 权限") @CsvSource({ “管理员，100”， “经理，50”， “用户，10” }) 无效shouldHaveCorrectPermissions（字符串角色，intexpectedPermissions）{ 用户 user = new User(角色); assertThat(user.getPermissionCount()).isEqualTo(expectedPermissions); } } ## 组合多个来源 ### 适用于复杂场景的 ArgumentsProvider 导入 org.junit.jupiter.api.extension.ExtensionContext; 导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.Arguments; 导入 org.junit.jupiter.params.provider.ArgumentsProvider; 导入 org.junit.jupiter.params.provider.ArgumentsSource; 导入 java.util.stream.Stream; 类 RangeValidatorArgumentProvider 实现 ArgumentsProvider { @覆盖公共流 ProvideArguments(ExtensionContext context) { 返回 Stream.of( Arguments.of(0, 0, 100, true), // 最小边界 Arguments.of(100, 0, 100, true), // 最大边界 Arguments.of(50, 0, 100, true), // 中间值 Arguments.of(-1, 0, 100, false), // 低于范围 Arguments.of(101, 0, 100, false) // 超出范围）； } } 类 RangeValidatorTest { @参数化测试 @ArgumentsSource(RangeValidatorArgumentProvider.class) void shouldValidateRangeCorrectly(int 值, int 最小值, int 最大值, 预期布尔值) { 布尔结果 = RangeValidator.isInRange(value, min, max); assertThat(结果).isEqualTo(预期); } } ## 使用参数测试边缘情况 ### 边界值分析类边界值测试{ @参数化测试 @ValueSource(整数 = { Integer.MIN_VALUE, // 绝对最小值 Integer.MIN_VALUE + 1, // 略高于最小值 -1, // 负边界 0, // 零边界 1, // 略高于零 Integer.MAX_VALUE - 1, // 略低于最大值 Integer.MAX_VALUE // 绝对最大值 }) 无效shouldHandleAllBoundaryValues（int值）{ int 递增 = MathUtils.increment(value); assertThat(增量).isNotLessThan(值); } @参数化测试 @CsvSource({ ", false", // 空 "'', false", // 空 "' ', false", // 仅空白 "a, true", // 单个字符 "abc, true" // 正常 }) void shouldValidateStrings(字符串输入，需要布尔值) { 布尔结果 = StringValidator.isValid(input); assertThat(结果).isEqualTo(预期); } } ## 重复测试 ### 多次运行相同的测试导入 org.junit.jupiter.api.RepeatedTest; 类并发测试 { @重复测试(100) 无效shouldHandleConcurrentAccess（）{ // 如果运行多次，测试可能会揭示竞争条件 AtomicInteger 计数器 = new AtomicInteger(0); counter.incrementAndGet(); assertThat(counter.get()).isEqualTo(1); } } ## 最佳实践 * **使用@ParameterizedTest**减少测试重复 * **使用描述性显示名称** 和 `(name = "...")` * **系统地测试边界值** * **保持测试逻辑简单** \- 专注于单个断言 * **逻辑地组织测试数据** \- 将相似的场景分组 * **对复杂的测试数据使用@MethodSource** * **使用@CsvSource**来获取表格测试数据 * **在测试名称中记录预期行为** ## 常见模式 **测试错误条件**： @参数化测试 @ValueSource(字符串 = {"", " ", null}) 无效shouldThrowExceptionForInvalidInput（字符串输入）{ assertThatThrownBy(() -> Parser.parse(input)) .isInstanceOf(IllegalArgumentException.class); } **测试多个有效输入**： @参数化测试 @ValueSource(整数 = {1, 2, 3, 5, 8, 13}) void shouldBeInFibonacciSequence(int number) { assertThat(FibonacciChecker.isFibonacci(number)).isTrue(); } ## 限制和警告 * **参数计数必须匹配**：源中的参数数量必须与测试方法签名匹配 * **类型转换是自动的**：JUnit 在可能的情况下将源值转换为目标参数类型 * **@ValueSource 限制** ：仅支持文字（字符串、整数、长整型、双精度型）；不是对象或 null * **CSV 转义** ：包含逗号的字符串必须用单引号括在 @CsvSource 中 * **MethodSource 可见性** : @MethodSource 方法必须是静态的，可以是私有的，但必须位于同一个类中 * **显示名称占位符** ：使用 {0}、{1} 等引用显示名称中的参数 * **测试执行顺序** ：参数化测试将每个参数集作为单独的测试调用执行 ## 故障排除 **参数不匹配**：验证参数的数量和类型与测试方法签名匹配。 **显示名称未显示**：检查 `name = "..."` 中的参数语法。 **CSV 解析错误** ：确保 CSV 格式正确并引用包含逗号的字符串。 ## 参考文献 * [JUnit 5 参数化测试]() * [@ParameterizedTest 文档]() * [边界值分析]()

单元测试参数化

包含技能