Package org.junit.platform.engine

Interface EngineDiscoveryListener

@API(status=STABLE,
     since="1.10")
public interface EngineDiscoveryListener

EngineDiscoveryListener contains TestEngine access to the information necessary to discover tests and containers.

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.

The methods declared in this interface should be called by each TestEngine during test discovery. However, since this interface was only added in 1.6, older engines might not yet do so.

Since:

1.6

See Also:

• EngineDiscoveryRequest.getDiscoveryListener()

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="1.13")
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