Package 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(DiscoveryFilter...), configurationParameter(String, String), configurationParameters(Map), execute()

Field Summary

Fields

Modifier and Type	Field	Description
private LauncherDiscoveryRequestBuilder	requestBuilder
private TestEngine	testEngine

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Builder(TestEngine testEngine)

Method Summary

Modifier and Type	Method	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.
EngineExecutionResults	execute()	Execute tests for the configured TestEngine, discovery selectors, discovery filters, and configuration parameters.
EngineTestKit.Builder	filters(DiscoveryFilter<?>... filters)	Add all of the supplied discovery 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(DiscoveryFilter...), configurationParameter(String, String), configurationParameters(Map), execute()

filters

public EngineTestKit.Builder filters(DiscoveryFilter<?>... filters)

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:

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(DiscoveryFilter...), 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(DiscoveryFilter...), configurationParameter(String, String), execute(), ConfigurationParameters

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(DiscoveryFilter...), configurationParameter(String, String), configurationParameters(Map)