Class MutableExtensionRegistry
- java.lang.Object
-
- org.junit.jupiter.engine.extension.MutableExtensionRegistry
-
- All Implemented Interfaces:
ExtensionRegistrar
,ExtensionRegistry
@API(status=INTERNAL, since="5.5") public class MutableExtensionRegistry extends java.lang.Object implements ExtensionRegistry, ExtensionRegistrar
Default, mutable implementation ofExtensionRegistry
.A registry has a reference to its parent registry, and all lookups are performed first in the current registry itself and then recursively in its ancestors.
- Since:
- 5.5
-
-
Field Summary
Fields Modifier and Type Field Description private static java.util.List<Extension>
DEFAULT_EXTENSIONS
private static Logger
logger
private MutableExtensionRegistry
parent
private java.util.List<Extension>
registeredExtensions
private java.util.Set<java.lang.Class<? extends Extension>>
registeredExtensionTypes
-
Constructor Summary
Constructors Modifier Constructor Description private
MutableExtensionRegistry(MutableExtensionRegistry parent)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static MutableExtensionRegistry
createRegistryFrom(MutableExtensionRegistry parentRegistry, java.util.List<java.lang.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.private boolean
isAlreadyRegistered(java.lang.Class<? extends Extension> extensionType)
Determine if the supplied type is already registered in this registry or in a parent registry.private static Extension
newScriptExecutionCondition()
private static void
registerAutoDetectedExtensions(MutableExtensionRegistry extensionRegistry)
private void
registerDefaultExtension(Extension extension)
(package private) void
registerExtension(java.lang.Class<? extends Extension> extensionType)
Instantiate an extension of the given type using its default constructor and register it in this registry.private void
registerExtension(Extension extension)
void
registerExtension(Extension extension, java.lang.Object source)
Register the suppliedExtension
, without checking if an extension of that type already exists.<E extends Extension>
java.util.stream.Stream<E>stream(java.lang.Class<E> extensionType)
Stream allExtensions
of the specified type that are present in this registry or one of its ancestors.private <E extends Extension>
java.util.stream.Stream<E>streamLocal(java.lang.Class<E> extensionType)
Stream allExtensions
of the specified type that are present in this registry.-
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, getReversedExtensions
-
-
-
-
Field Detail
-
logger
private static final Logger logger
-
DEFAULT_EXTENSIONS
private static final java.util.List<Extension> DEFAULT_EXTENSIONS
-
parent
private final MutableExtensionRegistry parent
-
registeredExtensionTypes
private final java.util.Set<java.lang.Class<? extends Extension>> registeredExtensionTypes
-
registeredExtensions
private final java.util.List<Extension> registeredExtensions
-
-
Constructor Detail
-
MutableExtensionRegistry
private MutableExtensionRegistry(MutableExtensionRegistry parent)
-
-
Method Detail
-
newScriptExecutionCondition
private static Extension newScriptExecutionCondition()
-
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
-
registerAutoDetectedExtensions
private static void registerAutoDetectedExtensions(MutableExtensionRegistry extensionRegistry)
-
createRegistryFrom
public static MutableExtensionRegistry createRegistryFrom(MutableExtensionRegistry parentRegistry, java.util.List<java.lang.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
public <E extends Extension> java.util.stream.Stream<E> stream(java.lang.Class<E> extensionType)
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:
ExtensionRegistry.getReversedExtensions(Class)
,ExtensionRegistry.getExtensions(Class)
-
streamLocal
private <E extends Extension> java.util.stream.Stream<E> streamLocal(java.lang.Class<E> extensionType)
Stream allExtensions
of the specified type that are present in this registry.Extensions in ancestors are ignored.
- Parameters:
extensionType
- the type ofExtension
to stream- See Also:
ExtensionRegistry.getReversedExtensions(Class)
-
isAlreadyRegistered
private boolean isAlreadyRegistered(java.lang.Class<? extends Extension> extensionType)
Determine if the supplied type is already registered in this registry or in a parent registry.
-
registerExtension
void registerExtension(java.lang.Class<? extends Extension> extensionType)
Instantiate an extension of the given type using its default constructor and register it in this registry.A new
Extension
will not be registered if an extension of the given type already exists in this registry or a parent registry.- Parameters:
extensionType
- the type of extension to register
-
registerDefaultExtension
private void registerDefaultExtension(Extension extension)
-
registerExtension
private void registerExtension(Extension extension)
-
registerExtension
public void registerExtension(Extension extension, java.lang.Object source)
Description copied from interface:ExtensionRegistrar
Register the suppliedExtension
, without checking if an extension of that type already exists.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
-
-