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)
.
- Since:
- 1.0
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionstatic Launcher
create()
static Launcher
create
(LauncherConfig config) Factory method for creating a newLauncher
using the suppliedLauncherConfig
.static LauncherSession
static LauncherSession
openSession
(LauncherConfig config) Factory method for opening a newLauncherSession
using the suppliedLauncherConfig
.
-
Method Details
-
openSession
@API(status=STABLE, since="1.10") public static LauncherSession openSession() throws PreconditionViolationException- Throws:
PreconditionViolationException
- if no test engines are detected- Since:
- 1.8
- See Also:
-
openSession
@API(status=STABLE, since="1.10") public static LauncherSession openSession(LauncherConfig config) throws PreconditionViolationException Factory method for opening a newLauncherSession
using the suppliedLauncherConfig
.- Parameters:
config
- the configuration for the session and the launcher; nevernull
- Throws:
PreconditionViolationException
- if the supplied configuration isnull
, or if no test engines are detected- Since:
- 1.8
- See Also:
-
create
- Throws:
PreconditionViolationException
- if no test engines are detected- See Also:
-
create
@API(status=STABLE, since="1.10") public static Launcher create(LauncherConfig config) throws PreconditionViolationException Factory method for creating a newLauncher
using the suppliedLauncherConfig
.- Parameters:
config
- the configuration for the launcher; nevernull
- Throws:
PreconditionViolationException
- if the supplied configuration isnull
, or if no test engines are detected registered- Since:
- 1.3
- See Also:
-