Parameterized tests are tricky. JUnit's
Parameterized runner is
notoriously bad at giving human-readable test case names (there are several
patch proposal on github but not applied to the trunk at the time of writing
this).
RandomizedRunner has built-in support for parameters using a pair
of static-parameters provider method (factory) and a matching constructor.
The static method has to be public and annotated with ParametersFactory,
as in parameters() method below. Note the funky-looking $
and $$ method which are static varargs collector methods to avoid
explicit array constructors.
@ParametersFactory
public static Iterable parameters() {
return Arrays.asList($$(
$(1, "abc"),
$(2, "def")));
}
The matching class constructor must declare type-assignable parameters. Because method
arguments are not part of the Java reflection, they can be explicitly annotated using
Name annotation to provide sensible names.
The Test007ParameterizedTests(int, String)
constructor shows an example of how this looks.
If there is more than one set of parameters, method names will be postfixed with
a list of parameters and their values. An additional #num identifier will
be added to make tests unique.
ParametersFactory can be combined with other annotations such as
Repeat or Seeds as shown in paramsWithRepeatAndSeeds().