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

Class EngineDiscoveryRequestResolver.Builder<T extends TestDescriptor>

java.lang.Object

org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver.Builder<T>

Type Parameters:

T - the type of the engine's descriptor

Enclosing class:

EngineDiscoveryRequestResolver<T extends TestDescriptor>

@API(status=STABLE,
     since="1.10")
public static class EngineDiscoveryRequestResolver.Builder<T extends TestDescriptor>
extends java.lang.Object

Builder for EngineDiscoveryRequestResolver.

Since:

1.5

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	Builder()

Method Summary

Modifier and Type	Method	Description
EngineDiscoveryRequestResolver.Builder<T>	addClassContainerSelectorResolver(java.util.function.Predicate<java.lang.Class<?>> classFilter)	Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClassSelectors by scanning for classes that satisfy the supplied predicate in the respective class containers to this builder.
EngineDiscoveryRequestResolver.Builder<T>	addClassContainerSelectorResolverWithContext(java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,java.util.function.Predicate<java.lang.Class<?>>> classFilterCreator)	Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClassSelectors by scanning for classes that satisfy the predicate created by the supplied Function in the respective class containers to this builder.
EngineDiscoveryRequestResolver.Builder<T>	addResourceContainerSelectorResolver(java.util.function.Predicate<org.junit.platform.commons.support.Resource> resourceFilter)	Deprecated. Please use addResourceContainerSelectorResolver(ResourceFilter) instead.
EngineDiscoveryRequestResolver.Builder<T>	addResourceContainerSelectorResolver(org.junit.platform.commons.io.ResourceFilter resourceFilter)	Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClasspathResourceSelectors by scanning for resources that match the supplied resource filter in the respective class containers to this builder.
EngineDiscoveryRequestResolver.Builder<T>	addSelectorResolver(java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,SelectorResolver> resolverCreator)	Add a context sensitive SelectorResolver to this builder.
EngineDiscoveryRequestResolver.Builder<T>	addSelectorResolver(SelectorResolver resolver)	Add a context insensitive SelectorResolver to this builder.
EngineDiscoveryRequestResolver.Builder<T>	addTestDescriptorVisitor(java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,TestDescriptor.Visitor> visitorCreator)	Add a context sensitive TestDescriptor.Visitor to this builder.
EngineDiscoveryRequestResolver<T>	build()	Build the EngineDiscoveryRequestResolver that has been configured via this builder.

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

Builder

private Builder()

Method Detail

addClassContainerSelectorResolver

public EngineDiscoveryRequestResolver.Builder<T> addClassContainerSelectorResolver(java.util.function.Predicate<java.lang.Class<?>> classFilter)

Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClassSelectors by scanning for classes that satisfy the supplied predicate in the respective class containers to this builder.

Parameters:

classFilter - predicate the resolved classes must satisfy; never null

Returns:

this builder for method chaining

addClassContainerSelectorResolverWithContext

@API(status=MAINTAINED,
     since="1.13.3")
public EngineDiscoveryRequestResolver.Builder<T> addClassContainerSelectorResolverWithContext(java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,java.util.function.Predicate<java.lang.Class<?>>> classFilterCreator)

Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClassSelectors by scanning for classes that satisfy the predicate created by the supplied Function in the respective class containers to this builder.

Parameters:

classFilterCreator - the function that will be called to create the predicate the resolved classes must satisfy; never null

Returns:

this builder for method chaining

addResourceContainerSelectorResolver

@API(status=DEPRECATED,
     since="1.14")
@Deprecated
public EngineDiscoveryRequestResolver.Builder<T> addResourceContainerSelectorResolver(java.util.function.Predicate<org.junit.platform.commons.support.Resource> resourceFilter)

Deprecated.

Please use addResourceContainerSelectorResolver(ResourceFilter) instead.

Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClasspathResourceSelectors by scanning for resources that satisfy the supplied predicate in the respective class containers to this builder.

Parameters:

resourceFilter - predicate the resolved classes must satisfy; never null

Returns:

this builder for method chaining

Since:

1.12

addResourceContainerSelectorResolver

@API(status=MAINTAINED,
     since="1.14")
public EngineDiscoveryRequestResolver.Builder<T> addResourceContainerSelectorResolver(org.junit.platform.commons.io.ResourceFilter resourceFilter)

Add a predefined resolver that resolves ClasspathRootSelectors, ModuleSelectors, and PackageSelectors into ClasspathResourceSelectors by scanning for resources that match the supplied resource filter in the respective class containers to this builder.

Parameters:

resourceFilter - filter the resolved classes must match; never null

Returns:

this builder for method chaining

Since:

1.14

addSelectorResolver

public EngineDiscoveryRequestResolver.Builder<T> addSelectorResolver(SelectorResolver resolver)

Add a context insensitive SelectorResolver to this builder.

Parameters:

resolver - the resolver to add; never null

Returns:

this builder for method chaining

addSelectorResolver

public EngineDiscoveryRequestResolver.Builder<T> addSelectorResolver(java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,SelectorResolver> resolverCreator)

Add a context sensitive SelectorResolver to this builder.

Parameters:

resolverCreator - the function that will be called to create the SelectorResolver to be added.

Returns:

this builder for method chaining

See Also:

EngineDiscoveryRequestResolver.InitializationContext

addTestDescriptorVisitor

public EngineDiscoveryRequestResolver.Builder<T> addTestDescriptorVisitor(java.util.function.Function<EngineDiscoveryRequestResolver.InitializationContext<T>,TestDescriptor.Visitor> visitorCreator)

Add a context sensitive TestDescriptor.Visitor to this builder.

If multiple visitors are registered, they will iterate over the test tree separately. To avoid the overhead of multiple iterations, consider combining multiple visitors into a single visitor using TestDescriptor.Visitor.composite(TestDescriptor.Visitor...).

Parameters:

visitorCreator - the function that will be called to create the TestDescriptor.Visitor to be added.

Returns:

this builder for method chaining

See Also:

EngineDiscoveryRequestResolver.InitializationContext

build

public EngineDiscoveryRequestResolver<T> build()

Build the EngineDiscoveryRequestResolver that has been configured via this builder.