com.google.cloud.tools.opensource.classpath.ClassPathResult Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of dependencies Show documentation
A library for analyzing Maven artifact dependency graphs
The newest version!
/*
 * Copyright 2020 Google LLC.
 *
 * 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 com.google.cloud.tools.opensource.classpath;


import com.google.cloud.tools.opensource.dependencies.Artifacts;
import com.google.cloud.tools.opensource.dependencies.DependencyPath;
import com.google.cloud.tools.opensource.dependencies.UnresolvableArtifactProblem;
import com.google.common.collect.ImmutableList;
import com.google.common.collect.ImmutableSet;
import java.io.IOException;
import java.util.logging.Logger;
import org.eclipse.aether.artifact.Artifact;

/** Result of class path resolution with {@link UnresolvableArtifactProblem}s if any. */
public final class ClassPathResult {
  private static final Logger logger = Logger.getLogger(ClassPathResult.class.getName());

  private final ImmutableList classPath;

  private final AnnotatedClassPath annotatedClassPath;

  private final ImmutableList artifactProblems;

  public ClassPathResult(
      AnnotatedClassPath dependencyPaths, Iterable artifactProblems) {
    this.annotatedClassPath = dependencyPaths;
    this.classPath = dependencyPaths.getClassPath();
    this.artifactProblems = ImmutableList.copyOf(artifactProblems);
  }

  /** Returns the resolved class path. */
  public ImmutableList getClassPath() {
    return classPath;
  }

  /**
   * Returns all paths to the class path entry or 
   * an empty list if the entry is not in the class path.
   */
  public ImmutableList getDependencyPaths(ClassPathEntry entry) {
    return annotatedClassPath.pathsTo(entry);
  }

  /** Returns problems encountered while constructing the dependency graph. */
  public ImmutableList getArtifactProblems() {
    return artifactProblems;
  }

  /** Returns text describing dependency paths to class path entries in the dependency tree. */
  public String formatDependencyPaths(Iterable entries) {
    StringBuilder message = new StringBuilder();
    for (ClassPathEntry entry : entries) {
      ImmutableList dependencyPaths = getDependencyPaths(entry);

      if (dependencyPaths.isEmpty()) {
        logger.warning(entry + " is not in the class path");
        continue;
      }

      message.append(entry + " is at:\n");

      int otherCount = dependencyPaths.size() - 1;
      message.append("  " + dependencyPaths.get(0) + "\n");
      if (otherCount == 1) {
        message.append("  and 1 dependency path.\n");
      } else if (otherCount > 1) {
        message.append("  and " + otherCount + " other dependency paths.\n");
      }
    }
    return message.toString();
  }
  
  /**
   * Returns the classpath entries for the transitive dependencies of the specified
   * artifact.
   */
  public ImmutableSet getClassPathEntries(String coordinates) {
    ImmutableSet.Builder builder = ImmutableSet.builder();
    for (ClassPathEntry entry : classPath) {
      for (DependencyPath dependencyPath : annotatedClassPath.pathsTo(entry)) {
        if (dependencyPath.size() > 1) {
          Artifact artifact = dependencyPath.get(1);
          if (Artifacts.toCoordinates(artifact).equals(coordinates)) {
            builder.add(entry);
          }
        }
      }
    }
    return builder.build();
  }

  /**
   * Returns the class path entry for the artifact that matches {@code groupId} and {@code
   * artifactId}. {@code Null} if no matching artifact is found.
   */
  ClassPathEntry findEntryById(String groupId, String artifactId) {
    for (ClassPathEntry entry : getClassPath()) {
      Artifact artifact = entry.getArtifact();
      if (artifact.getGroupId().equals(groupId) && artifact.getArtifactId().equals(artifactId)) {
        return entry;
      }
    }
    return null;
  }

  /**
   * Returns the class path entry that contains the class of {@code symbol}. {@code Null} if no
   * matching entry is found.
   */
  ClassPathEntry findEntryBySymbol(Symbol symbol) throws IOException {
    String className = symbol.getClassBinaryName();
    for (ClassPathEntry entry : getClassPath()) {
      if (entry.getFileNames().contains(className)) {
        return entry;
      }
    }
    return null;
  }
}