Module org.junit.platform.launcher
Package org.junit.platform.launcher
Interface LauncherDiscoveryListener
- All Superinterfaces:
EngineDiscoveryListener
- All Known Implementing Classes:
FlightRecordingDiscoveryListener
@API(status=EXPERIMENTAL,
since="1.6")
public interface LauncherDiscoveryListener
extends EngineDiscoveryListener
Register a concrete implementation of this interface with a
LauncherDiscoveryRequestBuilder
or
Launcher
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 the LauncherFactory
during test discovery.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final LauncherDiscoveryListener
No-op implementation ofLauncherDiscoveryListener
-
Method Summary
Modifier and TypeMethodDescriptiondefault 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
Called when test discovery has finished.default void
Called when test discovery is about to be started.Methods inherited from interface org.junit.platform.engine.EngineDiscoveryListener
selectorProcessed
-
Field Details
-
NOOP
No-op implementation ofLauncherDiscoveryListener
-
-
Method Details
-
launcherDiscoveryStarted
@API(status=EXPERIMENTAL, since="1.8") 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=EXPERIMENTAL, since="1.8") default void launcherDiscoveryFinished(LauncherDiscoveryRequest request) Called when test discovery has finished.- Parameters:
request
- the request for which discovery has finished- Since:
- 1.8
-
engineDiscoveryStarted
Called when test discovery is about to be started for an engine.- Parameters:
engineId
- the unique ID of the engine descriptor
-
engineDiscoveryFinished
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:
-