Module org.junit.platform.engine

Package org.junit.platform.engine

Interface EngineDiscoveryRequest

All Known Subinterfaces:

LauncherDiscoveryRequest

@API(status=STABLE,
     since="1.0")
public interface EngineDiscoveryRequest

EngineDiscoveryRequest provides a TestEngine access to the information necessary to discover tests and containers.

A request is comprised of selectors and filters. While the former select resources that engines can use to discover tests, the latter specify how such resources are to be filtered. All of the filters have to include a resource for it to end up in the test plan.

In addition, the supplied configuration parameters can be used to influence the discovery process.

Since:

1.0

See Also:

• TestEngine
• TestDescriptor
• DiscoverySelector
• DiscoveryFilter
• ConfigurationParameters

Method Summary

Modifier and Type	Method	Description
ConfigurationParameters	getConfigurationParameters()	Get the ConfigurationParameters for this request.
default EngineDiscoveryListener	getDiscoveryListener()	Get the EngineDiscoveryListener for this request.
<T extends DiscoveryFilter<?>> List<T>	getFiltersByType(Class<T> filterType)	Get the DiscoveryFilters for this request, filtered by a particular type.
default OutputDirectoryProvider	getOutputDirectoryProvider()	Get the OutputDirectoryProvider for this request.
<T extends DiscoverySelector> List<T>	getSelectorsByType(Class<T> selectorType)	Get the DiscoverySelectors for this request, filtered by a particular type.

Method Details

getSelectorsByType

<T extends DiscoverySelector> List<T> getSelectorsByType(Class<T> selectorType)

Get the DiscoverySelectors for this request, filtered by a particular type.

Parameters:

selectorType - the type of DiscoverySelector to filter by

Returns:

all selectors of this request that are instances of selectorType; never null but potentially empty

getFiltersByType

<T extends DiscoveryFilter<?>> List<T> getFiltersByType(Class<T> filterType)

Get the DiscoveryFilters for this request, filtered by a particular type.

The returned filters are to be combined using AND semantics, i.e. all of them have to include a resource for it to end up in the test plan.

Parameters:

filterType - the type of DiscoveryFilter to filter by

Returns:

all filters of this request that are instances of filterType; never null but potentially empty

getConfigurationParameters

ConfigurationParameters getConfigurationParameters()

Get the ConfigurationParameters for this request.

Returns:

the configuration parameters; never null

getDiscoveryListener

@API(status=STABLE,
     since="1.10")
default EngineDiscoveryListener getDiscoveryListener()

Get the EngineDiscoveryListener for this request.

Returns:

the discovery listener; never null

Since:

1.6

getOutputDirectoryProvider

@API(status=EXPERIMENTAL,
     since="1.12")
default OutputDirectoryProvider getOutputDirectoryProvider()

Get the OutputDirectoryProvider for this request.

Returns:

the output directory provider; never null

Since:

1.12