/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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.apache.bcel.util;

import java.io.Closeable;
import java.io.DataInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FilenameFilter;
import java.io.IOException;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Enumeration;
import java.util.List;
import java.util.Locale;
import java.util.Objects;
import java.util.StringTokenizer;
import java.util.Vector;
import java.util.zip.ZipEntry;
import java.util.zip.ZipFile;

Responsible for loading (class) files from the CLASSPATH. Inspired by sun.tools.ClassPath.
/** * Responsible for loading (class) files from the CLASSPATH. Inspired by sun.tools.ClassPath. * */
public class ClassPath implements Closeable { private abstract static class AbstractPathEntry implements Closeable { abstract ClassFile getClassFile(String name, String suffix) throws IOException; abstract URL getResource(String name); abstract InputStream getResourceAsStream(String name); } private abstract static class AbstractZip extends AbstractPathEntry { private final ZipFile zipFile; AbstractZip(final ZipFile zipFile) { this.zipFile = Objects.requireNonNull(zipFile, "zipFile"); } @Override public void close() throws IOException { if (zipFile != null) { zipFile.close(); } } @Override ClassFile getClassFile(final String name, final String suffix) throws IOException { final ZipEntry entry = zipFile.getEntry(toEntryName(name, suffix)); if (entry == null) { return null; } return new ClassFile() { @Override public String getBase() { return zipFile.getName(); } @Override public InputStream getInputStream() throws IOException { return zipFile.getInputStream(entry); } @Override public String getPath() { return entry.toString(); } @Override public long getSize() { return entry.getSize(); } @Override public long getTime() { return entry.getTime(); } }; } @Override URL getResource(final String name) { final ZipEntry entry = zipFile.getEntry(name); try { return entry != null ? new URL("jar:file:" + zipFile.getName() + "!/" + name) : null; } catch (final MalformedURLException e) { return null; } } @Override InputStream getResourceAsStream(final String name) { final ZipEntry entry = zipFile.getEntry(name); try { return entry != null ? zipFile.getInputStream(entry) : null; } catch (final IOException e) { return null; } } protected abstract String toEntryName(final String name, final String suffix); @Override public String toString() { return zipFile.getName(); } }
Contains information about file/ZIP entry of the Java class.
/** * Contains information about file/ZIP entry of the Java class. */
public interface ClassFile {
Returns:base path of found class, i.e. class is contained relative to that path, which may either denote a directory, or zip file
/** * @return base path of found class, i.e. class is contained relative to that path, which may either denote a * directory, or zip file */
String getBase();
Returns:input stream for class file.
/** * @return input stream for class file. */
InputStream getInputStream() throws IOException;
Returns:canonical path to class file.
/** * @return canonical path to class file. */
String getPath();
Returns:size of class file.
/** * @return size of class file. */
long getSize();
Returns:modification time of class file.
/** * @return modification time of class file. */
long getTime(); } private static class Dir extends AbstractPathEntry { private final String dir; Dir(final String d) { dir = d; } @Override public void close() throws IOException { // Nothing to do } @Override ClassFile getClassFile(final String name, final String suffix) throws IOException { final File file = new File(dir + File.separatorChar + name.replace('.', File.separatorChar) + suffix); return file.exists() ? new ClassFile() { @Override public String getBase() { return dir; } @Override public InputStream getInputStream() throws IOException { return new FileInputStream(file); } @Override public String getPath() { try { return file.getCanonicalPath(); } catch (final IOException e) { return null; } } @Override public long getSize() { return file.length(); } @Override public long getTime() { return file.lastModified(); } } : null; } @Override URL getResource(final String name) { // Resource specification uses '/' whatever the platform final File file = toFile(name); try { return file.exists() ? file.toURI().toURL() : null; } catch (final MalformedURLException e) { return null; } } @Override InputStream getResourceAsStream(final String name) { // Resource specification uses '/' whatever the platform final File file = toFile(name); try { return file.exists() ? new FileInputStream(file) : null; } catch (final IOException e) { return null; } } private File toFile(final String name) { return new File(dir + File.separatorChar + name.replace('/', File.separatorChar)); } @Override public String toString() { return dir; } } private static class Jar extends AbstractZip { Jar(final ZipFile zip) { super(zip); } @Override protected String toEntryName(final String name, final String suffix) { return packageToFolder(name) + suffix; } } private static class JrtModule extends AbstractPathEntry { private final Path modulePath; public JrtModule(final Path modulePath) { this.modulePath = Objects.requireNonNull(modulePath, "modulePath"); } @Override public void close() throws IOException { // Nothing to do. } @Override ClassFile getClassFile(final String name, final String suffix) throws IOException { final Path resolved = modulePath.resolve(packageToFolder(name) + suffix); if (Files.exists(resolved)) { return new ClassFile() { @Override public String getBase() { return resolved.getFileName().toString(); } @Override public InputStream getInputStream() throws IOException { return Files.newInputStream(resolved); } @Override public String getPath() { return resolved.toString(); } @Override public long getSize() { try { return Files.size(resolved); } catch (final IOException e) { return 0; } } @Override public long getTime() { try { return Files.getLastModifiedTime(resolved).toMillis(); } catch (final IOException e) { return 0; } } }; } return null; } @Override URL getResource(final String name) { final Path resovled = modulePath.resolve(name); try { return Files.exists(resovled) ? new URL("jrt:" + modulePath + "/" + name) : null; } catch (final MalformedURLException e) { return null; } } @Override InputStream getResourceAsStream(final String name) { try { return Files.newInputStream(modulePath.resolve(name)); } catch (final IOException e) { return null; } } @Override public String toString() { return modulePath.toString(); } } private static class JrtModules extends AbstractPathEntry { private final ModularRuntimeImage modularRuntimeImage; private final JrtModule[] modules; public JrtModules(final String path) throws IOException { this.modularRuntimeImage = new ModularRuntimeImage(); final List<Path> list = modularRuntimeImage.list(path); this.modules = new JrtModule[list.size()]; for (int i = 0; i < modules.length; i++) { modules[i] = new JrtModule(list.get(i)); } } @Override public void close() throws IOException { if (modules != null) { // don't use a for each loop to avoid creating an iterator for the GC to collect. for (int i = 0; i < modules.length; i++) { modules[i].close(); } } if (modularRuntimeImage != null) { modularRuntimeImage.close(); } } @Override ClassFile getClassFile(final String name, final String suffix) throws IOException { // don't use a for each loop to avoid creating an iterator for the GC to collect. for (int i = 0; i < modules.length; i++) { final ClassFile classFile = modules[i].getClassFile(name, suffix); if (classFile != null) { return classFile; } } return null; } @Override URL getResource(final String name) { // don't use a for each loop to avoid creating an iterator for the GC to collect. for (int i = 0; i < modules.length; i++) { final URL url = modules[i].getResource(name); if (url != null) { return url; } } return null; } @Override InputStream getResourceAsStream(final String name) { // don't use a for each loop to avoid creating an iterator for the GC to collect. for (int i = 0; i < modules.length; i++) { final InputStream inputStream = modules[i].getResourceAsStream(name); if (inputStream != null) { return inputStream; } } return null; } @Override public String toString() { return Arrays.toString(modules); } } private static class Module extends AbstractZip { Module(final ZipFile zip) { super(zip); } @Override protected String toEntryName(final String name, final String suffix) { return "classes/" + packageToFolder(name) + suffix; } } private static final FilenameFilter ARCHIVE_FILTER = (dir, name) -> { name = name.toLowerCase(Locale.ENGLISH); return name.endsWith(".zip") || name.endsWith(".jar"); }; private static final FilenameFilter MODULES_FILTER = (dir, name) -> { name = name.toLowerCase(Locale.ENGLISH); return name.endsWith(".jmod"); }; public static final ClassPath SYSTEM_CLASS_PATH = new ClassPath(getClassPath()); private static void addJdkModules(final String javaHome, final List<String> list) { String modulesPath = System.getProperty("java.modules.path"); if (modulesPath == null || modulesPath.trim().isEmpty()) { // Default to looking in JAVA_HOME/jmods modulesPath = javaHome + File.separator + "jmods"; } final File modulesDir = new File(modulesPath); if (modulesDir.exists()) { final String[] modules = modulesDir.list(MODULES_FILTER); for (int i = 0; i < modules.length; i++) { list.add(modulesDir.getPath() + File.separatorChar + modules[i]); } } }
Checks for class path components in the following properties: "java.class.path", "sun.boot.class.path", "java.ext.dirs"
Returns:class path as used by default by BCEL
/** * Checks for class path components in the following properties: "java.class.path", "sun.boot.class.path", * "java.ext.dirs" * * @return class path as used by default by BCEL */
// @since 6.0 no longer final public static String getClassPath() { final String classPathProp = System.getProperty("java.class.path"); final String bootClassPathProp = System.getProperty("sun.boot.class.path"); final String extDirs = System.getProperty("java.ext.dirs"); // System.out.println("java.version = " + System.getProperty("java.version")); // System.out.println("java.class.path = " + classPathProp); // System.out.println("sun.boot.class.path=" + bootClassPathProp); // System.out.println("java.ext.dirs=" + extDirs); final String javaHome = System.getProperty("java.home"); final List<String> list = new ArrayList<>(); // Starting in JRE 9, .class files are in the modules directory. Add them to the path. final Path modulesPath = Paths.get(javaHome).resolve("lib/modules"); if (Files.exists(modulesPath) && Files.isRegularFile(modulesPath)) { list.add(modulesPath.toAbsolutePath().toString()); } // Starting in JDK 9, .class files are in the jmods directory. Add them to the path. addJdkModules(javaHome, list); getPathComponents(classPathProp, list); getPathComponents(bootClassPathProp, list); final List<String> dirs = new ArrayList<>(); getPathComponents(extDirs, dirs); for (final String d : dirs) { final File ext_dir = new File(d); final String[] extensions = ext_dir.list(ARCHIVE_FILTER); if (extensions != null) { for (final String extension : extensions) { list.add(ext_dir.getPath() + File.separatorChar + extension); } } } final StringBuilder buf = new StringBuilder(); String separator = ""; for (final String path : list) { buf.append(separator); separator = File.pathSeparator; buf.append(path); } return buf.toString().intern(); } private static void getPathComponents(final String path, final List<String> list) { if (path != null) { final StringTokenizer tokenizer = new StringTokenizer(path, File.pathSeparator); while (tokenizer.hasMoreTokens()) { final String name = tokenizer.nextToken(); final File file = new File(name); if (file.exists()) { list.add(name); } } } } static String packageToFolder(final String name) { return name.replace('.', '/'); } private final String classPath; private ClassPath parent; private final AbstractPathEntry[] paths;
Search for classes in CLASSPATH.
Deprecated:Use SYSTEM_CLASS_PATH constant
/** * Search for classes in CLASSPATH. * * @deprecated Use SYSTEM_CLASS_PATH constant */
@Deprecated public ClassPath() { this(getClassPath()); } public ClassPath(final ClassPath parent, final String classPath) { this(classPath); this.parent = parent; }
Search for classes in given path.
Params:
  • classPath –
/** * Search for classes in given path. * * @param classPath */
@SuppressWarnings("resource") public ClassPath(final String classPath) { this.classPath = classPath; final List<AbstractPathEntry> list = new ArrayList<>(); for (final StringTokenizer tokenizer = new StringTokenizer(classPath, File.pathSeparator); tokenizer .hasMoreTokens();) { final String path = tokenizer.nextToken(); if (!path.isEmpty()) { final File file = new File(path); try { if (file.exists()) { if (file.isDirectory()) { list.add(new Dir(path)); } else if (path.endsWith(".jmod")) { list.add(new Module(new ZipFile(file))); } else if (path.endsWith(ModularRuntimeImage.MODULES_PATH)) { list.add(new JrtModules(ModularRuntimeImage.MODULES_PATH)); } else { list.add(new Jar(new ZipFile(file))); } } } catch (final IOException e) { if (path.endsWith(".zip") || path.endsWith(".jar")) { System.err.println("CLASSPATH component " + file + ": " + e); } } } } paths = new AbstractPathEntry[list.size()]; list.toArray(paths); } @Override public void close() throws IOException { if (paths != null) { for (final AbstractPathEntry path : paths) { path.close(); } } } @Override public boolean equals(final Object o) { if (o instanceof ClassPath) { final ClassPath cp = (ClassPath) o; return classPath.equals(cp.toString()); } return false; }
Returns:byte array for class
/** * @return byte array for class */
public byte[] getBytes(final String name) throws IOException { return getBytes(name, ".class"); }
Params:
  • name – fully qualified file name, e.g. java/lang/String
  • suffix – file name ends with suffix, e.g. .java
Returns:byte array for file on class path
/** * @param name * fully qualified file name, e.g. java/lang/String * @param suffix * file name ends with suffix, e.g. .java * @return byte array for file on class path */
public byte[] getBytes(final String name, final String suffix) throws IOException { DataInputStream dis = null; try (InputStream inputStream = getInputStream(name, suffix)) { if (inputStream == null) { throw new IOException("Couldn't find: " + name + suffix); } dis = new DataInputStream(inputStream); final byte[] bytes = new byte[inputStream.available()]; dis.readFully(bytes); return bytes; } finally { if (dis != null) { dis.close(); } } }
Params:
  • name – fully qualified class name, e.g. java.lang.String
Returns:input stream for class
/** * @param name * fully qualified class name, e.g. java.lang.String * @return input stream for class */
public ClassFile getClassFile(final String name) throws IOException { return getClassFile(name, ".class"); }
Params:
  • name – fully qualified file name, e.g. java/lang/String
  • suffix – file name ends with suff, e.g. .java
Returns:class file for the java class
/** * @param name * fully qualified file name, e.g. java/lang/String * @param suffix * file name ends with suff, e.g. .java * @return class file for the java class */
public ClassFile getClassFile(final String name, final String suffix) throws IOException { ClassFile cf = null; if (parent != null) { cf = parent.getClassFileInternal(name, suffix); } if (cf == null) { cf = getClassFileInternal(name, suffix); } if (cf != null) { return cf; } throw new IOException("Couldn't find: " + name + suffix); } private ClassFile getClassFileInternal(final String name, final String suffix) throws IOException { for (final AbstractPathEntry path : paths) { final ClassFile cf = path.getClassFile(name, suffix); if (cf != null) { return cf; } } return null; }
Params:
  • name – fully qualified class name, e.g. java.lang.String
Returns:input stream for class
/** * @param name * fully qualified class name, e.g. java.lang.String * @return input stream for class */
public InputStream getInputStream(final String name) throws IOException { return getInputStream(packageToFolder(name), ".class"); }
Return stream for class or resource on CLASSPATH.
Params:
  • name – fully qualified file name, e.g. java/lang/String
  • suffix – file name ends with suff, e.g. .java
Returns:input stream for file on class path
/** * Return stream for class or resource on CLASSPATH. * * @param name * fully qualified file name, e.g. java/lang/String * @param suffix * file name ends with suff, e.g. .java * @return input stream for file on class path */
public InputStream getInputStream(final String name, final String suffix) throws IOException { InputStream inputStream = null; try { inputStream = getClass().getClassLoader().getResourceAsStream(name + suffix); // may return null } catch (final Exception e) { // ignored } if (inputStream != null) { return inputStream; } return getClassFile(name, suffix).getInputStream(); }
Params:
  • name – name of file to search for, e.g. java/lang/String.java
Returns:full (canonical) path for file
/** * @param name * name of file to search for, e.g. java/lang/String.java * @return full (canonical) path for file */
public String getPath(String name) throws IOException { final int index = name.lastIndexOf('.'); String suffix = ""; if (index > 0) { suffix = name.substring(index); name = name.substring(0, index); } return getPath(name, suffix); }
Params:
  • name – name of file to search for, e.g. java/lang/String
  • suffix – file name suffix, e.g. .java
Returns:full (canonical) path for file, if it exists
/** * @param name * name of file to search for, e.g. java/lang/String * @param suffix * file name suffix, e.g. .java * @return full (canonical) path for file, if it exists */
public String getPath(final String name, final String suffix) throws IOException { return getClassFile(name, suffix).getPath(); }
Params:
  • name – fully qualified resource name, e.g. java/lang/String.class
Returns:URL supplying the resource, or null if no resource with that name.
Since:6.0
/** * @param name * fully qualified resource name, e.g. java/lang/String.class * @return URL supplying the resource, or null if no resource with that name. * @since 6.0 */
public URL getResource(final String name) { for (final AbstractPathEntry path : paths) { URL url; if ((url = path.getResource(name)) != null) { return url; } } return null; }
Params:
  • name – fully qualified resource name, e.g. java/lang/String.class
Returns:InputStream supplying the resource, or null if no resource with that name.
Since:6.0
/** * @param name * fully qualified resource name, e.g. java/lang/String.class * @return InputStream supplying the resource, or null if no resource with that name. * @since 6.0 */
public InputStream getResourceAsStream(final String name) { for (final AbstractPathEntry path : paths) { InputStream is; if ((is = path.getResourceAsStream(name)) != null) { return is; } } return null; }
Params:
  • name – fully qualified resource name, e.g. java/lang/String.class
Returns:An Enumeration of URLs supplying the resource, or an empty Enumeration if no resource with that name.
Since:6.0
/** * @param name * fully qualified resource name, e.g. java/lang/String.class * @return An Enumeration of URLs supplying the resource, or an empty Enumeration if no resource with that name. * @since 6.0 */
public Enumeration<URL> getResources(final String name) { final Vector<URL> results = new Vector<>(); for (final AbstractPathEntry path : paths) { URL url; if ((url = path.getResource(name)) != null) { results.add(url); } } return results.elements(); } @Override public int hashCode() { if (parent != null) { return classPath.hashCode() + parent.hashCode(); } return classPath.hashCode(); }
Returns:used class path string
/** * @return used class path string */
@Override public String toString() { if (parent != null) { return parent + File.pathSeparator + classPath; } return classPath; } }