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 java.lang.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.
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	Description
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	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	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 while forwarding encountered discovery issues to the EngineDiscoveryRequest's EngineDiscoveryListener.
void	resolve(EngineDiscoveryRequest request, T engineDescriptor, DiscoveryIssueReporter issueReporter)	Resolve the supplied EngineDiscoveryRequest and collect the results into the supplied TestDescriptor using the supplied DiscoveryIssueReporter to report issues encountered during resolution.

Methods inherited from class java.lang.Object

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

Field Detail

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 while forwarding encountered discovery issues to the EngineDiscoveryRequest's EngineDiscoveryListener.

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

resolve

@API(status=MAINTAINED,
     since="1.13.3")
public void resolve(EngineDiscoveryRequest request,
                    T engineDescriptor,
                    DiscoveryIssueReporter issueReporter)

Resolve the supplied EngineDiscoveryRequest and collect the results into the supplied TestDescriptor using the supplied DiscoveryIssueReporter to report issues encountered during resolution.

The algorithm works as described in resolve(EngineDiscoveryRequest, TestDescriptor).

Parameters:

request - the request to be resolved; never null

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

issueReporter - the DiscoveryIssueReporter to report issues encountered during resolution

Since:

1.13

See Also:

resolve(EngineDiscoveryRequest, TestDescriptor), 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