Interface EngineDiscoveryListener


  • @API(status=STABLE,
         since="1.10")
    public interface EngineDiscoveryListener
    EngineDiscoveryListener defines the API which enables a TestEngine to publish information about 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.

    Since:
    1.6
    See Also:
    EngineDiscoveryRequest.getDiscoveryListener(), org.junit.platform.launcher.LauncherDiscoveryListener
    • Method Detail

      • selectorProcessed

        default void selectorProcessed​(UniqueId engineId,
                                       DiscoverySelector selector,
                                       SelectorResolutionResult result)
        Must be called after a discovery selector has been processed by a test engine.

        Exceptions thrown by implementations of this method will cause test discovery of the current engine to be aborted.

        Parameters:
        engineId - the unique ID of the engine descriptor
        selector - the processed selector
        result - the resolution result of the supplied engine and selector
        See Also:
        SelectorResolutionResult
      • issueEncountered

        @API(status=MAINTAINED,
             since="1.13.3")
        default void issueEncountered​(UniqueId engineId,
                                      DiscoveryIssue issue)
        Called when the engine with the supplied engineId encountered an issue during test discovery.
        Parameters:
        engineId - the unique ID of the engine descriptor
        issue - the encountered issue
        Since:
        1.13
        See Also:
        DiscoveryIssue