Package org.junit.jupiter.engine.descriptor

Class TestMethodTestDescriptor

java.lang.Object

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

org.junit.jupiter.engine.descriptor.JupiterTestDescriptor

org.junit.jupiter.engine.descriptor.MethodBasedTestDescriptor

org.junit.jupiter.engine.descriptor.TestMethodTestDescriptor

All Implemented Interfaces:

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

Direct Known Subclasses:

TestFactoryTestDescriptor, TestTemplateInvocationTestDescriptor

@API(status=INTERNAL,
     since="5.0")
public class TestMethodTestDescriptor
extends MethodBasedTestDescriptor

TestDescriptor for @Test methods.

Default Display Names

The default display name for a test method is the name of the method concatenated with a comma-separated list of parameter types in parentheses. The names of parameter types are retrieved using Class.getSimpleName(). For example, the default display name for the following test method is testUser(TestInfo, User).

   @Test
   void testUser(TestInfo testInfo, @Mock User user) { ... }
 

Since:

5.0

Nested Class Summary

Nested classes/interfaces inherited from class org.junit.jupiter.engine.descriptor.JupiterTestDescriptor

JupiterTestDescriptor.ExceptionHandlerInvoker<E extends org.junit.jupiter.api.extension.Extension>

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 extends org.junit.platform.engine.support.hierarchical.EngineExecutionContext>, 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
private static InterceptingExecutableInvoker.ReflectiveInterceptorCall<java.lang.reflect.Method,java.lang.Void>	defaultInterceptorCall
private static InterceptingExecutableInvoker	executableInvoker
private InterceptingExecutableInvoker.ReflectiveInterceptorCall<java.lang.reflect.Method,java.lang.Void>	interceptorCall
static java.lang.String	SEGMENT_TYPE

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

configuration

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

children

Constructor Summary

Constructors

Constructor	Description
TestMethodTestDescriptor(org.junit.platform.engine.UniqueId uniqueId, java.lang.Class<?> testClass, java.lang.reflect.Method testMethod, java.util.function.Supplier<java.util.List<java.lang.Class<?>>> enclosingInstanceTypes, JupiterConfiguration configuration)
TestMethodTestDescriptor(org.junit.platform.engine.UniqueId uniqueId, java.lang.String displayName, java.lang.Class<?> testClass, java.lang.reflect.Method testMethod, JupiterConfiguration configuration)
TestMethodTestDescriptor(org.junit.platform.engine.UniqueId uniqueId, java.lang.String displayName, java.lang.Class<?> testClass, java.lang.reflect.Method testMethod, JupiterConfiguration configuration, InterceptingExecutableInvoker.ReflectiveInterceptorCall<java.lang.reflect.Method,java.lang.Void> interceptorCall)

Method Summary

Modifier and Type	Method	Description
void	cleanUp(JupiterEngineExecutionContext context)
JupiterEngineExecutionContext	execute(JupiterEngineExecutionContext context, org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor dynamicTestExecutor)
org.junit.platform.engine.TestDescriptor.Type	getType()
private void	invokeAfterEachCallbacks(JupiterEngineExecutionContext context)
private void	invokeAfterEachExecutionExceptionHandlers(org.junit.jupiter.api.extension.ExtensionContext context, ExtensionRegistry registry, java.lang.Throwable throwable)
private void	invokeAfterEachMethods(JupiterEngineExecutionContext context)
private void	invokeAfterTestExecutionCallbacks(JupiterEngineExecutionContext context)
private void	invokeBeforeEachCallbacks(JupiterEngineExecutionContext context)
private void	invokeBeforeEachExecutionExceptionHandlers(org.junit.jupiter.api.extension.ExtensionContext context, ExtensionRegistry registry, java.lang.Throwable throwable)
private void	invokeBeforeEachMethods(JupiterEngineExecutionContext context)
private void	invokeBeforeTestExecutionCallbacks(JupiterEngineExecutionContext context)
private void	invokeTestExecutionExceptionHandlers(ExtensionRegistry registry, org.junit.jupiter.api.extension.ExtensionContext context, java.lang.Throwable throwable)
private void	invokeTestInstancePreDestroyCallbacks(JupiterEngineExecutionContext context)
protected void	invokeTestMethod(JupiterEngineExecutionContext context, org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor dynamicTestExecutor)
private boolean	isPerMethodLifecycle(JupiterEngineExecutionContext context)
void	nodeFinished(JupiterEngineExecutionContext context, org.junit.platform.engine.TestDescriptor descriptor, org.junit.platform.engine.TestExecutionResult result)	Invoke testSuccessful(), testAborted(), or testFailed() on each registered TestWatcher according to the status of the supplied TestExecutionResult, in reverse registration order.
protected MutableExtensionRegistry	populateNewExtensionRegistry(JupiterEngineExecutionContext context)
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.
protected void	prepareExtensionContext(org.junit.jupiter.api.extension.ExtensionContext extensionContext)
protected TestMethodTestDescriptor	withUniqueId(java.util.function.UnaryOperator<org.junit.platform.engine.UniqueId> uniqueIdTransformer)	{@return shallow copy (without children) of this descriptor with the supplied unique ID}

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

