Class Ordering

java.lang.Object

org.junit.runner.manipulation.Ordering

Direct Known Subclasses:

Sorter

public abstract class Ordering
extends Object

Reorders tests. An Ordering can reverse the order of tests, sort the order or even shuffle the order.

In general you will not need to use a Ordering directly. Instead, use Request.orderWith(Ordering).

Since:

4.13

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Ordering.Context	Context about the ordering being applied.
static interface	Ordering.Factory	Factory for creating Ordering instances.

Constructor Summary

Constructors

Constructor	Description
Ordering()

Method Summary

Modifier and Type	Method	Description
void	apply(Object target)	Order the tests in target using this ordering.
static Ordering	definedBy(Class<? extends Ordering.Factory> factoryClass, Description annotatedTestClass)	Creates an Ordering from the given factory class.
static Ordering	definedBy(Ordering.Factory factory, Description annotatedTestClass)	Creates an Ordering from the given factory.
protected abstract List<Description>	orderItems(Collection<Description> descriptions)	Implemented by sub-classes to order the descriptions.
static Ordering	shuffledBy(Random random)	Creates an Ordering that shuffles the items using the given Random instance.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Ordering

public Ordering()

Method Details

shuffledBy

public static Ordering shuffledBy(Random random)

Creates an Ordering that shuffles the items using the given Random instance.

definedBy

public static Ordering definedBy(Class<? extends Ordering.Factory> factoryClass,
 Description annotatedTestClass)
                          throws InvalidOrderingException

Creates an Ordering from the given factory class. The class must have a public no-arg constructor.

Parameters:

factoryClass - class to use to create the ordering

annotatedTestClass - test class that is annotated with OrderWith.

Throws:

InvalidOrderingException - if the instance could not be created

definedBy

public static Ordering definedBy(Ordering.Factory factory,
 Description annotatedTestClass)
                          throws InvalidOrderingException

Creates an Ordering from the given factory.

Parameters:

factory - factory to use to create the ordering

annotatedTestClass - test class that is annotated with OrderWith.

Throws:

InvalidOrderingException - if the instance could not be created

apply

public void apply(Object target)
           throws InvalidOrderingException

Order the tests in target using this ordering.

Throws:

InvalidOrderingException - if ordering does something invalid (like remove or add children)

orderItems

protected abstract List<Description> orderItems(Collection<Description> descriptions)

Implemented by sub-classes to order the descriptions.

Returns:

descriptions in order