org.junit.jupiter.engine.descriptor

Class ClassTestDescriptor

java.lang.Object

org.junit.platform.engine.support.descriptor.AbstractTestDescriptor

org.junit.jupiter.engine.descriptor.JupiterTestDescriptor

org.junit.jupiter.engine.descriptor.ClassTestDescriptor

All Implemented Interfaces:

Node<JupiterEngineExecutionContext>, TestDescriptor

Direct Known Subclasses:

NestedClassTestDescriptor

@API(status=INTERNAL,
     since="5.0")
public class ClassTestDescriptor
extends JupiterTestDescriptor

TestDescriptor for tests based on Java classes.

Default Display Names

The default display name for a top-level or nested static test class is the fully qualified name of the class with the package name and leading dot (".") removed.

Since:

5.0

Nested Class Summary

Nested classes/interfaces inherited from interface org.junit.platform.engine.support.hierarchical.Node

Node.DynamicTestExecutor, Node.SkipResult

Nested classes/interfaces inherited from interface org.junit.platform.engine.TestDescriptor

TestDescriptor.Type, TestDescriptor.Visitor

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<java.lang.reflect.Method>	afterAllMethods
private java.util.List<java.lang.reflect.Method>	afterEachMethods
private java.util.List<java.lang.reflect.Method>	beforeAllMethods
private java.util.List<java.lang.reflect.Method>	beforeEachMethods
private static ExecutableInvoker	executableInvoker
private java.lang.Class<?>	testClass

Fields inherited from class org.junit.platform.engine.support.descriptor.AbstractTestDescriptor

children

Constructor Summary

Constructors

Modifier	Constructor and Description
	ClassTestDescriptor(UniqueId uniqueId, java.lang.Class<?> testClass)
protected	ClassTestDescriptor(UniqueId uniqueId, java.util.function.Function<java.lang.Class<?>,java.lang.String> defaultDisplayNameGenerator, java.lang.Class<?> testClass)

Method Summary

Modifier and Type	Method and Description
void	after(JupiterEngineExecutionContext context) Execute the after behavior of this node.
JupiterEngineExecutionContext	before(JupiterEngineExecutionContext context) Execute the before behavior of this node.
private static java.lang.String	generateDefaultDisplayName(java.lang.Class<?> testClass)
java.lang.String	getLegacyReportingName() Get the name of this descriptor in a format that is suitable for legacy reporting infrastructure — for example, for reporting systems built on the Ant-based XML reporting format for JUnit 4.
java.util.Set<TestTag>	getTags() Get the set of tags associated with this descriptor.
java.lang.Class<?>	getTestClass()
TestDescriptor.Type	getType() Determine the TestDescriptor.Type of this descriptor.
private java.lang.Object	instantiateAndPostProcessTestInstance(JupiterEngineExecutionContext context, ExtensionContext extensionContext, ExtensionRegistry registry)
protected java.lang.Object	instantiateTestClass(JupiterEngineExecutionContext parentExecutionContext, ExtensionRegistry registry, ExtensionContext extensionContext)
private void	invokeAfterAllCallbacks(JupiterEngineExecutionContext context)
private void	invokeAfterAllMethods(JupiterEngineExecutionContext context)
private void	invokeBeforeAllCallbacks(JupiterEngineExecutionContext context)
private void	invokeBeforeAllMethods(JupiterEngineExecutionContext context)
private void	invokeMethodInExtensionContext(java.lang.reflect.Method method, ExtensionContext context, ExtensionRegistry registry)
private void	invokeTestInstancePostProcessors(java.lang.Object instance, ExtensionRegistry registry, ExtensionContext context)
JupiterEngineExecutionContext	prepare(JupiterEngineExecutionContext context) Prepare the supplied context prior to execution.
private void	registerAfterEachMethodAdapters(ExtensionRegistry registry)
private void	registerBeforeEachMethodAdapters(ExtensionRegistry registry)
private void	registerMethodsAsExtensions(java.util.List<java.lang.reflect.Method> methods, ExtensionRegistry registry, java.util.function.Function<java.lang.reflect.Method,Extension> extensionSynthesizer)
private AfterEachMethodAdapter	synthesizeAfterEachMethodAdapter(java.lang.reflect.Method method)
private BeforeEachMethodAdapter	synthesizeBeforeEachMethodAdapter(java.lang.reflect.Method method)
private TestInstanceProvider	testInstanceProvider(JupiterEngineExecutionContext parentExecutionContext, ExtensionRegistry registry, ClassExtensionContext extensionContext, TestInstance.Lifecycle lifecycle)

Methods inherited from class org.junit.jupiter.engine.descriptor.JupiterTestDescriptor

determineDisplayName, executeAndMaskThrowable, getTags, populateNewExtensionRegistryFromExtendWith, shouldBeSkipped

Methods inherited from class org.junit.platform.engine.support.descriptor.AbstractTestDescriptor

addChild, equals, findByUniqueId, getChildren, getDisplayName, getParent, getSource, getUniqueId, hashCode, removeChild, removeFromHierarchy, setParent, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.junit.platform.engine.support.hierarchical.Node

execute

Methods inherited from interface org.junit.platform.engine.TestDescriptor

accept, containsTests, getDescendants, isContainer, isRoot, isTest, mayRegisterTests, prune

Field Detail

executableInvoker

