Package org.junit.jupiter.engine.descriptor

Class JupiterTestDescriptor

java.lang.Object

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

org.junit.jupiter.engine.descriptor.JupiterTestDescriptor

All Implemented Interfaces:

Node<JupiterEngineExecutionContext>, TestDescriptor

Direct Known Subclasses:

ClassTestDescriptor, MethodBasedTestDescriptor

@API(status=INTERNAL,
     since="5.0")
public abstract class JupiterTestDescriptor
extends AbstractTestDescriptor
implements Node<JupiterEngineExecutionContext>

Since:

5.0

Nested Class Summary

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

Node.DynamicTestExecutor, Node.ExecutionMode, Node.Invocation<C extends EngineExecutionContext>, Node.SkipResult

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

TestDescriptor.Type, TestDescriptor.Visitor

Field Summary

Fields

Modifier and Type	Field	Description
protected JupiterConfiguration	configuration

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

children

Method Summary

Modifier and Type	Method	Description
void	cleanUp(JupiterEngineExecutionContext context)	Clean up the supplied context after execution.
protected void	executeAndMaskThrowable(Executable executable)	Execute the supplied Executable and mask any exception thrown as an unchecked exception.
protected Optional<Node.ExecutionMode>	getDefaultChildExecutionMode()
protected Set<ExclusiveResource>	getExclusiveResourcesFromAnnotation(AnnotatedElement element)
Node.ExecutionMode	getExecutionMode()	Get the preferred of execution mode for parallel execution of this node.
protected Optional<Node.ExecutionMode>	getExecutionModeFromAnnotation(AnnotatedElement element)
protected Optional<Node.ExecutionMode>	getExplicitExecutionMode()
protected static Set<TestTag>	getTags(AnnotatedElement element)
abstract JupiterEngineExecutionContext	prepare(JupiterEngineExecutionContext context)	Must be overridden and return a new context so cleanUp() does not accidentally close the parent context.
Node.SkipResult	shouldBeSkipped(JupiterEngineExecutionContext context)	Determine if the execution of the supplied context should be skipped.
static Node.ExecutionMode	toExecutionMode(ExecutionMode mode)

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

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

after, around, before, execute, getExclusiveResources, nodeFinished, nodeSkipped

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

accept, getDescendants, getLegacyReportingName, getType, isContainer, isRoot, isTest, mayRegisterTests, prune

Field Detail

configuration

protected final JupiterConfiguration configuration

Method Detail

getTags

protected static Set<TestTag> getTags(AnnotatedElement element)

getExecutionMode

public final Node.ExecutionMode getExecutionMode()

Description copied from interface: Node

Get the preferred of execution mode for parallel execution of this node.

The default implementation returns Node.ExecutionMode.CONCURRENT.

Specified by:

getExecutionMode in interface Node<JupiterEngineExecutionContext>

Returns:

the preferred execution mode of this node; never null

See Also:

Node.ExecutionMode

getExplicitExecutionMode

protected Optional<Node.ExecutionMode> getExplicitExecutionMode()

getDefaultChildExecutionMode

protected Optional<Node.ExecutionMode> getDefaultChildExecutionMode()

getExecutionModeFromAnnotation

protected Optional<Node.ExecutionMode> getExecutionModeFromAnnotation(AnnotatedElement element)

toExecutionMode

public static Node.ExecutionMode toExecutionMode(ExecutionMode mode)

getExclusiveResourcesFromAnnotation

protected Set<ExclusiveResource> getExclusiveResourcesFromAnnotation(AnnotatedElement element)

shouldBeSkipped

public Node.SkipResult shouldBeSkipped(JupiterEngineExecutionContext context)
                                throws Exception

Description copied from interface: Node

Determine if the execution of the supplied context should be skipped.

The default implementation returns Node.SkipResult.doNotSkip().

Specified by:

shouldBeSkipped in interface Node<JupiterEngineExecutionContext>

Throws:

Exception

prepare

public abstract JupiterEngineExecutionContext prepare(JupiterEngineExecutionContext context)
                                               throws Exception

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

Specified by:

prepare in interface Node<JupiterEngineExecutionContext>

Throws:

Exception

See Also:

Node.cleanUp(EngineExecutionContext)

cleanUp

public void cleanUp(JupiterEngineExecutionContext context)
             throws Exception

Description copied from interface: Node

Clean up the supplied context after execution.

The default implementation does nothing.

Specified by:

cleanUp in interface Node<JupiterEngineExecutionContext>

Parameters:

context - the context to execute in

Throws:

Exception

See Also:

Node.prepare(EngineExecutionContext)

executeAndMaskThrowable

protected void executeAndMaskThrowable(Executable executable)

Execute the supplied Executable and mask any exception thrown as an unchecked exception.

Parameters:

executable - the Executable to execute

See Also:

ExceptionUtils.throwAsUncheckedException(Throwable)