Package org.junit.jupiter.api

Class ClassOrderer.Random

java.lang.Object

org.junit.jupiter.api.ClassOrderer.Random

All Implemented Interfaces:

ClassOrderer

Enclosing interface:

ClassOrderer

public static class ClassOrderer.Random
extends java.lang.Object
implements ClassOrderer

ClassOrderer that orders classes pseudo-randomly.

Custom Seed

By default, the random seed used for ordering classes is the value returned by System.nanoTime() during static initialization of this class. In order to support repeatable builds, the value of the default random seed is logged at CONFIG level. In addition, a custom seed (potentially the default seed from the previous test plan execution) may be specified via the junit.jupiter.execution.order.random.seed configuration parameter which can be supplied via the Launcher API, build tools (e.g., Gradle and Maven), a JVM system property, or the JUnit Platform configuration file (i.e., a file named junit-platform.properties in the root of the class path). Consult the User Guide for further information.

See Also:

RANDOM_SEED_PROPERTY_NAME, Random

Nested Class Summary

Nested classes/interfaces inherited from interface org.junit.jupiter.api.ClassOrderer

ClassOrderer.ClassName, ClassOrderer.DisplayName, ClassOrderer.OrderAnnotation, ClassOrderer.Random

Field Summary

Fields

Modifier and Type	Field	Description
private static long	DEFAULT_SEED	Default seed, which is generated during initialization of this class via System.nanoTime() for reproducibility of tests.
private static Logger	logger
static java.lang.String	RANDOM_SEED_PROPERTY_NAME	Property name used to set the random seed used by this ClassOrderer: "junit.jupiter.execution.order.random.seed"

Constructor Summary

Constructors

Constructor	Description
Random()

Method Summary

Modifier and Type	Method	Description
private java.util.Optional<java.lang.Long>	getCustomSeed(ClassOrdererContext context)
void	orderClasses(ClassOrdererContext context)	Order the classes encapsulated in the supplied ClassOrdererContext pseudo-randomly.

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Logger logger

DEFAULT_SEED

private static final long DEFAULT_SEED

Default seed, which is generated during initialization of this class via System.nanoTime() for reproducibility of tests.

RANDOM_SEED_PROPERTY_NAME

public static final java.lang.String RANDOM_SEED_PROPERTY_NAME

Property name used to set the random seed used by this ClassOrderer: "junit.jupiter.execution.order.random.seed"

The same property is used by MethodOrderer.Random for consistency between the two random orderers.

Supported Values

Supported values include any string that can be converted to a Long via Long.valueOf(String).

If not specified or if the specified value cannot be converted to a Long, the default random seed will be used (see the class-level Javadoc for details).

See Also:

MethodOrderer.Random, Constant Field Values

Constructor Detail

Random

public Random()

Method Detail

orderClasses

public void orderClasses(ClassOrdererContext context)

Order the classes encapsulated in the supplied ClassOrdererContext pseudo-randomly.

Specified by:

orderClasses in interface ClassOrderer

Parameters:

context - the ClassOrdererContext containing the class descriptors to order; never null

getCustomSeed

private java.util.Optional<java.lang.Long> getCustomSeed(ClassOrdererContext context)