org.junit.platform.engine

Interface EngineDiscoveryRequest

All Known Subinterfaces:

LauncherDiscoveryRequest

All Known Implementing Classes:

DefaultDiscoveryRequest

@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 and Description
ConfigurationParameters	getConfigurationParameters() Get the ConfigurationParameters for this request.
default EngineDiscoveryListener	getDiscoveryListener() Get the EngineDiscoveryListener for this request.
<T extends DiscoveryFilter<?>> java.util.List<T>	getFiltersByType(java.lang.Class<T> filterType) Get the DiscoveryFilters for this request, filtered by a particular type.
<T extends DiscoverySelector> java.util.List<T>	getSelectorsByType(java.lang.Class<T> selectorType) Get the DiscoverySelectors for this request, filtered by a particular type.

Method Detail

getSelectorsByType

<T extends DiscoverySelector> java.util.List<T> getSelectorsByType(java.lang.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<?>> java.util.List<T> getFiltersByType(java.lang.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=EXPERIMENTAL,
     since="1.6")
default EngineDiscoveryListener getDiscoveryListener()

Get the EngineDiscoveryListener for this request.

The default implementation returns a no-op listener that ignores all calls so that engines that call this methods can be used with an earlier version of the JUnit Platform that did not yet include this API.

Returns:

the discovery listener; never null

Since:

1.6