@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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullresolve(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 nullcontext - the context to be used for resolving the selector; never
nullResolution of unresolved(), selectors(), or matches(); never nullSelectorResolver.Context