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

Class EngineDiscoveryRequestResolution.DefaultContext

java.lang.Object

org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.DefaultContext

All Implemented Interfaces:

SelectorResolver.Context

Enclosing class:

EngineDiscoveryRequestResolution

private class EngineDiscoveryRequestResolution.DefaultContext
extends java.lang.Object
implements SelectorResolver.Context

Field Summary

Fields

Modifier and Type	Field	Description
private TestDescriptor	parent

Constructor Summary

Constructors

Constructor	Description
DefaultContext(TestDescriptor parent)

Method Summary

Modifier and Type	Method	Description
<T extends TestDescriptor> java.util.Optional<T>	addToParent(java.util.function.Function<TestDescriptor,java.util.Optional<T>> creator)	Add a TestDescriptor to an unspecified parent, usually the engine descriptor, by applying the supplied Function to the new parent.
<T extends TestDescriptor> java.util.Optional<T>	addToParent(java.util.function.Supplier<DiscoverySelector> parentSelectorSupplier, java.util.function.Function<TestDescriptor,java.util.Optional<T>> creator)	Add a TestDescriptor to a parent, specified by the DiscoverySelector returned by the supplied Supplier, by applying the supplied Function to the new parent.
private <T extends TestDescriptor> java.util.Optional<T>	createAndAdd(TestDescriptor parent, java.util.function.Function<TestDescriptor,java.util.Optional<T>> creator)
java.util.Optional<TestDescriptor>	resolve(DiscoverySelector selector)	Resolve the supplied TestDescriptor, if possible.

Methods inherited from class java.lang.Object

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

Field Detail

parent

private final TestDescriptor parent

Constructor Detail

DefaultContext

DefaultContext(TestDescriptor parent)

Method Detail

addToParent

public <T extends TestDescriptor> java.util.Optional<T> addToParent(java.util.function.Function<TestDescriptor,java.util.Optional<T>> creator)

Description copied from interface: SelectorResolver.Context

Add a TestDescriptor to an unspecified parent, usually the engine descriptor, by applying the supplied Function to the new parent.

The parent will be the engine descriptor unless another parent has already been determined, i.e. if the selector that is being resolved is the result of expanding a SelectorResolver.Match.

If the result of applying the Function is present, it will be added as a child of the parent TestDescriptor unless a descriptor with the same unique ID was added earlier.

Specified by:

addToParent in interface SelectorResolver.Context

Type Parameters:

T - the type of the new TestDescriptor

Parameters:

creator - Function that will be called with the new parent to determine the new TestDescriptor to be added; must not return null

Returns:

the new TestDescriptor or the previously existing one with the same unique ID; never null but potentially empty

addToParent

public <T extends TestDescriptor> java.util.Optional<T> addToParent(java.util.function.Supplier<DiscoverySelector> parentSelectorSupplier,
                                                                    java.util.function.Function<TestDescriptor,java.util.Optional<T>> creator)

Description copied from interface: SelectorResolver.Context

Add a TestDescriptor to a parent, specified by the DiscoverySelector returned by the supplied Supplier, by applying the supplied Function to the new parent.

Unless another parent has already been determined, i.e. if the selector that is being resolved is the result of expanding a SelectorResolver.Match, the DiscoverySelector returned by the supplied Supplier will be used to determine the parent. If no parent is found, the supplied Function will not be called. If there are multiple potential parents, an exception will be thrown. Otherwise, the resolved TestDescriptor will be used as the parent and passed to the supplied Function.

If the result of applying the Function is present, it will be added as a child of the parent TestDescriptor unless a descriptor with the same unique ID was added earlier.

Specified by:

addToParent in interface SelectorResolver.Context

Type Parameters:

T - the type of the new TestDescriptor

creator - Function that will be called with the new parent to determine the new TestDescriptor to be added; must not return null

Returns:

the new TestDescriptor or the previously existing one with the same unique ID; never null but potentially empty

resolve

public java.util.Optional<TestDescriptor> resolve(DiscoverySelector selector)

Description copied from interface: SelectorResolver.Context

Resolve the supplied TestDescriptor, if possible.

Calling this method has the same effect as returning a partial match from a SelectorResolver: the children of the resulting TestDescriptor will only be resolved if a subsequent resolution finds an exact match that contains a TestDescriptor with the same unique ID.

Specified by:

resolve in interface SelectorResolver.Context

Parameters:

selector - the selector to resolve

Returns:

the resolved TestDescriptor; never null but potentially empty

createAndAdd

private <T extends TestDescriptor> java.util.Optional<T> createAndAdd(TestDescriptor parent,
                                                                      java.util.function.Function<TestDescriptor,java.util.Optional<T>> creator)