Class ClassBasedTestDescriptor

java.lang.Object

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

org.junit.jupiter.engine.descriptor.JupiterTestDescriptor

org.junit.jupiter.engine.descriptor.ClassBasedTestDescriptor

All Implemented Interfaces:

ResourceLockAware, TestClassAware, Validatable, org.junit.platform.engine.support.hierarchical.Node<JupiterEngineExecutionContext>, org.junit.platform.engine.TestDescriptor

Direct Known Subclasses:

ClassTemplateTestDescriptor, ClassTestDescriptor, NestedClassTestDescriptor

@API(status=INTERNAL,
     since="5.5")
public abstract class ClassBasedTestDescriptor
extends JupiterTestDescriptor
implements ResourceLockAware, TestClassAware, Validatable

TestDescriptor for tests based on Java classes.

Since:

5.5

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	ClassBasedTestDescriptor.ClassInfo
private static class	ClassBasedTestDescriptor.LifecycleMethods

Nested classes/interfaces inherited from class JupiterTestDescriptor

JupiterTestDescriptor.ExceptionHandlerInvoker<E>

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

org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor, org.junit.platform.engine.support.hierarchical.Node.ExecutionMode, org.junit.platform.engine.support.hierarchical.Node.Invocation<C>, org.junit.platform.engine.support.hierarchical.Node.SkipResult

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

org.junit.platform.engine.TestDescriptor.Type, org.junit.platform.engine.TestDescriptor.Visitor

Field Summary

Fields

Modifier and Type	Field	Description
protected final ClassBasedTestDescriptor.ClassInfo	classInfo
private static final InterceptingExecutableInvoker	executableInvoker
private ClassBasedTestDescriptor.LifecycleMethods	lifecycleMethods
private org.junit.jupiter.api.extension.TestInstanceFactory	testInstanceFactory

Fields inherited from class JupiterTestDescriptor

configuration

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

children

Constructor Summary

Constructors

Constructor	Description
ClassBasedTestDescriptor(org.junit.platform.engine.UniqueId uniqueId, Class<?> testClass, String displayName, JupiterConfiguration configuration)
ClassBasedTestDescriptor(org.junit.platform.engine.UniqueId uniqueId, Class<?> testClass, Supplier<String> displayNameSupplier, JupiterConfiguration configuration)

Method Summary

