org.junit.platform.engine

Interface TestDescriptor

All Known Implementing Classes:

AbstractTestDescriptor, ClassTestDescriptor, EngineDescriptor, JupiterEngineDescriptor, JupiterTestDescriptor, MethodTestDescriptor, NestedClassTestDescriptor, RunnerTestDescriptor, TestFactoryTestDescriptor, VintageTestDescriptor

@API(value=Experimental)
public interface TestDescriptor

Mutable descriptor for a test or container that has been discovered by a TestEngine.

Since:

1.0

See Also:

TestEngine

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	TestDescriptor.Visitor Visitor for the tree-like TestDescriptor structure.

Method Summary

Modifier and Type	Method and Description
default void	accept(TestDescriptor.Visitor visitor) Accept a visitor to the subtree starting with this descriptor.
void	addChild(TestDescriptor descriptor) Add a child to this descriptor.
Optional<? extends TestDescriptor>	findByUniqueId(UniqueId uniqueId) Find the descriptor with the supplied unique ID.
Set<? extends TestDescriptor>	getChildren() Get the set of children of this descriptor.
default Set<? extends TestDescriptor>	getDescendants() Get the set of all descendants of this descriptor.
String	getDisplayName() Get the display name for this descriptor.
Optional<TestDescriptor>	getParent() Get the parent of this descriptor, if available.
Optional<TestSource>	getSource() Get the source of the test or container described by this descriptor, if available.
Set<TestTag>	getTags() Get the set of tags associated with this descriptor.
UniqueId	getUniqueId() Get the unique identifier (UID) for this descriptor.
default boolean	hasTests() Determine if this descriptor or any of its descendants describes a test.
boolean	isContainer() Determine if this descriptor describes a container.
default boolean	isRoot() Determine if this descriptor is a root descriptor.
boolean	isTest() Determine if this descriptor describes a test.
void	removeChild(TestDescriptor descriptor) Remove a child from this descriptor.
void	removeFromHierarchy() Remove this non-root descriptor from its parent and remove all the children from this descriptor.
void	setParent(TestDescriptor parent) Set the parent of this descriptor.

Method Detail

getUniqueId

UniqueId getUniqueId()

Get the unique identifier (UID) for this descriptor.

Uniqueness must be guaranteed across an entire test plan, regardless of how many engines are used behind the scenes.

Returns:

the UniqueId for this descriptor; never null

getDisplayName

String getDisplayName()

Get the display name for this descriptor.

A display name is a human-readable name for a test or container that is typically used for test reporting in IDEs and build tools. Display names may contain spaces, special characters, and emoji, and the format may be customized by TestEngines or potentially by end users as well. Consequently, display names should never be parsed; rather, they should be used for display purposes only.

Returns:

the display name for this descriptor; never null or blank

See Also:

getSource()

getTags

Set<TestTag> getTags()

Get the set of tags associated with this descriptor.

Returns:

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

See Also:

TestTag

getSource

Optional<TestSource> getSource()

Get the source of the test or container described by this descriptor, if available.

See Also:

TestSource

getParent

Optional<TestDescriptor> getParent()

Get the parent of this descriptor, if available.

setParent

void setParent(TestDescriptor parent)

Set the parent of this descriptor.

Parameters:

parent - the new parent of this descriptor; may be null.

getChildren

Set<? extends TestDescriptor> getChildren()

Get the set of children of this descriptor.

Returns:

the set of children of this descriptor; never null but potentially empty

See Also:

getDescendants()

getDescendants

default Set<? extends TestDescriptor> getDescendants()

Get the set of all descendants of this descriptor.

A descendant is a child of this descriptor or a child of one of its children, recursively.

See Also:

getChildren()

addChild

void addChild(TestDescriptor descriptor)

Add a child to this descriptor.

Parameters:

descriptor - the child to add to this descriptor; never null

removeChild

void removeChild(TestDescriptor descriptor)

Remove a child from this descriptor.

Parameters:

descriptor - the child to remove from this descriptor; never null

removeFromHierarchy

void removeFromHierarchy()

Remove this non-root descriptor from its parent and remove all the children from this descriptor.

If this method is invoked on a root descriptor, this method must throw a JUnitException explaining that a root cannot be removed from the hierarchy.

isRoot

default boolean isRoot()

Determine if this descriptor is a root descriptor.

A root descriptor is a descriptor without a parent.

isContainer

boolean isContainer()

Determine if this descriptor describes a container.

isTest

boolean isTest()

Determine if this descriptor describes a test.

hasTests

default boolean hasTests()

Determine if this descriptor or any of its descendants describes a test.

findByUniqueId

Optional<? extends TestDescriptor> findByUniqueId(UniqueId uniqueId)

Find the descriptor with the supplied unique ID.

The search algorithm begins with this descriptor and then searches through its descendants.

Parameters:

uniqueId - the UniqueId to search for; never null

accept

default void accept(TestDescriptor.Visitor visitor)

Accept a visitor to the subtree starting with this descriptor.

Parameters:

visitor - the Visitor to accept; never null