/*
* Copyright 2015-2019 the original author or authors.
*
* All rights reserved. This program and the accompanying materials are
* made available under the terms of the Eclipse Public License v2.0 which
* accompanies this distribution and is available at
*
* http://www.eclipse.org/legal/epl-v20.html
*/
package org.junit.jupiter.engine.discovery;
import static org.apiguardian.api.API.Status.INTERNAL;
import static org.junit.platform.engine.support.filter.ClasspathScanningSupport.buildClassFilter;
import java.util.LinkedHashSet;
import java.util.Set;
import org.apiguardian.api.API;
import org.junit.jupiter.engine.config.JupiterConfiguration;
import org.junit.jupiter.engine.discovery.predicates.IsTestClassWithTests;
import org.junit.platform.commons.util.ClassFilter;
import org.junit.platform.engine.EngineDiscoveryRequest;
import org.junit.platform.engine.TestDescriptor;
import org.junit.platform.engine.discovery.ClassSelector;
import org.junit.platform.engine.discovery.ClasspathRootSelector;
import org.junit.platform.engine.discovery.MethodSelector;
import org.junit.platform.engine.discovery.ModuleSelector;
import org.junit.platform.engine.discovery.PackageSelector;
import org.junit.platform.engine.discovery.UniqueIdSelector;
DiscoverySelectorResolver
resolves TestDescriptors
for containers and tests selected by DiscoverySelectors with the help of the JavaElementsResolver
. This class is the only public entry point into the discovery package.
See Also: Since: 5.0
/**
* {@code DiscoverySelectorResolver} resolves {@link TestDescriptor TestDescriptors}
* for containers and tests selected by DiscoverySelectors with the help of the
* {@code JavaElementsResolver}.
*
* <p>This class is the only public entry point into the discovery package.
*
* @since 5.0
* @see JavaElementsResolver
*/
@API(status = INTERNAL, since = "5.0")
public class DiscoverySelectorResolver {
private static final IsTestClassWithTests isTestClassWithTests = new IsTestClassWithTests();
public void resolveSelectors(EngineDiscoveryRequest request, JupiterConfiguration configuration,
TestDescriptor engineDescriptor) {
ClassFilter classFilter = buildClassFilter(request, isTestClassWithTests);
resolve(request, configuration, engineDescriptor, classFilter);
filter(engineDescriptor, classFilter);
pruneTree(engineDescriptor);
}
private void resolve(EngineDiscoveryRequest request, JupiterConfiguration configuration,
TestDescriptor engineDescriptor, ClassFilter classFilter) {
JavaElementsResolver javaElementsResolver = createJavaElementsResolver(configuration, engineDescriptor,
classFilter);
request.getSelectorsByType(ClasspathRootSelector.class).forEach(javaElementsResolver::resolveClasspathRoot);
request.getSelectorsByType(ModuleSelector.class).forEach(javaElementsResolver::resolveModule);
request.getSelectorsByType(PackageSelector.class).forEach(javaElementsResolver::resolvePackage);
request.getSelectorsByType(ClassSelector.class).forEach(javaElementsResolver::resolveClass);
request.getSelectorsByType(MethodSelector.class).forEach(javaElementsResolver::resolveMethod);
request.getSelectorsByType(UniqueIdSelector.class).forEach(javaElementsResolver::resolveUniqueId);
}
private void filter(TestDescriptor engineDescriptor, ClassFilter classFilter) {
new DiscoveryFilterApplier().applyClassNamePredicate(classFilter::match, engineDescriptor);
}
private void pruneTree(TestDescriptor rootDescriptor) {
rootDescriptor.accept(TestDescriptor::prune);
}
private JavaElementsResolver createJavaElementsResolver(JupiterConfiguration configuration,
TestDescriptor engineDescriptor, ClassFilter classFilter) {
Set<ElementResolver> resolvers = new LinkedHashSet<>();
resolvers.add(new TestContainerResolver(configuration));
resolvers.add(new NestedTestsResolver(configuration));
resolvers.add(new TestMethodResolver(configuration));
resolvers.add(new TestFactoryMethodResolver(configuration));
resolvers.add(new TestTemplateMethodResolver(configuration));
return new JavaElementsResolver(engineDescriptor, configuration, classFilter, resolvers);
}
}