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=EXPERIMENTAL,
     since="1.5")
public class EngineDiscoveryRequestResolver<T extends TestDescriptor>
extends java.lang.Object

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

Since:

1.5

See Also:

builder(), resolve(EngineDiscoveryRequest, TestDescriptor)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EngineDiscoveryRequestResolver.Builder<T extends TestDescriptor> Builder for EngineDiscoveryRequestResolver.
private static class	EngineDiscoveryRequestResolver.DefaultInitializationContext<T extends TestDescriptor>
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.

Field Summary

Fields

Modifier and Type	Field and Description
private static Logger	logger
private java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,SelectorResolver>>	resolverCreators
private java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,TestDescriptor.Visitor>>	visitorCreators

Constructor Summary

Constructors

Modifier	Constructor and Description
private	EngineDiscoveryRequestResolver(java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,SelectorResolver>> resolverCreators, java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,TestDescriptor.Visitor>> visitorCreators)

Method Summary

Modifier and Type	Method and Description
static <T extends TestDescriptor> EngineDiscoveryRequestResolver.Builder<T>	builder() Create a new EngineDiscoveryRequestResolver.Builder for creating a EngineDiscoveryRequestResolver.
private <R> java.util.List<R>	instantiate(java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,R>> creators, EngineDiscoveryRequestResolver.InitializationContext<T> context)
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

Field Detail

logger

private static final Logger logger

resolverCreators

private final java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T extends TestDescriptor>,SelectorResolver>> resolverCreators

visitorCreators

private final java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T extends TestDescriptor>,TestDescriptor.Visitor>> visitorCreators

Constructor Detail

EngineDiscoveryRequestResolver

private EngineDiscoveryRequestResolver(java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,SelectorResolver>> resolverCreators,
                                       java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,TestDescriptor.Visitor>> visitorCreators)

Method Detail

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

instantiate

private <R> java.util.List<R> instantiate(java.util.List<java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,R>> creators,
                                          EngineDiscoveryRequestResolver.InitializationContext<T> context)

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