org.gradle.internal.component.model.AttributeConfigurationSelector Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of gradle-api Show documentation
Show all versions of gradle-api Show documentation
Gradle 6.9.1 API redistribution.
/*
* Copyright 2017 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.gradle.internal.component.model;
import com.google.common.base.Optional;
import com.google.common.collect.ImmutableList;
import com.google.common.collect.Lists;
import com.google.common.collect.Sets;
import org.gradle.api.artifacts.ArtifactIdentifier;
import org.gradle.api.artifacts.Dependency;
import org.gradle.api.artifacts.ModuleVersionIdentifier;
import org.gradle.api.attributes.Attribute;
import org.gradle.api.attributes.HasAttributes;
import org.gradle.api.capabilities.CapabilitiesMetadata;
import org.gradle.api.capabilities.Capability;
import org.gradle.api.internal.attributes.AttributeContainerInternal;
import org.gradle.api.internal.attributes.AttributeDescriber;
import org.gradle.api.internal.attributes.AttributeValue;
import org.gradle.api.internal.attributes.AttributesSchemaInternal;
import org.gradle.api.internal.attributes.ImmutableAttributes;
import org.gradle.internal.Cast;
import org.gradle.internal.component.AmbiguousConfigurationSelectionException;
import org.gradle.internal.component.NoMatchingCapabilitiesException;
import org.gradle.internal.component.NoMatchingConfigurationSelectionException;
import org.gradle.internal.component.external.model.ModuleComponentArtifactMetadata;
import org.gradle.internal.component.external.model.ShadowedCapability;
import org.gradle.internal.component.external.model.ShadowedCapabilityOnly;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Set;
public abstract class AttributeConfigurationSelector {
public static ConfigurationMetadata selectConfigurationUsingAttributeMatching(ImmutableAttributes consumerAttributes, Collection explicitRequestedCapabilities, ComponentResolveMetadata targetComponent, AttributesSchemaInternal consumerSchema, List requestedArtifacts) {
return selectConfigurationUsingAttributeMatching(consumerAttributes, explicitRequestedCapabilities, targetComponent, consumerSchema, requestedArtifacts, AttributeMatchingExplanationBuilder.logging());
}
private static ConfigurationMetadata selectConfigurationUsingAttributeMatching(ImmutableAttributes consumerAttributes, Collection explicitRequestedCapabilities, ComponentResolveMetadata targetComponent, AttributesSchemaInternal consumerSchema, List requestedArtifacts, AttributeMatchingExplanationBuilder explanationBuilder) {
Optional> variantsForGraphTraversal = targetComponent.getVariantsForGraphTraversal();
ImmutableList consumableConfigurations = variantsForGraphTraversal.or(ImmutableList.of());
AttributesSchemaInternal producerAttributeSchema = targetComponent.getAttributesSchema();
AttributeMatcher attributeMatcher = consumerSchema.withProducer(producerAttributeSchema);
ConfigurationMetadata fallbackConfiguration = targetComponent.getConfiguration(Dependency.DEFAULT_CONFIGURATION);
if (fallbackConfiguration != null && !fallbackConfiguration.isCanBeConsumed()) {
fallbackConfiguration = null;
}
ModuleVersionIdentifier versionId = targetComponent.getModuleVersionId();
if (!consumableConfigurations.isEmpty()) {
ImmutableList variantsProvidingRequestedCapabilities = filterVariantsByRequestedCapabilities(targetComponent, explicitRequestedCapabilities, consumableConfigurations, versionId.getGroup(), versionId.getName(), true);
if (variantsProvidingRequestedCapabilities.isEmpty()) {
throw new NoMatchingCapabilitiesException(targetComponent, explicitRequestedCapabilities, consumableConfigurations);
}
consumableConfigurations = variantsProvidingRequestedCapabilities;
}
List matches = attributeMatcher.matches(consumableConfigurations, consumerAttributes, fallbackConfiguration, explanationBuilder);
if (matches.size() > 1) {
// there's an ambiguity, but we may have several variants matching the requested capabilities.
// Here we're going to check if in the candidates, there's a single one _strictly_ matching the requested capabilities.
List strictlyMatchingCapabilities = filterVariantsByRequestedCapabilities(targetComponent, explicitRequestedCapabilities, matches, versionId.getGroup(), versionId.getName(), false);
if (strictlyMatchingCapabilities.size() == 1) {
return singleVariant(variantsForGraphTraversal, strictlyMatchingCapabilities);
} else if (strictlyMatchingCapabilities.size() > 1) {
// there are still more than one candidate, but this time we know only a subset strictly matches the required attributes
// so we perform another round of selection on the remaining candidates
strictlyMatchingCapabilities = attributeMatcher.matches(strictlyMatchingCapabilities, consumerAttributes, fallbackConfiguration, explanationBuilder);
if (strictlyMatchingCapabilities.size() == 1) {
return singleVariant(variantsForGraphTraversal, strictlyMatchingCapabilities);
}
}
if (requestedArtifacts.size() == 1) {
// Here, we know that the user requested a specific classifier. There may be multiple
// candidate variants left, but maybe only one of them provides the classified artifact
// we're looking for.
String classifier = requestedArtifacts.get(0).getClassifier();
if (classifier != null) {
List sameClassifier = findVariantsProvidingExactlySameClassifier(matches, classifier);
if (sameClassifier != null && sameClassifier.size() == 1) {
return singleVariant(variantsForGraphTraversal, sameClassifier);
}
}
}
}
if (matches.size() == 1) {
return singleVariant(variantsForGraphTraversal, matches);
} else if (!matches.isEmpty()) {
AttributeDescriber describer = DescriberSelector.selectDescriber(consumerAttributes, consumerSchema);
if (explanationBuilder instanceof TraceDiscardedConfigurations) {
Set discarded = Cast.uncheckedCast(((TraceDiscardedConfigurations) explanationBuilder).discarded);
throw new AmbiguousConfigurationSelectionException(describer, consumerAttributes, attributeMatcher, matches, targetComponent, variantsForGraphTraversal.isPresent(), discarded);
} else {
// Perform a second resolution with tracing
return selectConfigurationUsingAttributeMatching(consumerAttributes, explicitRequestedCapabilities, targetComponent, consumerSchema, requestedArtifacts, new TraceDiscardedConfigurations());
}
} else {
AttributeDescriber describer = DescriberSelector.selectDescriber(consumerAttributes, consumerSchema);
throw new NoMatchingConfigurationSelectionException(describer, consumerAttributes, attributeMatcher, targetComponent, variantsForGraphTraversal.isPresent());
}
}
private static List findVariantsProvidingExactlySameClassifier(List matches, String classifier) {
List sameClassifier = null;
// let's see if we can find a single variant which has exactly the requested artifacts
for (ConfigurationMetadata match : matches) {
List artifacts = match.getArtifacts();
if (artifacts.size() == 1) {
ComponentArtifactMetadata componentArtifactMetadata = artifacts.get(0);
if (componentArtifactMetadata instanceof ModuleComponentArtifactMetadata) {
ArtifactIdentifier artifactIdentifier = ((ModuleComponentArtifactMetadata) componentArtifactMetadata).toArtifactIdentifier();
if (classifier.equals(artifactIdentifier.getClassifier())) {
if (sameClassifier == null) {
sameClassifier = Collections.singletonList(match);
} else {
sameClassifier = Lists.newArrayList(sameClassifier);
sameClassifier.add(match);
}
}
}
}
}
return sameClassifier;
}
private static ConfigurationMetadata singleVariant(Optional> variantsForGraphTraversal, List matches) {
ConfigurationMetadata match = matches.get(0);
if (variantsForGraphTraversal.isPresent()) {
return SelectedByVariantMatchingConfigurationMetadata.of(match);
}
return match;
}
private static ImmutableList filterVariantsByRequestedCapabilities(ComponentResolveMetadata targetComponent, Collection explicitRequestedCapabilities, Collection consumableConfigurations, String group, String name, boolean lenient) {
if (consumableConfigurations.isEmpty()) {
return ImmutableList.of();
}
ImmutableList.Builder builder = ImmutableList.builderWithExpectedSize(consumableConfigurations.size());
boolean explicitlyRequested = !explicitRequestedCapabilities.isEmpty();
for (ConfigurationMetadata configuration : consumableConfigurations) {
CapabilitiesMetadata capabilitiesMetadata = configuration.getCapabilities();
List capabilities = capabilitiesMetadata.getCapabilities();
MatchResult result;
if (explicitlyRequested) {
// some capabilities are explicitly required (in other words, we're not _necessarily_ looking for the default capability
// so we need to filter the configurations
result = providesAllCapabilities(targetComponent, explicitRequestedCapabilities, capabilities);
} else {
// we need to make sure the variants we consider provide the implicit capability
result = containsImplicitCapability(capabilitiesMetadata, capabilities, group, name);
}
if (result.matches) {
if (lenient || result == MatchResult.EXACT_MATCH) {
builder.add(configuration);
}
}
}
return builder.build();
}
private static boolean isShadowedCapabilityOnly(CapabilitiesMetadata capabilitiesMetadata) {
return capabilitiesMetadata instanceof ShadowedCapabilityOnly;
}
/**
* Determines if a producer variant provides all the requested capabilities. When doing so it does
* NOT consider capability versions, as they will be used later in the engine during conflict resolution.
*/
private static MatchResult providesAllCapabilities(ComponentResolveMetadata targetComponent, Collection explicitRequestedCapabilities, List providerCapabilities) {
if (providerCapabilities.isEmpty()) {
// producer doesn't declare anything, so we assume that it only provides the implicit capability
if (explicitRequestedCapabilities.size() == 1) {
Capability requested = explicitRequestedCapabilities.iterator().next();
ModuleVersionIdentifier mvi = targetComponent.getModuleVersionId();
if (requested.getGroup().equals(mvi.getGroup()) && requested.getName().equals(mvi.getName())) {
return MatchResult.EXACT_MATCH;
}
}
}
for (Capability requested : explicitRequestedCapabilities) {
String requestedGroup = requested.getGroup();
String requestedName = requested.getName();
boolean found = false;
for (Capability provided : providerCapabilities) {
if (provided.getGroup().equals(requestedGroup) && provided.getName().equals(requestedName)) {
found = true;
break;
}
}
if (!found) {
return MatchResult.NO_MATCH;
}
}
boolean exactMatch = explicitRequestedCapabilities.size() == providerCapabilities.size();
return exactMatch ? MatchResult.EXACT_MATCH : MatchResult.MATCHES_ALL;
}
private static MatchResult containsImplicitCapability(CapabilitiesMetadata capabilitiesMetadata, Collection capabilities, String group, String name) {
if (fastContainsImplicitCapability(capabilitiesMetadata, capabilities)) {
// An empty capability list means that it's an implicit capability only
return MatchResult.EXACT_MATCH;
}
for (Capability capability : capabilities) {
capability = unwrap(capability);
if (group.equals(capability.getGroup()) && name.equals(capability.getName())) {
boolean exactMatch = capabilities.size() == 1;
return exactMatch ? MatchResult.EXACT_MATCH : MatchResult.MATCHES_ALL;
}
}
return MatchResult.NO_MATCH;
}
private static boolean fastContainsImplicitCapability(CapabilitiesMetadata capabilitiesMetadata, Collection capabilities) {
return capabilities.isEmpty() || isShadowedCapabilityOnly(capabilitiesMetadata);
}
private static Capability unwrap(Capability capability) {
if (capability instanceof ShadowedCapability) {
return ((ShadowedCapability) capability).getShadowedCapability();
}
return capability;
}
private enum MatchResult {
NO_MATCH(false),
MATCHES_ALL(true),
EXACT_MATCH(true);
private final boolean matches;
MatchResult(boolean match) {
this.matches = match;
}
}
private static class TraceDiscardedConfigurations implements AttributeMatchingExplanationBuilder {
private final Set discarded = Sets.newHashSet();
@Override
public boolean canSkipExplanation() {
return false;
}
@Override
public void candidateDoesNotMatchAttributes(T candidate, AttributeContainerInternal requested) {
recordDiscardedCandidate(candidate);
}
public void recordDiscardedCandidate(T candidate) {
discarded.add(candidate);
}
@Override
public void candidateAttributeDoesNotMatch(T candidate, Attribute attribute, Object requestedValue, AttributeValue candidateValue) {
recordDiscardedCandidate(candidate);
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy