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 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)
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(Root root, ConfigurationParameters configurationParameters, TestExecutionListener... listeners)
private void	execute(TestEngine testEngine, ExecutionRequest executionRequest)
(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>	validateUniqueIds(java.lang.Iterable<TestEngine> testEngines)

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

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

validateUniqueIds

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

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:

a 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

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(Root root,
                     ConfigurationParameters configurationParameters,
                     TestExecutionListener... listeners)

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)