Module org.junit.platform.engine

Package org.junit.platform.engine.discovery

Interface DiscoverySelectorIdentifierParser

All Known Implementing Classes:

ClasspathResourceSelector.IdentifierParser, ClasspathRootSelector.IdentifierParser, ClassSelector.IdentifierParser, DirectorySelector.IdentifierParser, FileSelector.IdentifierParser, IterationSelector.IdentifierParser, MethodSelector.IdentifierParser, ModuleSelector.IdentifierParser, NestedClassSelector.IdentifierParser, NestedMethodSelector.IdentifierParser, PackageSelector.IdentifierParser, UniqueIdSelector.IdentifierParser, UriSelector.IdentifierParser

@API(status=MAINTAINED,
     since="1.13.3")
public interface DiscoverySelectorIdentifierParser

Parser for a DiscoverySelectorIdentifier with a specific prefix.

Implementations of this interface can be registered using the Java service loader mechanism to extend the set of supported prefixes for DiscoverySelectorIdentifiers.

Since:

1.11

See Also:

• DiscoverySelectors.parse(String)

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	DiscoverySelectorIdentifierParser.Context	Context for parsing DiscoverySelectorIdentifiers.

Method Summary

Modifier and Type	Method	Description
String	getPrefix()	Get the prefix that this parser supports.
Optional<? extends DiscoverySelector>	parse(DiscoverySelectorIdentifier identifier, DiscoverySelectorIdentifierParser.Context context)	Parse the supplied DiscoverySelectorIdentifier.

Method Details

getPrefix

String getPrefix()

Get the prefix that this parser supports.

Returns:

the prefix that this parser supports; never null or blank

parse

Optional<? extends DiscoverySelector> parse(DiscoverySelectorIdentifier identifier,
 DiscoverySelectorIdentifierParser.Context context)

Parse the supplied DiscoverySelectorIdentifier.

The JUnit Platform will only invoke this method if the supplied DiscoverySelectorIdentifier has a prefix that matches the value returned by getPrefix().

Parameters:

identifier - the DiscoverySelectorIdentifier to parse

context - the DiscoverySelectorIdentifierParser.Context to use for parsing

Returns:

an Optional containing the parsed DiscoverySelector; never null but potentially empty