Module org.junit.platform.engine

Package org.junit.platform.engine.discovery

Class ClasspathRootSelector

java.lang.Object

org.junit.platform.engine.discovery.ClasspathRootSelector

All Implemented Interfaces:

DiscoverySelector

@API(status=STABLE,
     since="1.0")
public class ClasspathRootSelector
extends Object
implements DiscoverySelector

A DiscoverySelector that selects a classpath root so that TestEngines can search for class files or resources within the physical classpath — for example, to scan for test classes.

Since engines are not expected to modify the classpath, the classpath root represented by this selector must be on the classpath of the context class loader of the thread that uses this selector.

Since:

1.0

See Also:

• DiscoverySelectors.selectClasspathRoots(java.util.Set)
• ClasspathResourceSelector
• Thread.getContextClassLoader()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClasspathRootSelector.IdentifierParser	The DiscoverySelectorIdentifierParser for ClasspathRootSelectors.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
URI	getClasspathRoot()	Get the selected classpath root directory as an URI.
int	hashCode()
Optional<DiscoverySelectorIdentifier>	toIdentifier()	Return the identifier of this selector.
String	toString()

Methods inherited from class java.lang.Object

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

Method Details

getClasspathRoot

public URI getClasspathRoot()

Get the selected classpath root directory as an URI.

equals

@API(status=STABLE,
     since="1.3")
public boolean equals(Object o)

Overrides:

equals in class Object

Since:

1.3

hashCode

@API(status=STABLE,
     since="1.3")
public int hashCode()

Overrides:

hashCode in class Object

Since:

1.3

toString

public String toString()

Overrides:

toString in class Object

toIdentifier

public Optional<DiscoverySelectorIdentifier> toIdentifier()

Description copied from interface: DiscoverySelector

Return the identifier of this selector.

The returned identifier must be parsable by a corresponding DiscoverySelectorIdentifierParser.

The default implementation returns Optional.empty(). Can be overridden by concrete implementations.

Specified by:

toIdentifier in interface DiscoverySelector

Returns:

an Optional containing the identifier of this selector; never null but potentially empty if the selector does not support identifiers