org.junit.jupiter.engine.descriptor

Class AbstractExtensionContext<T extends TestDescriptor>

java.lang.Object

org.junit.jupiter.engine.descriptor.AbstractExtensionContext<T>

All Implemented Interfaces:

ExtensionContext

Direct Known Subclasses:

ClassExtensionContext, JupiterEngineExtensionContext, MethodExtensionContext, TestTemplateExtensionContext

abstract class AbstractExtensionContext<T extends TestDescriptor>
extends java.lang.Object
implements ExtensionContext

Since:

5.0

Nested Class Summary

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

ExtensionContext.Namespace, ExtensionContext.Store

Field Summary

Fields

Modifier and Type	Field and Description
private EngineExecutionListener	engineExecutionListener
private ExtensionContext	parent
private T	testDescriptor
private ExtensionValuesStore	valuesStore

Constructor Summary

Constructors

Constructor and Description
AbstractExtensionContext(ExtensionContext parent, EngineExecutionListener engineExecutionListener, T testDescriptor)

Method Summary

Modifier and Type	Method and Description
private ExtensionValuesStore	createStore(ExtensionContext parent)
java.lang.String	getDisplayName() Get the display name for the current test or container.
java.util.Optional<ExtensionContext>	getParent() Get the parent extension context, if available.
ExtensionContext	getRoot() Get the root ExtensionContext.
ExtensionContext.Store	getStore(ExtensionContext.Namespace namespace) Get the ExtensionContext.Store for the supplied ExtensionContext.Namespace.
java.util.Set<java.lang.String>	getTags() Get the set of all tags for the current test or container.
protected T	getTestDescriptor()
java.lang.String	getUniqueId() Get the unique ID of the current test or container.
void	publishReportEntry(java.util.Map<java.lang.String,java.lang.String> values) Publish a map of key-value pairs to be consumed by an org.junit.platform.engine.EngineExecutionListener.

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.api.extension.ExtensionContext

getElement, getExecutionException, getRequiredTestClass, getRequiredTestInstance, getRequiredTestMethod, getTestClass, getTestInstance, getTestMethod, publishReportEntry

Field Detail

parent

private final ExtensionContext parent

engineExecutionListener

private final EngineExecutionListener engineExecutionListener

testDescriptor

private final T extends TestDescriptor testDescriptor

valuesStore

private final ExtensionValuesStore valuesStore

Constructor Detail

AbstractExtensionContext

AbstractExtensionContext(ExtensionContext parent,
                         EngineExecutionListener engineExecutionListener,
                         T testDescriptor)

Method Detail

createStore

private ExtensionValuesStore createStore(ExtensionContext parent)

getUniqueId

public java.lang.String getUniqueId()

Description copied from interface: ExtensionContext

Get the unique ID of the current test or container.

Specified by:

getUniqueId in interface ExtensionContext

Returns:

the unique ID of the test or container; never null or blank

getDisplayName

public java.lang.String getDisplayName()

Description copied from interface: ExtensionContext

Get the display name for the current test or container.

The display name is either a default name or a custom name configured via @DisplayName.

For details on default display names consult the Javadoc for TestInfo.getDisplayName().

Note that display names are typically used for test reporting in IDEs and build tools and may contain spaces, special characters, and even emoji.

Specified by:

getDisplayName in interface ExtensionContext

Returns:

the display name of the test or container; never null or blank

publishReportEntry

public void publishReportEntry(java.util.Map<java.lang.String,java.lang.String> values)

Description copied from interface: ExtensionContext

Publish a map of key-value pairs to be consumed by an org.junit.platform.engine.EngineExecutionListener.

Specified by:

publishReportEntry in interface ExtensionContext

Parameters:

values - the key-value pairs to be published; never null; keys and values within entries in the map also must not be null or blank

getParent

public java.util.Optional<ExtensionContext> getParent()

Description copied from interface: ExtensionContext

Get the parent extension context, if available.

Specified by:

getParent in interface ExtensionContext

Returns:

an Optional containing the parent; never null but potentially empty

See Also:

ExtensionContext.getRoot()

getRoot

public ExtensionContext getRoot()

Description copied from interface: ExtensionContext

Get the root ExtensionContext.

Specified by:

getRoot in interface ExtensionContext

Returns:

the root extension context; never null but potentially this ExtensionContext

See Also:

ExtensionContext.getParent()

getTestDescriptor

protected T getTestDescriptor()

getStore

public ExtensionContext.Store getStore(ExtensionContext.Namespace namespace)

Description copied from interface: ExtensionContext

Get the ExtensionContext.Store for the supplied ExtensionContext.Namespace.

Use getStore(Namespace.GLOBAL) to get the default, global ExtensionContext.Namespace.

Specified by:

getStore in interface ExtensionContext

Parameters:

namespace - the Namespace to get the store for; never null

Returns:

the store in which to put and get objects for other invocations working in the same namespace; never null

See Also:

ExtensionContext.Namespace.GLOBAL

getTags

public java.util.Set<java.lang.String> getTags()

Description copied from interface: ExtensionContext

Get the set of all tags for the current test or container.

Tags may be declared directly on the test element or inherited from an outer context.

Specified by:

getTags in interface ExtensionContext

Returns:

the set of tags for the test or container; never null but potentially empty