*
 * @implSpec Extending types should be immutable data classes with no nullable fields, they
 * must also be serializable by the configuration cache.
 */
public interface ResolutionFailure {
    /**
     * Returns a human-readable name of the requested component or configuration, for use
     * primarily in error messages.
     *
     * @return the name of the requested component or configuration

 * limitations under the License.
 */

package org.gradle.internal.component.resolution.failure.exception;

import org.gradle.internal.component.resolution.failure.type.ResolutionFailure;

import java.util.List;

/**
 * Represents a failure during variant selection when a named {@link org.gradle.api.artifacts.Configuration Configuration}
 * cannot be selected
 */

        this.resolutionFailure = resolutionFailure;
    }

    @Override
    public boolean hasAnyFailure() {
        return !unresolvedDependencies.isEmpty() || resolutionFailure != null;
    }

    @Override
    public void visitFailures(Consumer<Throwable> visitor) {
        for (UnresolvedDependency unresolvedDependency : unresolvedDependencies) {
            visitor.accept(unresolvedDependency.getProblem());
        }

    private final ImmutableList<String> resolutions;
    private final ResolutionFailure failure;

    public AbstractResolutionFailureException(String message, ResolutionFailure failure, List<String> resolutions) {
        this(message, failure, resolutions, null);
    }

    public AbstractResolutionFailureException(String message, ResolutionFailure failure, List<String> resolutions, @Nullable Throwable cause) {

    public ArtifactVariantSelectionException(String message, ResolutionFailure failure, List<String> resolutions) {
        super(message, failure, resolutions);
    }

    public ArtifactVariantSelectionException(String message, ResolutionFailure failure, List<String> resolutions, Throwable cause) {
        super(message, failure, resolutions, cause);
    }

/**
 * An ordered registry of {@link ResolutionFailureDescriber} instances that can be queried
 * by the {@link ResolutionFailure} type they can describe.
 */
public final class ResolutionFailureDescriberRegistry {
    private final InstanceGenerator instanceGenerator;
    private final LinkedHashMap<Class<? extends ResolutionFailure>, List<ResolutionFailureDescriber<?>>> describers = new LinkedHashMap<>();

 * limitations under the License.
 */

package org.gradle.api.internal.attributes;

import org.gradle.api.attributes.Attribute;
import org.gradle.internal.component.resolution.failure.type.ResolutionFailure;
import org.gradle.internal.component.model.AttributeMatcher;
import org.gradle.internal.component.resolution.failure.describer.ResolutionFailureDescriber;

import javax.annotation.Nullable;
import java.util.List;

     * for the given failure.
     *
     * @param failure the failure to describe
     * @param schema the schema of the attributes that were used to select the variant, if available
     * @return the exception that describes the failure
     *
     * @implSpec Testing {@link #canDescribeFailure(ResolutionFailure)} should <strong>NOT</strong> be done by

 */

package org.gradle.internal.component.resolution.failure.type;

/**
 * An abstract {@link ResolutionFailure} that represents the situation when a requested variant has attributes
 * that are not compatible with any of the available variants.
 */
public abstract class AbstractVariantSelectionFailure implements ResolutionFailure {
    private final String requestedName;

    public AbstractVariantSelectionFailure(String requestedName) {

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * This package contains {@link org.gradle.internal.component.resolution.failure.type.ResolutionFailure ResolutionFailure}s types
 * that exist to categorize types of failure conditions that can occur during dependency resolution and package contexual information
 * specific to each type of failure.
 */
@org.gradle.api.NonNullApi