org.junit.runner.manipulation
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

       

Ordering

public Ordering()

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

Copyright © 2002–2021 JUnit. All rights reserved.