org.junit.platform.launcher.core

Class LauncherDiscoveryRequestBuilder

java.lang.Object

org.junit.platform.launcher.core.LauncherDiscoveryRequestBuilder

@API(value=Experimental)
public final class LauncherDiscoveryRequestBuilder
extends java.lang.Object

The LauncherDiscoveryRequestBuilder provides a light-weight DSL for generating a LauncherDiscoveryRequest.

Example

   LauncherDiscoveryRequestBuilder.request()
     .selectors(
        selectPackage("org.example.user"),
        selectClass("org.example.payment.PaymentTests"),
        selectClass(ShippingTests.class),
        selectMethod("org.example.order.OrderTests", "test1"),
        selectMethod(OrderTests.class, "test2"),
        selectMethod(OrderTests.class, testMethod),
        selectClasspathRoots("/my/local/path1"),
        selectClasspathRoots("/my/local/path2"),
        selectUniqueId("unique-id-1"),
        selectUniqueId("unique-id-2")
     )
     .filters(
        includeEngines("junit-jupiter", "kotlin"),
        // excludeEngines("junit-vintage"),
        includeTags("fast"),
        // excludeTags("slow"),
        includeClassNamePattern(".*Test[s]?")
        // includeClassNamePattern("org\.example\.tests.*")
     )
     .configurationParameter("key1", "value1")
     .configurationParameters(configParameterMap)
     .build();
 

Since:

1.0

See Also:

DiscoverySelectors, ClassFilter, EngineFilter, TagFilter

Constructor Summary

Constructors

Constructor and Description
LauncherDiscoveryRequestBuilder()

Method Summary

Modifier and Type	Method and Description
LauncherDiscoveryRequest	build() Build the LauncherDiscoveryRequest that has been configured via this builder.
LauncherDiscoveryRequestBuilder	configurationParameter(java.lang.String key, java.lang.String value) Add the supplied configuration parameter to the request.
LauncherDiscoveryRequestBuilder	configurationParameters(java.util.Map<java.lang.String,java.lang.String> configurationParameters) Add all of the supplied configurationParameters to the request.
LauncherDiscoveryRequestBuilder	filters(Filter<?>... filters) Add all of the supplied filters to the request.
static LauncherDiscoveryRequestBuilder	request() Create a new LauncherDiscoveryRequestBuilder.
LauncherDiscoveryRequestBuilder	selectors(DiscoverySelector... selectors) Add all of the supplied selectors to the request.
LauncherDiscoveryRequestBuilder	selectors(java.util.List<DiscoverySelector> selectors) Add all of the supplied selectors to the request.

Methods inherited from class java.lang.Object

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

Constructor Detail

LauncherDiscoveryRequestBuilder

public LauncherDiscoveryRequestBuilder()

Method Detail

request

public static LauncherDiscoveryRequestBuilder request()

Create a new LauncherDiscoveryRequestBuilder.

selectors

public LauncherDiscoveryRequestBuilder selectors(DiscoverySelector... selectors)

Add all of the supplied selectors to the request.

Parameters:

selectors - the DiscoverySelectors to add

selectors

public LauncherDiscoveryRequestBuilder selectors(java.util.List<DiscoverySelector> selectors)

Add all of the supplied selectors to the request.

Parameters:

selectors - the DiscoverySelectors to add

filters

public LauncherDiscoveryRequestBuilder filters(Filter<?>... filters)

Add all of the supplied filters to the request.

Warning: be cautious when registering multiple competing include EngineFilters or multiple competing exclude EngineFilters for the same discovery request since doing so will likely lead to undesirable results (i.e., zero engines being active).

Parameters:

filters - the Filters to add

configurationParameter

public LauncherDiscoveryRequestBuilder configurationParameter(java.lang.String key,
                                                              java.lang.String value)

Add the supplied configuration parameter to the request.

configurationParameters

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

Add all of the supplied configurationParameters to the request.

Parameters:

configurationParameters - the map of configuration parameters to add

build

public LauncherDiscoveryRequest build()

Build the LauncherDiscoveryRequest that has been configured via this builder.