@API(status=EXPERIMENTAL,
since="1.5")
public interface SelectorResolver
DiscoverySelectors
.
An implementation of a resolve()
method is typically comprised
of the following steps:
TestEngine
and the current
EngineDiscoveryRequest
(e.g.
for a test class: is it relevant for the current engine and does
it pass all filters in the request?).
Context
, to add one or
multiple TestDescriptors
to the designated
parent (see Context
for details) and return a
match or multiple matches. Alternatively, convert the supplied
selector into one or multiple other
selectors (e.g. a PackageSelector
into a set of ClassSelectors
).
Otherwise, return unresolved()
.
Modifier and Type | Interface and Description |
---|---|
static interface |
SelectorResolver.Context
The context for resolving a
DiscoverySelector and adding it to
the test tree. |
static class |
SelectorResolver.Match
An exact or partial match for resolving a
DiscoverySelector into
a TestDescriptor . |
static class |
SelectorResolver.Resolution
The result of an attempt to resolve a
DiscoverySelector . |
default SelectorResolver.Resolution resolve(ClasspathResourceSelector selector, SelectorResolver.Context context)
ClasspathResourceSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(ClasspathRootSelector selector, SelectorResolver.Context context)
ClasspathRootSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(ClassSelector selector, SelectorResolver.Context context)
ClassSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(NestedClassSelector selector, SelectorResolver.Context context)
NestedClassSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(DirectorySelector selector, SelectorResolver.Context context)
DirectorySelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(FileSelector selector, SelectorResolver.Context context)
FileSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(MethodSelector selector, SelectorResolver.Context context)
MethodSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(NestedMethodSelector selector, SelectorResolver.Context context)
NestedMethodSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(ModuleSelector selector, SelectorResolver.Context context)
ModuleSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(PackageSelector selector, SelectorResolver.Context context)
PackageSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(UniqueIdSelector selector, SelectorResolver.Context context)
UniqueIdSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(UriSelector selector, SelectorResolver.Context context)
UriSelector
using the supplied
Context
.
The default implementation simply delegates to resolve(DiscoverySelector, Context)
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
resolve(DiscoverySelector, Context)
default SelectorResolver.Resolution resolve(DiscoverySelector selector, SelectorResolver.Context context)
DiscoverySelector
using the supplied
Context
.
This method is only called if none of the overloaded variants match.
The default implementation returns unresolved()
.
selector
- the selector to be resolved; never null
context
- the context to be used for resolving the selector; never
null
Resolution
of unresolved()
, selectors()
, or matches()
; never null
SelectorResolver.Context
Copyright © 2020. All rights reserved.