编辑“︁Java参数化测试”︁

= Java参数化测试 =

参数化测试（Parameterized Testing）是单元测试的一种高级技术，允许开发者使用不同的输入参数多次运行同一个测试逻辑。这种方法可以显著减少重复代码，同时提高测试覆盖率。在Java中，JUnit框架通过`@ParameterizedTest`注解提供了对参数化测试的原生支持。

== 基本概念 ==
参数化测试的核心思想是将'''测试数据'''与'''测试逻辑'''分离。传统测试方法中，每个测试用例通常需要单独编写，而参数化测试允许通过单一测试方法验证多组输入数据。

主要优势包括：
* 减少代码重复
* 提高测试可维护性
* 更容易添加新的测试案例
* 清晰展示输入输出关系

== JUnit中的实现 ==
JUnit 5提供了完整的参数化测试支持，主要通过以下注解实现：

{| class="wikitable"
|-
! 注解 !! 用途
|-
| <code>@ParameterizedTest</code> || 标记方法为参数化测试
|-
| <code>@ValueSource</code> || 提供基本类型的值数组
|-
| <code>@MethodSource</code> || 引用工厂方法提供参数
|-
| <code>@CsvSource</code> || 使用CSV格式提供参数
|-
| <code>@CsvFileSource</code> || 从CSV文件加载参数
|}

=== 基础示例 ===
以下示例展示如何使用<code>@ValueSource</code>测试字符串长度：

<syntaxhighlight lang="java">
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class StringTest {
    
    @ParameterizedTest
    @ValueSource(strings = {"hello", "world", "junit"})
    void testStringLength(String input) {
        assertTrue(input.length() > 3);
    }
}
</syntaxhighlight>

'''执行结果'''：该测试会分别对"hello"、"world"和"junit"三个输入值运行，验证每个字符串的长度是否大于3。

== 高级参数源 ==

=== 方法源（MethodSource） ===
当需要复杂参数时，可以使用静态方法提供参数：

<syntaxhighlight lang="java">
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.MethodSource;
import java.util.stream.Stream;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculatorTest {

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

    @ParameterizedTest
    @MethodSource("provideAddTestData")
    void testAdd(int a, int b, int expected) {
        assertEquals(expected, a + b);
    }
}
</syntaxhighlight>

'''说明'''：<code>provideAddTestData()</code>方法返回一个包含多组参数的流，每组参数对应测试方法的一次执行。

=== CSV源 ===
对于表格型数据，可以使用CSV格式：

<syntaxhighlight lang="java">
@ParameterizedTest
@CsvSource({
    "2, 3, 5",
    "10, -5, 5",
    "0, 0, 0"
})
void testAddWithCsv(int a, int b, int expected) {
    assertEquals(expected, a + b);
}
</syntaxhighlight>

== 自定义参数转换 ==
JUnit 5允许通过<code>ArgumentConverter</code>实现自定义参数转换：

<syntaxhighlight lang="java">
@ParameterizedTest
@CsvSource({
    "2023-01-01, 2023-01-02",
    "2023-12-31, 2024-01-01"
})
void testDateIncrement(
    @ConvertWith(DateConverter.class) LocalDate input,
    @ConvertWith(DateConverter.class) LocalDate expected) {
    assertEquals(expected, input.plusDays(1));
}
</syntaxhighlight>

== 实际应用案例 ==
考虑一个电商系统中的折扣计算器：

<syntaxhighlight lang="java">
public class DiscountCalculator {
    public double calculateDiscount(int purchaseAmount) {
        if (purchaseAmount > 1000) return 0.2;
        if (purchaseAmount > 500) return 0.1;
        return 0;
    }
}
</syntaxhighlight>

对应的参数化测试：

<syntaxhighlight lang="java">
@ParameterizedTest
@CsvSource({
    "100, 0",
    "600, 0.1",
    "1200, 0.2"
})
void testDiscountCalculation(int amount, double expectedDiscount) {
    DiscountCalculator calculator = new DiscountCalculator();
    assertEquals(expectedDiscount, calculator.calculateDiscount(amount));
}
</syntaxhighlight>

== 可视化参数流 ==
参数化测试的数据流动可以用mermaid表示：

<mermaid>
graph LR
    A[参数源] --> B[参数化测试方法]
    B --> C{断言验证}
    C --> D[测试结果]
</mermaid>

== 数学基础 ==
从形式化角度看，参数化测试实现了测试函数<math>f</math>对输入集合<math>X = \{x_1, x_2, ..., x_n\}</math>的验证：

<math>
\forall x \in X, f(x) \text{ 满足断言条件 }
</math>

== 最佳实践 ==
1. 保持参数化测试方法名称的通用性
2. 为每组参数提供有意义的显示名称（使用<code>name</code>属性）
3. 避免在参数化测试中使用过多条件逻辑
4. 对于复杂对象，考虑使用<code>@MethodSource</code>或自定义转换器
5. 确保每组参数都是独立的，不依赖执行顺序

== 常见问题 ==
'''Q: 参数化测试与传统测试方法相比有何优势？'''
A: 参数化测试减少了代码重复，使测试更易于维护，特别是在验证相同逻辑但不同输入时。

'''Q: 如何处理异常情况的参数化测试？'''
A: 可以使用<code>assertThrows</code>结合参数化测试：

<syntaxhighlight lang="java">
@ParameterizedTest
@ValueSource(ints = {-1, 0})
void testInvalidInput(int input) {
    assertThrows(IllegalArgumentException.class, 
        () -> calculator.calculate(input));
}
</syntaxhighlight>

== 总结 ==
Java参数化测试是提高测试效率和覆盖率的强大工具。通过JUnit 5提供的丰富参数源和灵活配置，开发者可以创建简洁而全面的测试套件。掌握这项技术将显著提升单元测试的质量和可维护性。

[[Category:编程语言]]
[[Category:Java]]
[[Category:Java单元测试]]