org.junit.platform.launcher.core

Class DefaultLauncher

java.lang.Object

org.junit.platform.launcher.core.DefaultLauncher

All Implemented Interfaces:

Launcher

class DefaultLauncher
extends java.lang.Object
implements Launcher

Default implementation of the Launcher API.

External clients can obtain an instance by invoking LauncherFactory.create().

Since:

1.0

See Also:

Launcher, LauncherFactory

Field Summary

Fields

Modifier and Type	Field and Description
private EngineDiscoveryResultValidator	discoveryResultValidator
private TestExecutionListenerRegistry	listenerRegistry
private static Logger	logger
private java.lang.Iterable<TestEngine>	testEngines

Constructor Summary

Constructors

Constructor and Description
DefaultLauncher(java.lang.Iterable<TestEngine> testEngines) Construct a new DefaultLauncher with the supplied test engines.

Method Summary

Modifier and Type	Method and Description
private TestExecutionListenerRegistry	buildListenerRegistryForExecution(TestExecutionListener... listeners)
TestPlan	discover(LauncherDiscoveryRequest discoveryRequest) Discover tests and build a TestPlan according to the supplied LauncherDiscoveryRequest by querying all registered engines and collecting their results.
private java.util.Optional<TestDescriptor>	discoverEngineRoot(TestEngine testEngine, LauncherDiscoveryRequest discoveryRequest)
private Root	discoverRoot(LauncherDiscoveryRequest discoveryRequest, java.lang.String phase)
private void	execute(InternalTestPlan internalTestPlan, TestExecutionListener[] listeners)
void	execute(LauncherDiscoveryRequest discoveryRequest, TestExecutionListener... listeners) Execute a TestPlan which is built according to the supplied LauncherDiscoveryRequest by querying all registered engines and collecting their results, and notify registered listeners about the progress and results of the execution.
private void	execute(TestEngine testEngine, ExecutionRequest executionRequest)
void	execute(TestPlan testPlan, TestExecutionListener... listeners) Execute the supplied TestPlan and notify registered listeners about the progress and results of the execution.
(package private) TestExecutionListenerRegistry	getTestExecutionListenerRegistry()
private void	handleThrowable(TestEngine testEngine, java.lang.String phase, java.lang.Throwable throwable)
void	registerTestExecutionListeners(TestExecutionListener... listeners) Register one or more listeners for test execution.
private static java.lang.Iterable<TestEngine>	validateEngineIds(java.lang.Iterable<TestEngine> testEngines)
private static boolean	validateReservedIds(TestEngine testEngine)
private static void	validateWellKnownClassName(TestEngine testEngine, java.lang.String expectedClassName)
private void	withInterceptedStreams(ConfigurationParameters configurationParameters, TestExecutionListenerRegistry listenerRegistry, java.util.function.Consumer<TestExecutionListener> action)

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Logger logger

listenerRegistry

private final TestExecutionListenerRegistry listenerRegistry

discoveryResultValidator

private final EngineDiscoveryResultValidator discoveryResultValidator

testEngines

private final java.lang.Iterable<TestEngine> testEngines

Constructor Detail

DefaultLauncher

DefaultLauncher(java.lang.Iterable<TestEngine> testEngines)

Construct a new DefaultLauncher with the supplied test engines.

Parameters:

testEngines - the test engines to delegate to; never null or empty

Method Detail

validateEngineIds

private static java.lang.Iterable<TestEngine> validateEngineIds(java.lang.Iterable<TestEngine> testEngines)

validateReservedIds

private static boolean validateReservedIds(TestEngine testEngine)

validateWellKnownClassName

private static void validateWellKnownClassName(TestEngine testEngine,
                                               java.lang.String expectedClassName)

registerTestExecutionListeners

public void registerTestExecutionListeners(TestExecutionListener... listeners)

Description copied from interface: Launcher

Register one or more listeners for test execution.

Specified by:

registerTestExecutionListeners in interface Launcher

Parameters:

listeners - the listeners to be notified of test execution events; never null or empty

discover

public TestPlan discover(LauncherDiscoveryRequest discoveryRequest)

Description copied from interface: Launcher

Discover tests and build a TestPlan according to the supplied LauncherDiscoveryRequest by querying all registered engines and collecting their results.

Specified by:

discover in interface Launcher

Parameters:

discoveryRequest - the launcher discovery request; never null

Returns:

an unmodifiable TestPlan that contains all resolved identifiers from all registered engines

execute

public void execute(LauncherDiscoveryRequest discoveryRequest,
                    TestExecutionListener... listeners)

Description copied from interface: Launcher

Execute a TestPlan which is built according to the supplied LauncherDiscoveryRequest by querying all registered engines and collecting their results, and notify registered listeners about the progress and results of the execution.

Supplied test execution listeners are registered in addition to already registered listeners but only for the supplied launcher discovery request.

Specified by:

execute in interface Launcher

Parameters:

discoveryRequest - the launcher discovery request; never null

listeners - additional test execution listeners; never null

execute

public void execute(TestPlan testPlan,
                    TestExecutionListener... listeners)

Description copied from interface: Launcher

Execute the supplied TestPlan and notify registered listeners about the progress and results of the execution.

Supplied test execution listeners are registered in addition to already registered listeners but only for the execution of the supplied test plan.

Specified by:

execute in interface Launcher

Parameters:

testPlan - the test plan to execute; never null

listeners - additional test execution listeners; never null

getTestExecutionListenerRegistry

TestExecutionListenerRegistry getTestExecutionListenerRegistry()

discoverRoot

private Root discoverRoot(LauncherDiscoveryRequest discoveryRequest,
                          java.lang.String phase)

discoverEngineRoot

private java.util.Optional<TestDescriptor> discoverEngineRoot(TestEngine testEngine,
                                                              LauncherDiscoveryRequest discoveryRequest)

execute

private void execute(InternalTestPlan internalTestPlan,
                     TestExecutionListener[] listeners)

withInterceptedStreams

private void withInterceptedStreams(ConfigurationParameters configurationParameters,
                                    TestExecutionListenerRegistry listenerRegistry,
                                    java.util.function.Consumer<TestExecutionListener> action)

buildListenerRegistryForExecution

private TestExecutionListenerRegistry buildListenerRegistryForExecution(TestExecutionListener... listeners)

execute

private void execute(TestEngine testEngine,
                     ExecutionRequest executionRequest)

handleThrowable

private void handleThrowable(TestEngine testEngine,
                             java.lang.String phase,
                             java.lang.Throwable throwable)