org.junit.platform.testkit.engine

Class EngineTestKit.Builder

java.lang.Object

org.junit.platform.testkit.engine.EngineTestKit.Builder

Enclosing class:

EngineTestKit

public static final class EngineTestKit.Builder
extends java.lang.Object

TestEngine execution builder.

See EngineTestKit.engine(String) and EngineTestKit.engine(TestEngine) for example usage.

Since:

1.4

See Also:

selectors(DiscoverySelector...), filters(Filter...), configurationParameter(String, String), configurationParameters(Map), execute()

Field Summary

Fields

Modifier and Type	Field and Description
private LauncherDiscoveryRequestBuilder	requestBuilder
private TestEngine	testEngine

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Builder(TestEngine testEngine)

Method Summary

Modifier and Type	Method and Description
EngineTestKit.Builder	configurationParameter(java.lang.String key, java.lang.String value) Add the supplied configuration parameter.
EngineTestKit.Builder	configurationParameters(java.util.Map<java.lang.String,java.lang.String> configurationParameters) Add all of the supplied configuration parameters.
EngineTestKit.Builder	enableImplicitConfigurationParameters(boolean enabled) Configure whether implicit configuration parameters should be considered.
EngineExecutionResults	execute() Execute tests for the configured TestEngine, discovery selectors, discovery filters, and configuration parameters.
EngineTestKit.Builder	filters(DiscoveryFilter<?>... filters) Deprecated. Please use filters(Filter...) instead.
EngineTestKit.Builder	filters(Filter<?>... filters) Add all of the supplied filters.
EngineTestKit.Builder	selectors(DiscoverySelector... selectors) Add all of the supplied discovery selectors.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

requestBuilder

private final LauncherDiscoveryRequestBuilder requestBuilder

testEngine

private final TestEngine testEngine

Constructor Detail

Builder

private Builder(TestEngine testEngine)

Method Detail

selectors

public EngineTestKit.Builder selectors(DiscoverySelector... selectors)

Add all of the supplied discovery selectors.

Built-in discovery selectors can be created via the static factory methods in DiscoverySelectors.

Parameters:

selectors - the discovery selectors to add; never null

Returns:

this builder for method chaining

See Also:

filters(Filter...), configurationParameter(String, String), configurationParameters(Map), execute()

filters

@Deprecated
 @API(status=DEPRECATED,
     since="1.7")
public EngineTestKit.Builder filters(DiscoveryFilter<?>... filters)

Deprecated. Please use filters(Filter...) instead.

Add all of the supplied discovery filters.

Built-in discovery filters can be created via the static factory methods in ClassNameFilter and PackageNameFilter.

Parameters:

filters - the discovery filters to add; never null

Returns:

this builder for method chaining

See Also:

filters(Filter...), selectors(DiscoverySelector...), configurationParameter(String, String), configurationParameters(Map), execute()

filters

@API(status=STABLE,
     since="1.10")
public EngineTestKit.Builder filters(Filter<?>... filters)

Add all of the supplied filters.

Built-in discovery filters can be created via the static factory methods in ClassNameFilter and PackageNameFilter.

Built-in post-discovery filters can be created via the static factory methods in TagFilter.

Parameters:

filters - the filters to add; never null

Returns:

this builder for method chaining

Since:

1.7

See Also:

selectors(DiscoverySelector...), configurationParameter(String, String), configurationParameters(Map), execute()

configurationParameter

public EngineTestKit.Builder configurationParameter(java.lang.String key,
                                                    java.lang.String value)

Add the supplied configuration parameter.

Parameters:

key - the configuration parameter key under which to store the value; never null or blank

value - the value to store

Returns:

this builder for method chaining

See Also:

selectors(DiscoverySelector...), filters(Filter...), configurationParameters(Map), execute(), ConfigurationParameters

configurationParameters

public EngineTestKit.Builder configurationParameters(java.util.Map<java.lang.String,java.lang.String> configurationParameters)

Add all of the supplied configuration parameters.

Parameters:

configurationParameters - the map of configuration parameters to add; never null

Returns:

this builder for method chaining

See Also:

selectors(DiscoverySelector...), filters(Filter...), configurationParameter(String, String), execute(), ConfigurationParameters

enableImplicitConfigurationParameters

@API(status=STABLE,
     since="1.10")
public EngineTestKit.Builder enableImplicitConfigurationParameters(boolean enabled)

Configure whether implicit configuration parameters should be considered.

By default, only configuration parameters that are passed explicitly to this builder are taken into account. Passing true to this method, enables additionally reading configuration parameters from implicit sources, i.e. system properties and the junit-platform.properties classpath resource.

See Also:

configurationParameter(String, String), configurationParameters(Map)

execute

public EngineExecutionResults execute()

Execute tests for the configured TestEngine, discovery selectors, discovery filters, and configuration parameters.

Returns:

the recorded EngineExecutionResults

See Also:

selectors(DiscoverySelector...), filters(Filter...), configurationParameter(String, String), configurationParameters(Map)