/* * Copyright (C) 2008 The Android Open Source Project * * 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. */ import java.io.File; import java.io.IOException; import java.io.BufferedReader; import java.io.FileReader; import java.nio.file.Files; import java.nio.file.Path; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.List; import java.util.Set; import java.util.TreeSet; import java.util.SortedSet; import java.util.regex.Pattern; /** * Immutable representation of an IDE configuration. Assumes that the current * directory is the project's root directory. */ public class Configuration { /** Java source tree roots. */ public final SortedSet sourceRoots; /** Found .jar files (that weren't excluded). */ public final List jarFiles; /** Excluded directories which may or may not be under a source root. */ public final SortedSet excludedDirs; /** The root directory for this tool. */ public final File toolDirectory; /** File name used for excluded path files. */ private static final String EXCLUDED_PATHS = "excluded-paths"; /** The vendor directory. */ private static final String VENDOR_PATH = "./vendor/"; /** * Constructs a Configuration by traversing the directory tree, looking * for .java and .jar files and identifying source roots. */ public Configuration() throws IOException { this.toolDirectory = new File("development/tools/idegen"); if (!toolDirectory.isDirectory()) { // The wrapper script should have already verified this. throw new AssertionError("Not in root directory."); } Stopwatch stopwatch = new Stopwatch(); Excludes excludes = readExcludes(); stopwatch.reset("Read excludes"); List jarFiles = new ArrayList(500); SortedSet excludedDirs = new TreeSet(); SortedSet sourceRoots = new TreeSet(); traverse(new File("."), sourceRoots, jarFiles, excludedDirs, excludes); stopwatch.reset("Traversed tree"); Log.debug(sourceRoots.size() + " source roots"); Log.debug(jarFiles.size() + " jar files"); Log.debug(excludedDirs.size() + " excluded dirs"); this.sourceRoots = Collections.unmodifiableSortedSet(sourceRoots); this.jarFiles = Collections.unmodifiableList(jarFiles); this.excludedDirs = Collections.unmodifiableSortedSet(excludedDirs); } /** * Reads excluded path files. */ private Excludes readExcludes() throws IOException { List patterns = new ArrayList(); File globalExcludes = new File(toolDirectory, EXCLUDED_PATHS); parseFile(globalExcludes, patterns); // Traverse all vendor-specific directories readVendorExcludes(patterns); // Look for user-specific excluded-paths file in current directory. File localExcludes = new File(EXCLUDED_PATHS); if (localExcludes.exists()) { parseFile(localExcludes, patterns); } return new Excludes(patterns); } /** * Reads vendor excluded path files. * @see #readExcludes() */ private static void readVendorExcludes(List out) throws IOException { File vendorDir = new File(VENDOR_PATH); File[] vendorList; if (!vendorDir.exists() || (vendorList = vendorDir.listFiles()) == null) return; for (File vendor : vendorList) { File vendorExcludes = new File(vendor, EXCLUDED_PATHS); if (vendorExcludes.exists()) { Log.info("Read vendor excludes: " + vendorExcludes.getPath()); parseFile(vendorExcludes, out); } } } /** * Recursively finds .java source roots, .jar files, and excluded * directories. */ private static void traverse(File directory, Set sourceRoots, Collection jarFiles, Collection excludedDirs, Excludes excludes) throws IOException { /* * Note it would be faster to stop traversing a source root as soon as * we encounter the first .java file, but it appears we have nested * source roots in our generated source directory (specifically, * R.java files and aidl .java files don't share the same source * root). */ boolean firstJavaFile = true; File[] files = directory.listFiles(); if (files == null) { return; } for (File file : files) { // Trim preceding "./" from path. String path = file.getPath().substring(2); // Skip nonexistent files/diretories, e.g. broken symlinks. if (!file.exists()) { Log.debug("Skipped nonexistent: " + path); continue; } if (Files.isSymbolicLink(file.toPath())) { Path target = Files.readSymbolicLink(file.toPath()).normalize(); if (target.startsWith("") || target.startsWith(".") || target.startsWith("..")) { // Don't recurse symbolic link that targets to parent // or current directory. Log.debug("Skipped: " + path); continue; } } if (file.isDirectory()) { // Traverse nested directories. if (excludes.exclude(path)) { // Don't recurse into excluded dirs. Log.debug("Excluding: " + path); excludedDirs.add(file); } else { traverse(file, sourceRoots, jarFiles, excludedDirs, excludes); } } else if (path.endsWith(".java")) { // Keep track of source roots for .java files. // Do not check excludes in this branch. if (firstJavaFile) { // Only parse one .java file per directory. firstJavaFile = false; File sourceRoot = rootOf(file); if (sourceRoot != null) { sourceRoots.add(sourceRoot); } } } else if (path.endsWith(".jar")) { // Keep track of .jar files. if (excludes.exclude(path)) { Log.debug("Skipped: " + file); } else { jarFiles.add(file); } } } } /** * Determines the source root for a given .java file. Returns null * if the file doesn't have a package or if the file isn't in the * correct directory structure. */ private static File rootOf(File javaFile) throws IOException { String packageName = parsePackageName(javaFile); if (packageName == null) { // No package. // TODO: Treat this as a source root? return null; } String packagePath = packageName.replace('.', File.separatorChar); File parent = javaFile.getParentFile(); String parentPath = parent.getPath(); if (!parentPath.endsWith(packagePath)) { // Bad dir structure. return null; } return new File(parentPath.substring( 0, parentPath.length() - packagePath.length())); } /** * Reads a Java file and parses out the package name. Returns null if none * found. */ private static String parsePackageName(File file) throws IOException { try (BufferedReader in = new BufferedReader(new FileReader(file))) { String line; while ((line = in.readLine()) != null) { String trimmed = line.trim(); if (trimmed.startsWith("package")) { // TODO: Make this more robust. // Assumes there's only once space after "package" and the // line ends in a ";". return trimmed.substring(8, trimmed.length() - 1); } } return null; } } /** * Picks out excluded directories that are under source roots. */ public SortedSet excludesUnderSourceRoots() { // TODO: Refactor this to share the similar logic in // Eclipse.constructExcluding(). SortedSet picked = new TreeSet(); for (File sourceRoot : sourceRoots) { String sourcePath = sourceRoot.getPath() + "/"; SortedSet tailSet = excludedDirs.tailSet(sourceRoot); for (File file : tailSet) { if (file.getPath().startsWith(sourcePath)) { picked.add(file); } else { break; } } } return picked; } /** * Reads a list of regular expressions from a file, one per line, and adds * the compiled patterns to the given collection. Ignores lines starting * with '#'. * * @param file containing regular expressions, one per line * @param patterns collection to add compiled patterns from file to */ public static void parseFile(File file, Collection patterns) throws IOException { try (BufferedReader in = new BufferedReader(new FileReader(file))) { String line; while ((line = in.readLine()) != null) { String trimmed = line.trim(); if (trimmed.length() > 0 && !trimmed.startsWith("#")) { patterns.add(Pattern.compile(trimmed)); } } } } }