org.junit.platform.launcher.core

Class SessionPerRequestLauncher

java.lang.Object

org.junit.platform.launcher.core.SessionPerRequestLauncher

All Implemented Interfaces:

Launcher

class SessionPerRequestLauncher
extends java.lang.Object
implements Launcher

Since:

1.8

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.function.Supplier<java.util.List<LauncherInterceptor>>	interceptorFactory
private java.util.function.Supplier<Launcher>	launcherSupplier
private LauncherListenerRegistry	listenerRegistry
private java.util.function.Supplier<LauncherSessionListener>	sessionListenerSupplier

Constructor Summary

Constructors

Constructor and Description
SessionPerRequestLauncher(java.util.function.Supplier<Launcher> launcherSupplier, java.util.function.Supplier<LauncherSessionListener> sessionListenerSupplier, java.util.function.Supplier<java.util.List<LauncherInterceptor>> interceptorFactory)

Method Summary

Modifier and Type	Method and Description
private LauncherSession	createSession()
TestPlan	discover(LauncherDiscoveryRequest launcherDiscoveryRequest) Discover tests and build a TestPlan according to the supplied LauncherDiscoveryRequest by querying all registered engines and collecting their results.
void	execute(LauncherDiscoveryRequest launcherDiscoveryRequest, 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.
void	execute(TestPlan testPlan, TestExecutionListener... listeners) Execute the supplied TestPlan and notify registered listeners about the progress and results of the execution.
void	registerLauncherDiscoveryListeners(LauncherDiscoveryListener... listeners) Register one or more listeners for test discovery.
void	registerTestExecutionListeners(TestExecutionListener... listeners) Register one or more listeners for test execution.

Methods inherited from class java.lang.Object

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

Field Detail

listenerRegistry

private final LauncherListenerRegistry listenerRegistry

launcherSupplier

private final java.util.function.Supplier<Launcher> launcherSupplier

sessionListenerSupplier

private final java.util.function.Supplier<LauncherSessionListener> sessionListenerSupplier

interceptorFactory

private final java.util.function.Supplier<java.util.List<LauncherInterceptor>> interceptorFactory

Constructor Detail

SessionPerRequestLauncher

SessionPerRequestLauncher(java.util.function.Supplier<Launcher> launcherSupplier,
                          java.util.function.Supplier<LauncherSessionListener> sessionListenerSupplier,
                          java.util.function.Supplier<java.util.List<LauncherInterceptor>> interceptorFactory)

Method Detail

registerLauncherDiscoveryListeners

public void registerLauncherDiscoveryListeners(LauncherDiscoveryListener... listeners)

Description copied from interface: Launcher

Register one or more listeners for test discovery.

Specified by:

registerLauncherDiscoveryListeners in interface Launcher

Parameters:

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

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 launcherDiscoveryRequest)

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:

launcherDiscoveryRequest - the launcher discovery request; never null

Returns:

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

execute

public void execute(LauncherDiscoveryRequest launcherDiscoveryRequest,
                    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:

launcherDiscoveryRequest - 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

createSession

private LauncherSession createSession()