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.

Since:
1.6
See Also:
LauncherDiscoveryListeners, LauncherDiscoveryRequest.getDiscoveryListener(), LauncherConfig.Builder.addLauncherDiscoveryListeners(org.junit.platform.launcher.LauncherDiscoveryListener...)
  • Field Details

  • 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

      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 descriptor
      result - the discovery result of the supplied engine
      See Also:
      EngineDiscoveryResult