org.junit.platform.launcher

Class TestIdentifier

java.lang.Object

org.junit.platform.launcher.TestIdentifier

All Implemented Interfaces:

java.io.Serializable

@API(value=Experimental)
public final class TestIdentifier
extends java.lang.Object
implements java.io.Serializable

Immutable data transfer object that represents a test or container which is usually part of a TestPlan.

Since:

1.0

See Also:

TestPlan, Serialized Form

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
static TestIdentifier	from(TestDescriptor testDescriptor) Factory for creating a new TestIdentifier from a TestDescriptor.
java.lang.String	getDisplayName() Get the display name of the represented test or container.
java.util.Optional<java.lang.String>	getParentId() Get the unique ID of this identifier's parent, if available.
java.util.Optional<TestSource>	getSource() Get the source of the represented test or container, if available.
java.util.Set<TestTag>	getTags() Get the set of tags associated with the represented test or container.
java.lang.String	getUniqueId() Get the unique ID of the represented test or container.
int	hashCode()
boolean	isContainer() Determine if this identifier represents a container.
boolean	isTest() Determine if this identifier represents a test.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

from

@API(value=Internal)
public static TestIdentifier from(TestDescriptor testDescriptor)

Factory for creating a new TestIdentifier from a TestDescriptor.

getUniqueId

public java.lang.String getUniqueId()

Get the unique ID of the represented test or container.

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

Returns:

the unique ID for this identifier; never null

getParentId

public java.util.Optional<java.lang.String> getParentId()

Get the unique ID of this identifier's parent, if available.

An identifier without a parent is called a root.

Returns:

a container for the unique ID for this identifier's parent; never null though potentially empty

getDisplayName

public java.lang.String getDisplayName()

Get the display name of the represented test or container.

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 identifier; never null or blank

See Also:

getSource(), TestDescriptor.getDisplayName()

isTest

public boolean isTest()

Determine if this identifier represents a test.

isContainer

public boolean isContainer()

Determine if this identifier represents a container.

getSource

public java.util.Optional<TestSource> getSource()

Get the source of the represented test or container, if available.

See Also:

TestSource

getTags

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

Get the set of tags associated with the represented test or container.

See Also:

TestTag

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object