getEnclosingTestClasses, getExclusiveResourceCollector, getExplicitExecutionMode, getLegacyReportingBaseName, getResourceLocksProviderEvaluator, getTags, getTestClass, getTestMethod, invokeTestWatchers, nodeSkipped, validate

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

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

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

addChild, equals, findByUniqueId, getChildren, getDisplayName, getParent, getSource, getUniqueId, hashCode, orderChildren, 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

after, around, before

Methods inherited from interface org.junit.jupiter.engine.descriptor.ResourceLockAware

determineExclusiveResources, determineOwnExclusiveResources

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

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

Field Detail

SEGMENT_TYPE

public static final java.lang.String SEGMENT_TYPE

See Also:

Constant Field Values

executableInvoker

private static final InterceptingExecutableInvoker executableInvoker

defaultInterceptorCall

private static final InterceptingExecutableInvoker.ReflectiveInterceptorCall<java.lang.reflect.Method,java.lang.Void> defaultInterceptorCall

interceptorCall

private final InterceptingExecutableInvoker.ReflectiveInterceptorCall<java.lang.reflect.Method,java.lang.Void> interceptorCall

Constructor Detail

TestMethodTestDescriptor

public TestMethodTestDescriptor(org.junit.platform.engine.UniqueId uniqueId,
                                java.lang.Class<?> testClass,
                                java.lang.reflect.Method testMethod,
                                java.util.function.Supplier<java.util.List<java.lang.Class<?>>> enclosingInstanceTypes,
                                JupiterConfiguration configuration)

TestMethodTestDescriptor

TestMethodTestDescriptor(org.junit.platform.engine.UniqueId uniqueId,
                         java.lang.String displayName,
                         java.lang.Class<?> testClass,
                         java.lang.reflect.Method testMethod,
                         JupiterConfiguration configuration)

TestMethodTestDescriptor

TestMethodTestDescriptor(org.junit.platform.engine.UniqueId uniqueId,
                         java.lang.String displayName,
                         java.lang.Class<?> testClass,
                         java.lang.reflect.Method testMethod,
                         JupiterConfiguration configuration,
                         InterceptingExecutableInvoker.ReflectiveInterceptorCall<java.lang.reflect.Method,java.lang.Void> interceptorCall)

Method Detail

withUniqueId

protected TestMethodTestDescriptor withUniqueId(java.util.function.UnaryOperator<org.junit.platform.engine.UniqueId> uniqueIdTransformer)

Description copied from class: JupiterTestDescriptor

{@return shallow copy (without children) of this descriptor with the supplied unique ID}

Specified by:

withUniqueId in class JupiterTestDescriptor

getType

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

prepare

public 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

prepareExtensionContext

protected void prepareExtensionContext(org.junit.jupiter.api.extension.ExtensionContext extensionContext)

populateNewExtensionRegistry

protected MutableExtensionRegistry populateNewExtensionRegistry(JupiterEngineExecutionContext context)

execute

public JupiterEngineExecutionContext execute(JupiterEngineExecutionContext context,
                                             org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor dynamicTestExecutor)

cleanUp

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

Specified by:

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

Overrides:

cleanUp in class JupiterTestDescriptor

Throws:

java.lang.Exception

isPerMethodLifecycle

private boolean isPerMethodLifecycle(JupiterEngineExecutionContext context)

invokeBeforeEachCallbacks

private void invokeBeforeEachCallbacks(JupiterEngineExecutionContext context)

invokeBeforeEachMethods

private void invokeBeforeEachMethods(JupiterEngineExecutionContext context)

invokeBeforeEachExecutionExceptionHandlers

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

invokeBeforeTestExecutionCallbacks

private void invokeBeforeTestExecutionCallbacks(JupiterEngineExecutionContext context)

invokeTestMethod

protected void invokeTestMethod(JupiterEngineExecutionContext context,
                                org.junit.platform.engine.support.hierarchical.Node.DynamicTestExecutor dynamicTestExecutor)

invokeTestExecutionExceptionHandlers

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

invokeAfterTestExecutionCallbacks

private void invokeAfterTestExecutionCallbacks(JupiterEngineExecutionContext context)

invokeAfterEachMethods

private void invokeAfterEachMethods(JupiterEngineExecutionContext context)

invokeAfterEachExecutionExceptionHandlers

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

invokeAfterEachCallbacks

private void invokeAfterEachCallbacks(JupiterEngineExecutionContext context)

invokeTestInstancePreDestroyCallbacks

private void invokeTestInstancePreDestroyCallbacks(JupiterEngineExecutionContext context)

nodeFinished

public void nodeFinished(JupiterEngineExecutionContext context,
                         org.junit.platform.engine.TestDescriptor descriptor,
                         org.junit.platform.engine.TestExecutionResult result)

Invoke testSuccessful(), testAborted(), or testFailed() on each registered TestWatcher according to the status of the supplied TestExecutionResult, in reverse registration order.

Since:

5.4