Module org.junit.platform.engine

Package org.junit.platform.engine.support.discovery

Class EngineDiscoveryRequestResolver<T extends TestDescriptor>

java.lang.Object

org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver<T>

Type Parameters:

T - the type of the engine's descriptor

@API(status=STABLE,
     since="1.10")
public class EngineDiscoveryRequestResolver<T extends TestDescriptor>
extends Object

Configurable test discovery implementation based on SelectorResolver and TestDescriptor.Visitor that can be reused by different TestEngines.

This resolver takes care of notifying registered EngineDiscoveryListeners about the results of processed DiscoverySelectors.

Since:

1.5

See Also:

• builder()
• resolve(EngineDiscoveryRequest, TestDescriptor)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EngineDiscoveryRequestResolver.Builder<T extends TestDescriptor>	Builder for EngineDiscoveryRequestResolver.
static interface	EngineDiscoveryRequestResolver.InitializationContext<T extends TestDescriptor>	The initialization context for creating resolvers and visitors that depend on the EngineDiscoveryRequest to be resolved or the engine descriptor that will be used to collect the results.

Method Summary

Modifier and Type	Method	Description
static <T extends TestDescriptor> EngineDiscoveryRequestResolver.Builder<T>	builder()	Create a new EngineDiscoveryRequestResolver.Builder for creating a EngineDiscoveryRequestResolver.
void	resolve(EngineDiscoveryRequest request, T engineDescriptor)	Resolve the supplied EngineDiscoveryRequest and collect the results into the supplied TestDescriptor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

resolve

public void resolve(EngineDiscoveryRequest request,
 T engineDescriptor)

Resolve the supplied EngineDiscoveryRequest and collect the results into the supplied TestDescriptor.

The algorithm works as follows:

1. Enqueue all selectors in the supplied request to be resolved.
2. While there are selectors to be resolved, get the next one. Otherwise, the resolution is finished.
   1. Iterate over all registered resolvers in the order they were registered in and find the first one that returns a resolution other than unresolved().
   2. If such a resolution exists, enqueue its selectors.
   3. For each exact match in the resolution, expand its children and enqueue them as well.
3. Iterate over all registered visitors and let the engine test descriptor accept them.

Parameters:

request - the request to be resolved; never null

engineDescriptor - the engine's TestDescriptor to be used for adding direct children

See Also:

• SelectorResolver
• TestDescriptor.Visitor

builder

public static <T extends TestDescriptor>
EngineDiscoveryRequestResolver.Builder<T> builder()

Create a new EngineDiscoveryRequestResolver.Builder for creating a EngineDiscoveryRequestResolver.

Type Parameters:

T - the type of the engine's descriptor

Returns:

a new builder; never null