private static final ExecutableInvoker executableInvoker

testClass

private final java.lang.Class<?> testClass

beforeAllMethods

private java.util.List<java.lang.reflect.Method> beforeAllMethods

afterAllMethods

private java.util.List<java.lang.reflect.Method> afterAllMethods

beforeEachMethods

private java.util.List<java.lang.reflect.Method> beforeEachMethods

afterEachMethods

private java.util.List<java.lang.reflect.Method> afterEachMethods

Constructor Detail

ClassTestDescriptor

public ClassTestDescriptor(UniqueId uniqueId,
                           java.lang.Class<?> testClass)

ClassTestDescriptor

protected ClassTestDescriptor(UniqueId uniqueId,
                              java.util.function.Function<java.lang.Class<?>,java.lang.String> defaultDisplayNameGenerator,
                              java.lang.Class<?> testClass)

Method Detail

getTags

public java.util.Set<TestTag> getTags()

Description copied from interface: TestDescriptor

Get the set of tags associated with this descriptor.

Specified by:

getTags in interface TestDescriptor

Overrides:

getTags in class AbstractTestDescriptor

Returns:

the set of tags associated with this descriptor; never null but potentially empty

See Also:

TestTag

getTestClass

public final java.lang.Class<?> getTestClass()

getType

public TestDescriptor.Type getType()

Description copied from interface: TestDescriptor

Determine the TestDescriptor.Type of this descriptor.

Returns:

the descriptor type; never null.

See Also:

TestDescriptor.isContainer(), TestDescriptor.isTest()

getLegacyReportingName

public java.lang.String getLegacyReportingName()

Description copied from interface: TestDescriptor

Get the name of this descriptor in a format that is suitable for legacy reporting infrastructure — for example, for reporting systems built on the Ant-based XML reporting format for JUnit 4.

The default implementation simply delegates to TestDescriptor.getDisplayName().

Returns:

the legacy reporting name; never null or blank

generateDefaultDisplayName

private static java.lang.String generateDefaultDisplayName(java.lang.Class<?> testClass)

prepare

public JupiterEngineExecutionContext prepare(JupiterEngineExecutionContext context)

Description copied from interface: Node

Prepare the supplied context prior to execution.

The default implementation returns the supplied context unmodified.

before

public JupiterEngineExecutionContext before(JupiterEngineExecutionContext context)
                                     throws java.lang.Exception

Description copied from interface: Node

Execute the before behavior of this node.

This method will be called once before execution of this node.

Parameters:

context - the context to execute in

Returns:

the new context to be used for children of this node

Throws:

java.lang.Exception

See Also:

Node.execute(C, org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor), Node.after(C)

after

public void after(JupiterEngineExecutionContext context)
           throws java.lang.Exception

Description copied from interface: Node

Execute the after behavior of this node.

This method will be called once after execution of this node.

Parameters:

context - the context to execute in

Throws:

java.lang.Exception

See Also:

Node.before(C), Node.execute(C, org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor)

testInstanceProvider

private TestInstanceProvider testInstanceProvider(JupiterEngineExecutionContext parentExecutionContext,
                                                  ExtensionRegistry registry,
                                                  ClassExtensionContext extensionContext,
                                                  TestInstance.Lifecycle lifecycle)

instantiateAndPostProcessTestInstance

private java.lang.Object instantiateAndPostProcessTestInstance(JupiterEngineExecutionContext context,
                                                               ExtensionContext extensionContext,
                                                               ExtensionRegistry registry)

instantiateTestClass

protected java.lang.Object instantiateTestClass(JupiterEngineExecutionContext parentExecutionContext,
                                                ExtensionRegistry registry,
                                                ExtensionContext extensionContext)

invokeTestInstancePostProcessors

private void invokeTestInstancePostProcessors(java.lang.Object instance,
                                              ExtensionRegistry registry,
                                              ExtensionContext context)

invokeBeforeAllCallbacks

private void invokeBeforeAllCallbacks(JupiterEngineExecutionContext context)

invokeBeforeAllMethods

private void invokeBeforeAllMethods(JupiterEngineExecutionContext context)

invokeAfterAllMethods

private void invokeAfterAllMethods(JupiterEngineExecutionContext context)

invokeAfterAllCallbacks

private void invokeAfterAllCallbacks(JupiterEngineExecutionContext context)

registerBeforeEachMethodAdapters

private void registerBeforeEachMethodAdapters(ExtensionRegistry registry)

registerAfterEachMethodAdapters

private void registerAfterEachMethodAdapters(ExtensionRegistry registry)

registerMethodsAsExtensions

private void registerMethodsAsExtensions(java.util.List<java.lang.reflect.Method> methods,
                                         ExtensionRegistry registry,
                                         java.util.function.Function<java.lang.reflect.Method,Extension> extensionSynthesizer)

synthesizeBeforeEachMethodAdapter

private BeforeEachMethodAdapter synthesizeBeforeEachMethodAdapter(java.lang.reflect.Method method)

synthesizeAfterEachMethodAdapter

private AfterEachMethodAdapter synthesizeAfterEachMethodAdapter(java.lang.reflect.Method method)

invokeMethodInExtensionContext

private void invokeMethodInExtensionContext(java.lang.reflect.Method method,
                                            ExtensionContext context,
                                            ExtensionRegistry registry)