Modifier and Type	Method	Description
final void	after(JupiterEngineExecutionContext context)
final JupiterEngineExecutionContext	before(JupiterEngineExecutionContext context)
void	cleanUp(JupiterEngineExecutionContext context)
private void	executeAndMaskThrowable(org.junit.jupiter.api.function.Executable executable)
protected final Optional<org.junit.platform.engine.support.hierarchical.Node.ExecutionMode>	getDefaultChildExecutionMode()
final ExclusiveResourceCollector	getExclusiveResourceCollector()
protected final Optional<org.junit.platform.engine.support.hierarchical.Node.ExecutionMode>	getExplicitExecutionMode()
protected final String	getLegacyReportingBaseName()
final Class<?>	getTestClass()
final org.junit.platform.engine.TestDescriptor.Type	getType()
private org.junit.jupiter.api.extension.TestInstances	instantiateAndPostProcessTestInstance(JupiterEngineExecutionContext parentExecutionContext, ClassExtensionContext ourExtensionContext, ExtensionRegistry registry, JupiterEngineExecutionContext context)
protected final org.junit.jupiter.api.extension.TestInstances	instantiateTestClass(Optional<org.junit.jupiter.api.extension.TestInstances> outerInstances, ExtensionRegistry registry, ExtensionContextSupplier extensionContext)
protected abstract org.junit.jupiter.api.extension.TestInstances	instantiateTestClass(JupiterEngineExecutionContext parentExecutionContext, ExtensionContextSupplier extensionContext, ExtensionRegistry registry, JupiterEngineExecutionContext context)
private void	invokeAfterAllCallbacks(JupiterEngineExecutionContext context)
private void	invokeAfterAllMethodExecutionExceptionHandlers(ExtensionRegistry registry, org.junit.jupiter.api.extension.ExtensionContext context, Throwable throwable)
private void	invokeAfterAllMethods(JupiterEngineExecutionContext context)
private void	invokeBeforeAllCallbacks(JupiterEngineExecutionContext context)
private void	invokeBeforeAllMethodExecutionExceptionHandlers(ExtensionRegistry registry, org.junit.jupiter.api.extension.ExtensionContext context, Throwable throwable)
private void	invokeBeforeAllMethods(JupiterEngineExecutionContext context)
private void	invokeMethodInExtensionContext(Method method, org.junit.jupiter.api.extension.ExtensionContext context, ExtensionRegistry registry, InterceptingExecutableInvoker.ReflectiveInterceptorCall.VoidMethodInterceptorCall interceptorCall)
private Object	invokeTestClassConstructor(Optional<Object> outerInstance, ExtensionRegistry registry, ExtensionContextSupplier extensionContext)
private Object	invokeTestInstanceFactory(Optional<Object> outerInstance, ExtensionContextSupplier extensionContext)
private void	invokeTestInstancePostProcessors(Object instance, ExtensionRegistry registry, ExtensionContextSupplier context)
private void	invokeTestInstancePreConstructCallbacks(org.junit.jupiter.api.extension.TestInstanceFactoryContext factoryContext, ExtensionRegistry registry, ExtensionContextSupplier context)
private void	invokeTestInstancePreDestroyCallbacks(JupiterEngineExecutionContext context)
private boolean	isPerClassLifecycle(JupiterEngineExecutionContext context)
final JupiterEngineExecutionContext	prepare(JupiterEngineExecutionContext context)	Must be overridden and return a new context with a new ExtensionContext so cleanUp() does not accidentally close the parent context.
private void	registerAfterEachMethodAdapters(ExtensionRegistrar registrar)
private void	registerBeforeEachMethodAdapters(ExtensionRegistrar registrar)
private void	registerMethodsAsExtensions(List<Method> methods, ExtensionRegistrar registrar, Function<Method, org.junit.jupiter.api.extension.Extension> extensionSynthesizer)
private org.junit.jupiter.api.extension.TestInstanceFactory	resolveTestInstanceFactory(ExtensionRegistry registry)
final void	setDefaultChildExecutionMode(org.junit.platform.engine.support.hierarchical.Node.ExecutionMode defaultChildExecutionMode)
private AfterEachMethodAdapter	synthesizeAfterEachMethodAdapter(Method method)
private BeforeEachMethodAdapter	synthesizeBeforeEachMethodAdapter(Method method)
private TestInstancesProvider	testInstancesProvider(JupiterEngineExecutionContext parentExecutionContext, ClassExtensionContext ourExtensionContext)
final void	validate(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)	Validate the state of this descriptor and report any issues found to the supplied DiscoveryIssueReporter.
protected void	validateClassTemplateInvocationLifecycleMethods(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)
protected void	validateCoreLifecycleMethods(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)
private void	validateDisplayNameAnnotation(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)
private void	validateTags(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)

Methods inherited from class JupiterTestDescriptor

copyIncludingDescendants, getExclusiveResources, getExecutionMode, getExecutionModeFromAnnotation, getLegacyReportingIndex, getLegacyReportingName, getTags, invokeExecutionExceptionHandlers, shouldBeSkipped, toExecutionMode, withUniqueId

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

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

Methods inherited from class Object

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

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

around, execute, nodeFinished, nodeSkipped

Methods inherited from interface ResourceLockAware

determineExclusiveResources, determineOwnExclusiveResources, getResourceLocksProviderEvaluator

Methods inherited from interface TestClassAware

getEnclosingTestClasses

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

accept, addChild, findByUniqueId, getAncestors, getChildren, getDescendants, getDisplayName, getLegacyReportingName, getParent, getSource, getTags, getUniqueId, isContainer, isRoot, isTest, mayRegisterTests, orderChildren, prune, removeChild, removeFromHierarchy, setParent

Field Details

executableInvoker

private static final InterceptingExecutableInvoker executableInvoker

