Interface EngineDiscoveryListener

All Known Subinterfaces:

LauncherDiscoveryListener

@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()
• LauncherDiscoveryListener

Field Summary

Fields

Modifier and Type	Field	Description
static final EngineDiscoveryListener	NOOP	No-op implementation of EngineDiscoveryListener

Method Summary

Modifier and Type	Method	Description
default void	issueEncountered(UniqueId engineId, DiscoveryIssue issue)	Called when the engine with the supplied engineId encountered an issue during test discovery.
default void	selectorProcessed(UniqueId engineId, DiscoverySelector selector, SelectorResolutionResult result)	Must be called after a discovery selector has been processed by a test engine.

Field Details

NOOP

static final EngineDiscoveryListener NOOP

No-op implementation of EngineDiscoveryListener

Method Details

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=EXPERIMENTAL,
     since="6.0")
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