public class Parameterized
extends org.junit.runners.Suite
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.
@RunWith(Parameterized.class)
public class FibonacciTest {
@Parameters(name= "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 fInput;
private int fExpected;
public FibonacciTest(int input, int expected) {
fInput= input;
fExpected= expected;
}
@Test
public void test() {
assertEquals(fExpected, Fibonacci.compute(fInput));
}
}
Each instance of FibonacciTest will be constructed using the
two-argument constructor and the data values in the
@Parameters method.
In order that you can easily identify the individual tests, you may provide a
name for the @Parameters annotation. This name is allowed
to contain placeholders, which are replaced at runtime. The placeholders are
Parameterized runner creates
names like fib(3)=2. If you don't use the name parameter, then
the current parameter index is used as name.
You can also write:
@RunWith(Parameterized.class)
public class FibonacciTest {
@Parameters
public static Iterable<Object[]> data() {
return Arrays.asList(new Object[][] { { 0, 0 }, { 1, 1 }, { 2, 1 },
{ 3, 2 }, { 4, 3 }, { 5, 5 }, { 6, 8 } });
}
@Parameter(0)
public int fInput;
@Parameter(1)
public int fExpected;
@Test
public void test() {
assertEquals(fExpected, Fibonacci.compute(fInput));
}
}
Each instance of FibonacciTest will be constructed without constructor
and fields annoted by @Parameter will be initialized
with the data values in the @Parameters method.
| Modifier and Type | Class and Description |
|---|---|
static interface |
Parameterized.Parameter
Annotation for fields of the test class which will be initialized by the
method annoted by
ParametersBy using directly this annotation, the test class constructor isn't needed. Index range must start at 0. |
static interface |
Parameterized.Parameters
Annotation for a method which provides parameters to be injected into the
test class constructor by
Parameterized |
| Constructor and Description |
|---|
Parameterized(java.lang.Class<?> klass)
Only called reflectively.
|
| Modifier and Type | Method and Description |
|---|---|
protected java.util.List<org.junit.runner.Runner> |
getChildren() |
childrenInvoker, classBlock, classRules, collectInitializationErrors, filter, getDescription, getName, getRunnerAnnotations, getTestClass, run, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods, withAfterClasses, withBeforeClasses