classInfo

protected final ClassBasedTestDescriptor.ClassInfo classInfo

lifecycleMethods

private ClassBasedTestDescriptor.LifecycleMethods lifecycleMethods

testInstanceFactory

private org.junit.jupiter.api.extension.TestInstanceFactory testInstanceFactory

Constructor Details

ClassBasedTestDescriptor

ClassBasedTestDescriptor(org.junit.platform.engine.UniqueId uniqueId,
 Class<?> testClass,
 Supplier<String> displayNameSupplier,
 JupiterConfiguration configuration)

ClassBasedTestDescriptor

ClassBasedTestDescriptor(org.junit.platform.engine.UniqueId uniqueId,
 Class<?> testClass,
 String displayName,
 JupiterConfiguration configuration)

Method Details

getTestClass

public final Class<?> getTestClass()

Specified by:

getTestClass in interface TestClassAware

getType

public final org.junit.platform.engine.TestDescriptor.Type getType()

Specified by:

getType in interface org.junit.platform.engine.TestDescriptor

getLegacyReportingBaseName

protected final String getLegacyReportingBaseName()

Overrides:

getLegacyReportingBaseName in class JupiterTestDescriptor

validate

public final void validate(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)

Description copied from interface: Validatable

Validate the state of this descriptor and report any issues found to the supplied DiscoveryIssueReporter.

Specified by:

validate in interface Validatable

validateDisplayNameAnnotation

private void validateDisplayNameAnnotation(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)

validateCoreLifecycleMethods

protected void validateCoreLifecycleMethods(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)

validateClassTemplateInvocationLifecycleMethods

protected void validateClassTemplateInvocationLifecycleMethods(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)

validateTags

private void validateTags(org.junit.platform.engine.support.discovery.DiscoveryIssueReporter reporter)

getExplicitExecutionMode

protected final Optional<org.junit.platform.engine.support.hierarchical.Node.ExecutionMode> getExplicitExecutionMode()

Overrides:

getExplicitExecutionMode in class JupiterTestDescriptor

getDefaultChildExecutionMode

protected final Optional<org.junit.platform.engine.support.hierarchical.Node.ExecutionMode> getDefaultChildExecutionMode()

Overrides:

getDefaultChildExecutionMode in class JupiterTestDescriptor

setDefaultChildExecutionMode

public final void setDefaultChildExecutionMode(org.junit.platform.engine.support.hierarchical.Node.ExecutionMode defaultChildExecutionMode)

getExclusiveResourceCollector

public final ExclusiveResourceCollector getExclusiveResourceCollector()

Specified by:

getExclusiveResourceCollector in interface ResourceLockAware

prepare

public final JupiterEngineExecutionContext prepare(JupiterEngineExecutionContext context)

Description copied from class: JupiterTestDescriptor

Must be overridden and return a new context with a new ExtensionContext so cleanUp() does not accidentally close the parent context.

Specified by:

prepare in interface org.junit.platform.engine.support.hierarchical.Node<JupiterEngineExecutionContext>

Specified by:

prepare in class JupiterTestDescriptor

before

public final JupiterEngineExecutionContext before(JupiterEngineExecutionContext context)

Specified by:

before in interface org.junit.platform.engine.support.hierarchical.Node<JupiterEngineExecutionContext>

after

public final void after(JupiterEngineExecutionContext context)

Specified by:

after in interface org.junit.platform.engine.support.hierarchical.Node<JupiterEngineExecutionContext>

cleanUp

public void cleanUp(JupiterEngineExecutionContext context)
             throws Exception

Specified by:

cleanUp in interface org.junit.platform.engine.support.hierarchical.Node<JupiterEngineExecutionContext>

Overrides:

cleanUp in class JupiterTestDescriptor

Throws:

Exception

resolveTestInstanceFactory

private org.junit.jupiter.api.extension.TestInstanceFactory resolveTestInstanceFactory(ExtensionRegistry registry)

testInstancesProvider

private TestInstancesProvider testInstancesProvider(JupiterEngineExecutionContext parentExecutionContext,
 ClassExtensionContext ourExtensionContext)

