The custom runner Parameterized
implements parameterized tests. When running a parameterized test class, instances are created for the cross-product of the test methods and the test data elements.
For example, to test a Fibonacci function, write:
Junit4 中通过 Parameterized runner 实现参数化测试。
当执行参数化测试类时,实例的测试方法和测试数据元素将在测试示例创建时交叉连接到一起。
下面是测试菲波那切数的测试方法:
import static org.junit.Assert.assertEquals; import java.util.Arrays; import java.util.Collection; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; @RunWith(Parameterized.class) public class FibonacciTest { @Parameters public static Collection<Object[]> data() { return Arrays.asList(new Object[][] { { 0, 0 }, { 1, 1 }, { 2, 1 }, { 3, 2 }, { 4, 3 }, { 5, 5 }, { 6, 8 } }); } private int fInput; private int fExpected; public FibonacciTest(int input, int expected) { fInput= input; fExpected= expected; } @Test public void test() { assertEquals(fExpected, Fibonacci.compute(fInput)); } }
public class Fibonacci { public static int compute(int n) { int result = 0; if (n <= 1) { result = n; } else { result = compute(n - 1) + compute(n - 2); } return result; } }
每个FibonacciTest类的示例都将通过两个参数的构造器来创建。而这两个参数将通过带有@Parameters注解的方法来获取。
除了构造器注入之外,@Parameters注解支持属性注入
import static org.junit.Assert.assertEquals; import java.util.Arrays; import java.util.Collection; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameter; import org.junit.runners.Parameterized.Parameters; @RunWith(Parameterized.class) public class FibonacciTest { @Parameters public static Collection<Object[]> data() { return Arrays.asList(new Object[][] { { 0, 0 }, { 1, 1 }, { 2, 1 }, { 3, 2 }, { 4, 3 }, { 5, 5 }, { 6, 8 } }); } @Parameter // first data value (0) is default public /* 不能为 private */ int fInput; @Parameter(1) public /* 不能为 private */ int fExpected; @Test public void test() { assertEquals(fExpected, Fibonacci.compute(fInput)); } } public class Fibonacci { ... }注意,目前只支持公共属性的注入
单个参数的测试
如果你的测试只需要单个参数,则不需要将其包装成数组。这种情况下可以提供一个迭代器或对象数组。
@Parameters public static Iterable<? extends Object> data() { return Arrays.asList("first test", "second test"); }
或
@Parameters public static Object[] data() { return new Object[] { "first test", "second test" }; }
识别每个测试用例
为了更容易地区分参数化测试中每个测试用例,你可以在@Parameters 注解上提供一个名称。
此名称可以包含占位符,该占位符在运行时将会被替换。
{index}
: 当前参数的索引{0}, {1}, …
: 第一个参数,第二个参数等,参数值. 注意:单引号'
应该被转义成两个单引号''
.
例子
import static org.junit.Assert.assertEquals; import java.util.Arrays; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; @RunWith(Parameterized.class) public class FibonacciTest { @Parameters(name = "{index}: fib({0})={1}") public static Iterable<Object[]> data() { return Arrays.asList(new Object[][] { { 0, 0 }, { 1, 1 }, { 2, 1 }, { 3, 2 }, { 4, 3 }, { 5, 5 }, { 6, 8 } }); } private int input; private int expected; public FibonacciTest(int input, int expected) { this.input = input; this.expected = expected; } @Test public void test() { assertEquals(expected, Fibonacci.compute(input)); } } public class Fibonacci { ... }
上面这个例子,参数化 runner 创建如 [3: fib(3)=2] 这种名称。如果你没有指定名称,默认使用当前参数的索引。
原文:https://github.com/junit-team/junit4/wiki/Parameterized-tests