Module org.junit.platform.engine

Package org.junit.platform.engine.discovery

Class ClasspathResourceSelector

java.lang.Object

org.junit.platform.engine.discovery.ClasspathResourceSelector

All Implemented Interfaces:

DiscoverySelector

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

A DiscoverySelector that selects the name of a classpath resource so that TestEngines can load resources from the classpath — for example, to load XML or JSON files from the classpath, potentially within JARs.

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

Since:

1.0

See Also:

• DiscoverySelectors.selectClasspathResource(String)
• ClasspathRootSelector
• getClasspathResourceName()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClasspathResourceSelector.IdentifierParser	The DiscoverySelectorIdentifierParser for ClasspathResourceSelectors.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
String	getClasspathResourceName()	Get the name of the selected classpath resource.
Optional<FilePosition>	getPosition()	Get the selected FilePosition within the classpath resource.
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

getClasspathResourceName

public String getClasspathResourceName()

Get the name of the selected classpath resource.

The name of a classpath resource must follow the semantics for resource paths as defined in ClassLoader.getResource(String).

See Also:

• ClassLoader.getResource(String)
• ClassLoader.getResourceAsStream(String)
• ClassLoader.getResources(String)

getPosition

public Optional<FilePosition> getPosition()

Get the selected FilePosition within the classpath resource.

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 has to be parsable by a corresponding DiscoverySelectorIdentifierParser.

Specified by:

toIdentifier in interface DiscoverySelector

Returns:

the identifier of this selector or empty if it is not supported; never null