Parameterized

extends Suite

java.lang.Object
↳	org.junit.runner.Runner
	↳	org.junit.runners.ParentRunner<T>
		↳	org.junit.runners.Suite
			↳	org.junit.runners.Parameterized

Class Overview

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:

 @RunWith(Parameterized.class)
 public class FibonacciTest {
 	@Parameters
 	public static List<Object[]> data() {
 		return Arrays.asList(new Object[][] {
 				Fibonacci,
 				{ { 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.

Summary

Nested Classes
@interface	Parameterized.Parameters	Annotation for a method which provides parameters to be injected into the test class constructor by `Parameterized`

Public Constructors
	Parameterized(Class<?> klass) Only called reflectively.

Protected Methods
List<Runner>	getChildren() Returns a list of objects that define the children of this Runner.

[Expand]

Inherited Methods

From class org.junit.runners.Suite

From class org.junit.runners.ParentRunner

Statement	childrenInvoker(RunNotifier notifier) Returns a `Statement`: Call `runChild(Object, RunNotifier)` on each object returned by `getChildren()` (subject to any imposed filter and sort)
Statement	classBlock(RunNotifier notifier) Constructs a `Statement` to run all of the tests in the test class.
void	collectInitializationErrors(List<Throwable> errors) Adds to `errors` a throwable for each problem noted with the test class (available from `getTestClass()`).
abstract Description	describeChild(T child) Returns a `Description` for `child`, which can be assumed to be an element of the list returned by `getChildren()`
void	filter(Filter filter) Remove tests that don't pass the parameter `filter`.
abstract List<T>	getChildren() Returns a list of objects that define the children of this Runner.
Description	getDescription()
String	getName() Returns a name used to describe this Runner
final TestClass	getTestClass() Returns a `TestClass` object wrapping the class to be executed.
void	run(RunNotifier notifier) Run the tests for this runner.
abstract void	runChild(T child, RunNotifier notifier) Runs the test corresponding to `child`, which can be assumed to be an element of the list returned by `getChildren()`.
void	setScheduler(RunnerScheduler scheduler) Sets a scheduler that determines the order and parallelization of children.
void	sort(Sorter sorter) Sorts the tests using `sorter`
void	validatePublicVoidNoArgMethods(Class<? extends Annotation> annotation, boolean isStatic, List<Throwable> errors) Adds to `errors` if any method in this class is annotated with `annotation`, but: is not public, or takes parameters, or returns something other than void, or is static (given `isStatic is false`), or is not static (given `isStatic is true`).
Statement	withAfterClasses(Statement statement) Returns a `Statement`: run all non-overridden `@AfterClass` methods on this class and superclasses before executing `statement`; all AfterClass methods are always executed: exceptions thrown by previous steps are combined, if necessary, with exceptions from AfterClass methods into a `MultipleFailureException`.
Statement	withBeforeClasses(Statement statement) Returns a `Statement`: run all non-overridden `@BeforeClass` methods on this class and superclasses before executing `statement`; if any throws an Exception, stop execution and pass the exception on.