instantiateAndPostProcessTestInstance

private org.junit.jupiter.api.extension.TestInstances instantiateAndPostProcessTestInstance(JupiterEngineExecutionContext parentExecutionContext,
 ClassExtensionContext ourExtensionContext,
 ExtensionRegistry registry,
 JupiterEngineExecutionContext context)

instantiateTestClass

protected abstract org.junit.jupiter.api.extension.TestInstances instantiateTestClass(JupiterEngineExecutionContext parentExecutionContext,
 ExtensionContextSupplier extensionContext,
 ExtensionRegistry registry,
 JupiterEngineExecutionContext context)

instantiateTestClass

protected final org.junit.jupiter.api.extension.TestInstances instantiateTestClass(Optional<org.junit.jupiter.api.extension.TestInstances> outerInstances,
 ExtensionRegistry registry,
 ExtensionContextSupplier extensionContext)

invokeTestInstanceFactory

private Object invokeTestInstanceFactory(Optional<Object> outerInstance,
 ExtensionContextSupplier extensionContext)

invokeTestClassConstructor

private Object invokeTestClassConstructor(Optional<Object> outerInstance,
 ExtensionRegistry registry,
 ExtensionContextSupplier extensionContext)

invokeTestInstancePreConstructCallbacks

private void invokeTestInstancePreConstructCallbacks(org.junit.jupiter.api.extension.TestInstanceFactoryContext factoryContext,
 ExtensionRegistry registry,
 ExtensionContextSupplier context)

invokeTestInstancePostProcessors

private void invokeTestInstancePostProcessors(Object instance,
 ExtensionRegistry registry,
 ExtensionContextSupplier context)

executeAndMaskThrowable

private void executeAndMaskThrowable(org.junit.jupiter.api.function.Executable executable)

invokeBeforeAllCallbacks

private void invokeBeforeAllCallbacks(JupiterEngineExecutionContext context)

invokeBeforeAllMethods

private void invokeBeforeAllMethods(JupiterEngineExecutionContext context)

invokeBeforeAllMethodExecutionExceptionHandlers

private void invokeBeforeAllMethodExecutionExceptionHandlers(ExtensionRegistry registry,
 org.junit.jupiter.api.extension.ExtensionContext context,
 Throwable throwable)

invokeAfterAllMethods

private void invokeAfterAllMethods(JupiterEngineExecutionContext context)

invokeAfterAllMethodExecutionExceptionHandlers

private void invokeAfterAllMethodExecutionExceptionHandlers(ExtensionRegistry registry,
 org.junit.jupiter.api.extension.ExtensionContext context,
 Throwable throwable)

invokeAfterAllCallbacks

private void invokeAfterAllCallbacks(JupiterEngineExecutionContext context)

invokeTestInstancePreDestroyCallbacks

private void invokeTestInstancePreDestroyCallbacks(JupiterEngineExecutionContext context)

isPerClassLifecycle

private boolean isPerClassLifecycle(JupiterEngineExecutionContext context)

registerBeforeEachMethodAdapters

private void registerBeforeEachMethodAdapters(ExtensionRegistrar registrar)

registerAfterEachMethodAdapters

private void registerAfterEachMethodAdapters(ExtensionRegistrar registrar)

registerMethodsAsExtensions

private void registerMethodsAsExtensions(List<Method> methods,
 ExtensionRegistrar registrar,
 Function<Method, org.junit.jupiter.api.extension.Extension> extensionSynthesizer)

synthesizeBeforeEachMethodAdapter

private BeforeEachMethodAdapter synthesizeBeforeEachMethodAdapter(Method method)

synthesizeAfterEachMethodAdapter

private AfterEachMethodAdapter synthesizeAfterEachMethodAdapter(Method method)

invokeMethodInExtensionContext

private void invokeMethodInExtensionContext(Method method,
 org.junit.jupiter.api.extension.ExtensionContext context,
 ExtensionRegistry registry,
 InterceptingExecutableInvoker.ReflectiveInterceptorCall.VoidMethodInterceptorCall interceptorCall)