JUnit 6.0.1 · org.junit.platform.launcher.LauncherDiscoveryRequest

LauncherDiscoveryRequest extends the EngineDiscoveryRequest API with additional filters that are applied by the Launcher itself.

Specifically, a LauncherDiscoveryRequest contains the following.

Engine Filters: filters that are applied before each TestEngine is executed. All of them have to include an engine for it to contribute to the test plan.
Configuration Parameters: configuration parameters that can be used to influence the discovery process
Discovery Selectors: components that select resources that a TestEngine can use to discover tests
Discovery Filters: filters that should be applied by TestEngines during test discovery. All of them have to include a resource for it to end up in the test plan.
Post-Discovery Filters: filters that will be applied by the Launcher after TestEngines have performed test discovery. All of them have to include a TestDescriptor for it to end up in the test plan.

This interface is not intended to be implemented by clients.

Method Summary

Modifier and Type	Method and Description
public default LauncherDiscoveryListener	Returns: the discovery listener; never `null` getDiscoveryListener() Overrides default org.junit.platform.engine.EngineDiscoveryRequest.getDiscoveryListener. Get the `LauncherDiscoveryListener` for this request.
public List<EngineFilter>	Returns: the list of `EngineFilters` for this request; never `null` but potentially empty getEngineFilters() Get the `EngineFilters` for this request.
public List<PostDiscoveryFilter>	Returns: the list of `PostDiscoveryFilters` for this request; never `null` but potentially empty getPostDiscoveryFilters() Get the `PostDiscoveryFilters` for this request.

Inherited from org.junit.platform.engine.EngineDiscoveryRequest:: getConfigurationParameters getFiltersByType getOutputDirectoryCreator getOutputDirectoryProvider getSelectorsByType

Method Detail

getDiscoveryListener back to summary

getDiscoveryListener	back to summary
public default LauncherDiscoveryListener getDiscoveryListener() Overrides default org.junit.platform.engine.EngineDiscoveryRequest.getDiscoveryListener. Get the `LauncherDiscoveryListener` 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 it. Returns:LauncherDiscoveryListener the discovery listener; never `null` Annotations @API status:STABLE since:1.10 @Override Since 1.6

public default LauncherDiscoveryListener getDiscoveryListener()

Overrides default org.junit.platform.engine.EngineDiscoveryRequest.getDiscoveryListener.

Get the LauncherDiscoveryListener 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 it.

Returns:LauncherDiscoveryListener

the discovery listener; never null

Annotations

@API
status:STABLE
since:1.10
@Override

Since

1.6

getEngineFilters back to summary

getEngineFilters	back to summary
public List<EngineFilter> getEngineFilters() Get the `EngineFilters` for this request. The returned filters are to be combined using AND semantics, i.e. all of them have to include an engine for it to contribute to the test plan. Returns:List<EngineFilter> the list of `EngineFilters` for this request; never `null` but potentially empty

public List<EngineFilter> getEngineFilters()

Get the EngineFilters for this request.

The returned filters are to be combined using AND semantics, i.e. all of them have to include an engine for it to contribute to the test plan.

Returns:List<EngineFilter>: the list of EngineFilters for this request; never null but potentially empty

getPostDiscoveryFilters back to summary

getPostDiscoveryFilters	back to summary
public List<PostDiscoveryFilter> getPostDiscoveryFilters() Get the `PostDiscoveryFilters` for this request. The returned filters are to be combined using AND semantics, i.e. all of them have to include a `TestDescriptor` for it to end up in the test plan. Returns:List<PostDiscoveryFilter> the list of `PostDiscoveryFilters` for this request; never `null` but potentially empty

public List<PostDiscoveryFilter> getPostDiscoveryFilters()

Get the PostDiscoveryFilters for this request.

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

Returns:List<PostDiscoveryFilter>: the list of PostDiscoveryFilters for this request; never null but potentially empty

public Interface LauncherDiscoveryRequest

Method Summary

Method Detail