Package org.junit.jupiter.engine.descriptor

Class ExtensionUtils

java.lang.Object

org.junit.jupiter.engine.descriptor.ExtensionUtils

final class ExtensionUtils
extends Object

Collection of utilities for working with extensions and the extension registry.

Since:

5.1

See Also:

• ExtensionRegistrar
• MutableExtensionRegistry
• ExtendWith
• RegisterExtension

Field Summary

Fields

Modifier and Type	Field	Description
private static final Comparator<Field>	orderComparator

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ExtensionUtils()

Method Summary

Modifier and Type	Method	Description
private static int	getOrder(Field field)
(package private) static MutableExtensionRegistry	populateNewExtensionRegistryFromExtendWithAnnotation(MutableExtensionRegistry parentRegistry, AnnotatedElement annotatedElement)	Populate a new MutableExtensionRegistry from extension types declared via @ExtendWith on the supplied AnnotatedElement.
(package private) static void	registerExtensionsFromConstructorParameters(ExtensionRegistrar registrar, Class<?> clazz)	Register extensions using the supplied registrar from parameters in the declared constructor of the supplied class that are annotated with @ExtendWith.
(package private) static void	registerExtensionsFromExecutableParameters(ExtensionRegistrar registrar, Executable executable)	Register extensions using the supplied registrar from parameters in the supplied Executable (i.e., a Constructor or Method) that are annotated with @ExtendWith.
(package private) static void	registerExtensionsFromFields(ExtensionRegistrar registrar, Class<?> clazz, Object instance)	Register extensions using the supplied registrar from fields in the supplied class that are annotated with @ExtendWith or @RegisterExtension.
private static Stream<Class<? extends Extension>>	streamExtensionTypes(AnnotatedElement annotatedElement)
private static Stream<Class<? extends Extension>>	streamExtensionTypes(List<ExtendWith> extendWithAnnotations)

Methods inherited from class java.lang.Object

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

Field Details

orderComparator

private static final Comparator<Field> orderComparator

Since:

5.4

Constructor Details

ExtensionUtils

private ExtensionUtils()

Method Details

populateNewExtensionRegistryFromExtendWithAnnotation

static MutableExtensionRegistry populateNewExtensionRegistryFromExtendWithAnnotation(MutableExtensionRegistry parentRegistry,
 AnnotatedElement annotatedElement)

Populate a new MutableExtensionRegistry from extension types declared via @ExtendWith on the supplied AnnotatedElement.

Parameters:

parentRegistry - the parent extension registry to set in the newly created registry; never null

annotatedElement - the annotated element on which to search for declarations of @ExtendWith; never null

Returns:

the new extension registry; never null

Since:

5.0

registerExtensionsFromFields

static void registerExtensionsFromFields(ExtensionRegistrar registrar,
 Class<?> clazz,
 Object instance)

Register extensions using the supplied registrar from fields in the supplied class that are annotated with @ExtendWith or @RegisterExtension.

The extensions will be sorted according to @Order semantics prior to registration.

Parameters:

registrar - the registrar with which to register the extensions; never null

clazz - the class or interface in which to find the fields; never null

instance - the instance of the supplied class; may be null when searching for static fields in the class

registerExtensionsFromConstructorParameters

static void registerExtensionsFromConstructorParameters(ExtensionRegistrar registrar,
 Class<?> clazz)

Register extensions using the supplied registrar from parameters in the declared constructor of the supplied class that are annotated with @ExtendWith.

Parameters:

registrar - the registrar with which to register the extensions; never null

clazz - the class in which to find the declared constructor; never null

Since:

5.8

registerExtensionsFromExecutableParameters

static void registerExtensionsFromExecutableParameters(ExtensionRegistrar registrar,
 Executable executable)

Register extensions using the supplied registrar from parameters in the supplied Executable (i.e., a Constructor or Method) that are annotated with @ExtendWith.

Parameters:

registrar - the registrar with which to register the extensions; never null

executable - the constructor or method whose parameters should be searched; never null

Since:

5.8

streamExtensionTypes

private static Stream<Class<? extends Extension>> streamExtensionTypes(AnnotatedElement annotatedElement)

Since:

5.8

streamExtensionTypes

private static Stream<Class<? extends Extension>> streamExtensionTypes(List<ExtendWith> extendWithAnnotations)

Since:

5.8

getOrder

private static int getOrder(Field field)

Since:

5.4