Module org.junit.platform.launcher
Package org.junit.platform.launcher
Interface LauncherDiscoveryListener
-
- All Superinterfaces:
EngineDiscoveryListener
- All Known Implementing Classes:
AbortOnFailureLauncherDiscoveryListener
,CompositeLauncherDiscoveryListener
,LoggingLauncherDiscoveryListener
@API(status=EXPERIMENTAL, since="1.6") public interface LauncherDiscoveryListener extends EngineDiscoveryListener
Register a concrete implementation of this interface with aLauncherDiscoveryRequestBuilder
orLauncher
to be notified of events that occur during test discovery.All methods in this interface have empty default implementations. Concrete implementations may therefore override one or more of these methods to be notified of the selected events.
JUnit provides default implementations that are created via the factory methods in
LauncherDiscoveryListeners
.The methods declared in this interface are called by the
Launcher
created via theLauncherFactory
during test discovery.
-
-
Field Summary
Fields Modifier and Type Field Description static LauncherDiscoveryListener
NOOP
No-op implementation ofLauncherDiscoveryListener
-
Method Summary
All Methods Instance Methods Default Methods Modifier and Type Method Description default void
engineDiscoveryFinished(UniqueId engineId, EngineDiscoveryResult result)
Called when test discovery has finished for an engine.default void
engineDiscoveryStarted(UniqueId engineId)
Called when test discovery is about to be started for an engine.default void
launcherDiscoveryFinished(LauncherDiscoveryRequest request)
Called when test discovery has finished.default void
launcherDiscoveryStarted(LauncherDiscoveryRequest request)
Called when test discovery is about to be started.-
Methods inherited from interface org.junit.platform.engine.EngineDiscoveryListener
selectorProcessed
-
-
-
-
Field Detail
-
NOOP
static final LauncherDiscoveryListener NOOP
No-op implementation ofLauncherDiscoveryListener
-
-
Method Detail
-
launcherDiscoveryStarted
@API(status=STABLE, since="1.10") default void launcherDiscoveryStarted(LauncherDiscoveryRequest request)
Called when test discovery is about to be started.- Parameters:
request
- the request for which discovery is being started- Since:
- 1.8
-
launcherDiscoveryFinished
@API(status=STABLE, since="1.10") default void launcherDiscoveryFinished(LauncherDiscoveryRequest request)
Called when test discovery has finished.- Parameters:
request
- the request for which discovery has finished- Since:
- 1.8
-
engineDiscoveryStarted
default void engineDiscoveryStarted(UniqueId engineId)
Called when test discovery is about to be started for an engine.- Parameters:
engineId
- the unique ID of the engine descriptor
-
engineDiscoveryFinished
default void engineDiscoveryFinished(UniqueId engineId, EngineDiscoveryResult result)
Called when test discovery has finished for an engine.Exceptions thrown by implementations of this method will cause the complete test discovery to be aborted.
- Parameters:
engineId
- the unique ID of the engine descriptorresult
- the discovery result of the supplied engine- See Also:
EngineDiscoveryResult
-
-