org.junit.runner.manipulation

Class Sorter

java.lang.Object

org.junit.runner.manipulation.Ordering

org.junit.runner.manipulation.Sorter

All Implemented Interfaces:

java.util.Comparator<Description>

Direct Known Subclasses:

Alphanumeric

public class Sorter
extends Ordering
implements java.util.Comparator<Description>

A Sorter orders tests. In general you will not need to use a Sorter directly. Instead, use Request.sortWith(Comparator).

Since:

4.0

Nested Class Summary

Nested classes/interfaces inherited from class org.junit.runner.manipulation.Ordering

Ordering.Context, Ordering.Factory

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Comparator<Description>	comparator
static Sorter	NULL NULL is a Sorter that leaves elements in an undefined order

Constructor Summary

Constructors

Constructor and Description
Sorter(java.util.Comparator<Description> comparator) Creates a Sorter that uses comparator to sort tests

Method Summary

Modifier and Type	Method and Description
void	apply(java.lang.Object target) Sorts the tests in target using comparator.
int	compare(Description o1, Description o2)
protected java.util.List<Description>	orderItems(java.util.Collection<Description> descriptions) Implemented by sub-classes to order the descriptions.
(package private) boolean	validateOrderingIsCorrect() Returns true if this ordering could produce invalid results (i.e.

Methods inherited from class org.junit.runner.manipulation.Ordering

definedBy, definedBy, shuffledBy

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Field Detail

NULL

public static final Sorter NULL

NULL is a Sorter that leaves elements in an undefined order

comparator

private final java.util.Comparator<Description> comparator

Constructor Detail

Sorter

public Sorter(java.util.Comparator<Description> comparator)

Creates a Sorter that uses comparator to sort tests

Parameters:

comparator - the Comparator to use when sorting tests

Since:

4.0

Method Detail

apply

public void apply(java.lang.Object target)

Sorts the tests in target using comparator.

Overrides:

apply in class Ordering

Since:

4.0

compare

public int compare(Description o1,
                   Description o2)

Specified by:

compare in interface java.util.Comparator<Description>

orderItems

protected final java.util.List<Description> orderItems(java.util.Collection<Description> descriptions)

Implemented by sub-classes to order the descriptions.

Specified by:

orderItems in class Ordering

Returns:

descriptions in order

Since:

4.13

validateOrderingIsCorrect

boolean validateOrderingIsCorrect()

Returns true if this ordering could produce invalid results (i.e. if it could add or remove values).

Overrides:

validateOrderingIsCorrect in class Ordering

Since:

4.13