Class MutableExtensionRegistry
- All Implemented Interfaces:
ExtensionRegistrar
,ExtensionRegistry
ExtensionRegistry
.- Since:
- 5.5
-
Method Summary
Modifier and TypeMethodDescriptionstatic MutableExtensionRegistry
createRegistryFrom
(MutableExtensionRegistry parentRegistry, Stream<Class<? extends Extension>> extensionTypes) Factory for creating and populating a new registry from a list of extension types and a parent registry.static MutableExtensionRegistry
createRegistryWithDefaultExtensions
(JupiterConfiguration configuration) Factory for creating and populating a new root registry with the default extensions.void
initializeExtensions
(Class<?> testClass, Object testInstance) Initialize all registered extensions for the suppliedtestClass
using the suppliedtestInstance
.void
registerExtension
(Class<? extends Extension> extensionType) Instantiate an extension of the given type using its default constructor and register it in the registry.void
registerExtension
(Extension extension, Object source) Register the suppliedExtension
, without checking if an extension of that type has already been registered.void
registerSyntheticExtension
(Extension extension, Object source) Register the suppliedExtension
as a synthetic extension, without checking if an extension of that type has already been registered.void
registerUninitializedExtension
(Class<?> testClass, Field source, Function<Object, ? extends Extension> initializer) Register an uninitialized extension for the suppliedtestClass
to be initialized using the suppliedinitializer
when an instance of the test class is created.Stream allExtensions
of the specified type that are present in this registry or one of its ancestors.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.junit.jupiter.engine.extension.ExtensionRegistry
getExtensions
-
Method Details
-
createRegistryWithDefaultExtensions
public static MutableExtensionRegistry createRegistryWithDefaultExtensions(JupiterConfiguration configuration) Factory for creating and populating a new root registry with the default extensions.If the
Constants.EXTENSIONS_AUTODETECTION_ENABLED_PROPERTY_NAME
configuration parameter has been set totrue
, extensions will be auto-detected using Java'sServiceLoader
mechanism and automatically registered after the default extensions.- Parameters:
configuration
- configuration parameters used to retrieve the extension auto-detection flag; nevernull
- Returns:
- a new
ExtensionRegistry
; nevernull
-
createRegistryFrom
public static MutableExtensionRegistry createRegistryFrom(MutableExtensionRegistry parentRegistry, Stream<Class<? extends Extension>> extensionTypes) Factory for creating and populating a new registry from a list of extension types and a parent registry.- Parameters:
parentRegistry
- the parent registryextensionTypes
- the types of extensions to be registered in the new registry- Returns:
- a new
ExtensionRegistry
; nevernull
-
stream
Description copied from interface:ExtensionRegistry
Stream allExtensions
of the specified type that are present in this registry or one of its ancestors.- Specified by:
stream
in interfaceExtensionRegistry
- Parameters:
extensionType
- the type ofExtension
to stream- See Also:
-
registerExtension
Description copied from interface:ExtensionRegistrar
Instantiate an extension of the given type using its default constructor and register it in the registry.A new
Extension
should not be registered if an extension of the given type already exists in the registry or a parent registry.- Specified by:
registerExtension
in interfaceExtensionRegistrar
- Parameters:
extensionType
- the type of extension to register
-
registerExtension
Description copied from interface:ExtensionRegistrar
Register the suppliedExtension
, without checking if an extension of that type has already been registered.Semantics for Source
If an extension is registered declaratively via
@ExtendWith
, thesource
and theextension
should be the same object. However, if an extension is registered programmatically via@RegisterExtension
, thesource
object should be theField
that is annotated with@RegisterExtension
. Similarly, if an extension is registered programmatically as a lambda expression or method reference, thesource
object should be the underlyingMethod
that implements the extension API.- Specified by:
registerExtension
in interfaceExtensionRegistrar
- Parameters:
extension
- the extension to register; nevernull
source
- the source of the extension; nevernull
-
registerSyntheticExtension
Description copied from interface:ExtensionRegistrar
Register the suppliedExtension
as a synthetic extension, without checking if an extension of that type has already been registered.- Specified by:
registerSyntheticExtension
in interfaceExtensionRegistrar
- Parameters:
extension
- the extension to register; nevernull
source
- the source of the extension; nevernull
- See Also:
-
registerUninitializedExtension
public void registerUninitializedExtension(Class<?> testClass, Field source, Function<Object, ? extends Extension> initializer) Description copied from interface:ExtensionRegistrar
Register an uninitialized extension for the suppliedtestClass
to be initialized using the suppliedinitializer
when an instance of the test class is created.Uninitialized extensions are typically registered for fields annotated with
@RegisterExtension
that cannot be initialized until an instance of the test class is created. Until they are initialized, such extensions are not available for use.- Specified by:
registerUninitializedExtension
in interfaceExtensionRegistrar
- Parameters:
testClass
- the test class for which the extension is registered; nevernull
source
- the source of the extension; nevernull
initializer
- the initializer function to be used to create the extension; nevernull
-
initializeExtensions
Description copied from interface:ExtensionRegistrar
Initialize all registered extensions for the suppliedtestClass
using the suppliedtestInstance
.- Specified by:
initializeExtensions
in interfaceExtensionRegistrar
- Parameters:
testClass
- the test class for which the extensions are initialized; nevernull
testInstance
- the test instance to be used to initialize the extensions; nevernull
-