@API(status=STABLE, since="1.0") public class LauncherFactory extends Object
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 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)
.
Launcher
,
LauncherConfig
Modifier and Type | Method and Description |
---|---|
static Launcher |
create()
Factory method for creating a new
Launcher using automatic
registration for test engines and test execution listeners. |
static Launcher |
create(LauncherConfig config)
Factory method for creating a new
Launcher using the supplied
LauncherConfig . |
public static Launcher create() throws PreconditionViolationException
Launcher
using automatic
registration for test engines and test execution listeners.PreconditionViolationException
- if no test engines are detectedcreate(LauncherConfig)
@API(status=EXPERIMENTAL, since="1.3") public static Launcher create(LauncherConfig config) throws PreconditionViolationException
Launcher
using the supplied
LauncherConfig
.config
- the configuration for the launcher; never null
PreconditionViolationException
- if the supplied launcher
configuration is null
, or if no test engines are detected or
registeredcreate()
Copyright © 2021. All rights reserved.