JUnit 6.0.1 · org.junit.platform.launcher.core.LauncherFactory

Factory for creating Launcher instances by invoking create() or create(LauncherConfig).

By default, test engines are discovered at runtime using the ServiceLoader mechanism. For that purpose, a text file named META-INF/services/org.junit.platform.engine.TestEngine has to be added to the engine's JAR file in which the fully qualified name of the implementation class of the org.junit.platform.engine.TestEngine interface is declared.

By default, test execution listeners are discovered at runtime via the ServiceLoader mechanism and are automatically registered with the Launcher created by this factory. Users may register additional listeners using the Launcher#registerTestExecutionListeners(TestExecutionListener...) method on the created launcher instance.

For full control over automatic registration and programmatic registration of test engines and listeners, supply an instance of LauncherConfig to create(LauncherConfig).

Access	Constructor and Description
private	LauncherFactory()

Modifier and Type	Method and Description
private static List<LauncherInterceptor>	collectLauncherInterceptors(LauncherConfigurationParameters configurationParameters)
private static List<PostDiscoveryFilter>	collectPostDiscoveryFilters(LauncherConfig config)
private static Set<TestEngine>	collectTestEngines(LauncherConfig config)
public static Launcher	create() Factory method for creating a new `Launcher` using the default `LauncherConfig`.
public static Launcher	create(LauncherConfig the configuration for the launcher; never `null` config) Factory method for creating a new `Launcher` using the supplied `LauncherConfig`.
private static DefaultLauncher	createDefaultLauncher(LauncherConfig config, LauncherConfigurationParameters configurationParameters, NamespacedHierarchicalStore<Namespace> sessionLevelStore)
private static LauncherSessionListener	createLauncherSessionListener(LauncherConfig config)
private static Iterable<TestExecutionListener>	loadAndFilterTestExecutionListeners(ConfigurationParameters configurationParameters)
public static LauncherSession	openSession() Factory method for opening a new `LauncherSession` using the default `LauncherConfig`.
public static LauncherSession	openSession(LauncherConfig the configuration for the session and the launcher; never `null` config) Factory method for opening a new `LauncherSession` using the supplied `LauncherConfig`.
private static void	registerLauncherDiscoveryListeners(LauncherConfig config, Launcher launcher)
private static void	registerTestExecutionListeners(LauncherConfig config, Launcher launcher, LauncherConfigurationParameters configurationParameters)

LauncherFactory	back to summary
private LauncherFactory()

Method Detail

collectLauncherInterceptors	back to summary
private static List<LauncherInterceptor> collectLauncherInterceptors(LauncherConfigurationParameters configurationParameters)

collectPostDiscoveryFilters	back to summary
private static List<PostDiscoveryFilter> collectPostDiscoveryFilters(LauncherConfig config)

collectTestEngines	back to summary
private static Set<TestEngine> collectTestEngines(LauncherConfig config)

create back to summary

create	back to summary
public static Launcher create() throws PreconditionViolationException Factory method for creating a new `Launcher` using the default `LauncherConfig`. Exceptions PreconditionViolationException: if no test engines are detected See Also `create(LauncherConfig)`

public static Launcher create() throws PreconditionViolationException

Factory method for creating a new Launcher using the default LauncherConfig.

Exceptions

PreconditionViolationException:: if no test engines are detected

See Also

create(LauncherConfig)

create back to summary

create	back to summary
public static Launcher create(LauncherConfig config) throws PreconditionViolationException Factory method for creating a new `Launcher` using the supplied `LauncherConfig`. Parameters config:LauncherConfig the configuration for the launcher; never `null` Annotations @API status:STABLE since:1.10 Exceptions PreconditionViolationException: if the supplied configuration is `null`, or if no test engines are detected registered Since 1.3 See Also `create()`

public static Launcher create(LauncherConfig config) throws PreconditionViolationException

Factory method for creating a new Launcher using the supplied LauncherConfig.

Parameters

config:LauncherConfig: the configuration for the launcher; never null

Annotations

@API
status:STABLE
since:1.10

Exceptions

PreconditionViolationException:: if the supplied configuration is null, or if no test engines are detected registered

Since

1.3

See Also

create()

createDefaultLauncher	back to summary
private static DefaultLauncher createDefaultLauncher(LauncherConfig config, LauncherConfigurationParameters configurationParameters, NamespacedHierarchicalStore<Namespace> sessionLevelStore)

createLauncherSessionListener	back to summary
private static LauncherSessionListener createLauncherSessionListener(LauncherConfig config)

loadAndFilterTestExecutionListeners	back to summary
private static Iterable<TestExecutionListener> loadAndFilterTestExecutionListeners(ConfigurationParameters configurationParameters)

openSession back to summary

openSession	back to summary
public static LauncherSession openSession() throws PreconditionViolationException Factory method for opening a new `LauncherSession` using the default `LauncherConfig`. Annotations @API status:STABLE since:1.10 Exceptions PreconditionViolationException: if no test engines are detected Since 1.8 See Also `openSession(LauncherConfig)`

public static LauncherSession openSession() throws PreconditionViolationException

Factory method for opening a new LauncherSession using the default LauncherConfig.

Annotations

@API
status:STABLE
since:1.10

Exceptions

PreconditionViolationException:: if no test engines are detected

Since

1.8

See Also

openSession(LauncherConfig)

openSession back to summary

openSession	back to summary
public static LauncherSession openSession(LauncherConfig config) throws PreconditionViolationException Factory method for opening a new `LauncherSession` using the supplied `LauncherConfig`. Parameters config:LauncherConfig the configuration for the session and the launcher; never `null` Annotations @API status:STABLE since:1.10 Exceptions PreconditionViolationException: if the supplied configuration is `null`, or if no test engines are detected Since 1.8 See Also `openSession()`

public static LauncherSession openSession(LauncherConfig config) throws PreconditionViolationException

Factory method for opening a new LauncherSession using the supplied LauncherConfig.

Parameters

config:LauncherConfig: the configuration for the session and the launcher; never null

Annotations

@API
status:STABLE
since:1.10

Exceptions

PreconditionViolationException:: if the supplied configuration is null, or if no test engines are detected

Since

1.8

See Also

openSession()

registerLauncherDiscoveryListeners	back to summary
private static void registerLauncherDiscoveryListeners(LauncherConfig config, Launcher launcher)

registerTestExecutionListeners	back to summary
private static void registerTestExecutionListeners(LauncherConfig config, Launcher launcher, LauncherConfigurationParameters configurationParameters)

public Class LauncherFactory

Constructor Summary

Method Summary

Constructor Detail

Method Detail