Interface SelectorResolver.Context
- Enclosing interface:
- SelectorResolver
DiscoverySelector
and adding it to
the test tree.
The context is used to add resolved TestDescriptors
to the test tree if and only if the parent
TestDescriptor
could be found. Alternatively, a resolver may
use the context to resolve a
certain DiscoverySelector
into a TestDescriptor
(e.g. for
adding a filter and returning a partial match).
- Since:
- 1.5
- See Also:
-
Method Summary
Modifier and TypeMethodDescription<T extends TestDescriptor>
Optional<T>addToParent
(Function<TestDescriptor, Optional<T>> creator) Add aTestDescriptor
to an unspecified parent, usually the engine descriptor, by applying the suppliedFunction
to the new parent.<T extends TestDescriptor>
Optional<T>addToParent
(Supplier<DiscoverySelector> parentSelectorSupplier, Function<TestDescriptor, Optional<T>> creator) Add aTestDescriptor
to a parent, specified by theDiscoverySelector
returned by the suppliedSupplier
, by applying the suppliedFunction
to the new parent.resolve
(DiscoverySelector selector) Resolve the suppliedTestDescriptor
, if possible.
-
Method Details
-
resolve
Resolve the suppliedTestDescriptor
, if possible.Calling this method has the same effect as returning a partial match from a
SelectorResolver
: the children of the resultingTestDescriptor
will only be resolved if a subsequent resolution finds an exact match that contains aTestDescriptor
with the same unique ID.- Parameters:
selector
- the selector to resolve- Returns:
- the resolved
TestDescriptor
; nevernull
but potentially empty
-
addToParent
Add aTestDescriptor
to an unspecified parent, usually the engine descriptor, by applying the suppliedFunction
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 parentTestDescriptor
unless a descriptor with the same unique ID was added earlier.- Type Parameters:
T
- the type of the newTestDescriptor
- Parameters:
creator
-Function
that will be called with the new parent to determine the newTestDescriptor
to be added; must not returnnull
- Returns:
- the new
TestDescriptor
or the previously existing one with the same unique ID; nevernull
but potentially empty - Throws:
ClassCastException
- if the previously existingTestDescriptor
is not an instance ofT
-
addToParent
<T extends TestDescriptor> Optional<T> addToParent(Supplier<DiscoverySelector> parentSelectorSupplier, Function<TestDescriptor, Optional<T>> creator) Add aTestDescriptor
to a parent, specified by theDiscoverySelector
returned by the suppliedSupplier
, by applying the suppliedFunction
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
, theDiscoverySelector
returned by the suppliedSupplier
will be used to determine the parent. If no parent is found, the suppliedFunction
will not be called. If there are multiple potential parents, an exception will be thrown. Otherwise, the resolvedTestDescriptor
will be used as the parent and passed to the suppliedFunction
.If the result of applying the
Function
is present, it will be added as a child of the parentTestDescriptor
unless a descriptor with the same unique ID was added earlier.- Type Parameters:
T
- the type of the newTestDescriptor
- Parameters:
creator
-Function
that will be called with the new parent to determine the newTestDescriptor
to be added; must not returnnull
- Returns:
- the new
TestDescriptor
or the previously existing one with the same unique ID; nevernull
but potentially empty - Throws:
ClassCastException
- if the previously existingTestDescriptor
is not an instance ofT
-