Package com.google.common.reflect

Class ClassPath

java.lang.Object

com.google.common.reflect.ClassPath

@Beta
public final class ClassPath
extends Object

Scans the source of a ClassLoader and finds all loadable classes and resources.

Prefer ClassGraph over ClassPath

We recommend using ClassGraph instead of ClassPath. ClassGraph improves upon ClassPath in several ways, including addressing many of its limitations. Limitations of ClassPath include:

• It looks only for files and JARs in URLs available from URLClassLoader instances or the system class loader. This means it does not look for classes in the module path.
• It understands only file: URLs. This means that it does not understand jrt:/ URLs, among others.
• It does not know how to look for classes when running under an Android VM. (ClassGraph does not support this directly, either, but ClassGraph documents how to perform build-time classpath scanning and make the results available to an Android app.)
• Like all of Guava, it is not tested under Windows. We have gotten a report of a specific bug under Windows.
• It returns only one resource for a given path, even if resources with that path appear in multiple jars or directories.
• It assumes that any class with a $ in its name is a nested class.

ClassPath and symlinks

In the case of directory classloaders, symlinks are supported but cycles are not traversed. This guarantees discovery of each unique loadable resource. However, not all possible aliases for resources on cyclic paths will be listed.

Since:

14.0

Author:

Ben Yu

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClassPath.ClassInfo	Represents a class that can be loaded through ClassPath.ClassInfo.load().
static class	ClassPath.ResourceInfo	Represents a class path resource that can be either a class file or any other resource file loadable from the class path.

Method Summary

Modifier and Type	Method	Description
static ClassPath	from(ClassLoader classloader)	Returns a ClassPath representing all classes and resources loadable from classloader and its ancestor class loaders.
ImmutableSet<ClassPath.ClassInfo>	getAllClasses()	Returns all classes loadable from the current class path.
ImmutableSet<ClassPath.ResourceInfo>	getResources()	Returns all resources loadable from the current class path, including the class files of all loadable classes but excluding the "META-INF/MANIFEST.MF" file.
ImmutableSet<ClassPath.ClassInfo>	getTopLevelClasses()	Returns all top level classes loadable from the current class path.
ImmutableSet<ClassPath.ClassInfo>	getTopLevelClasses(String packageName)	Returns all top level classes whose package name is packageName.
ImmutableSet<ClassPath.ClassInfo>	getTopLevelClassesRecursive(String packageName)	Returns all top level classes whose package name is packageName or starts with packageName followed by a '.'.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

from

public static ClassPath from(ClassLoader classloader)
                      throws IOException

Returns a ClassPath representing all classes and resources loadable from classloader and its ancestor class loaders.

Warning: ClassPath can find classes and resources only from:

• URLClassLoader instances' file: URLs
• the system class loader. To search the system class loader even when it is not a URLClassLoader (as in Java 9), ClassPath searches the files from the java.class.path system property.

Throws:

IOException - if the attempt to read class path resources (jar files or directories) failed.

getResources

public ImmutableSet<ClassPath.ResourceInfo> getResources()

Returns all resources loadable from the current class path, including the class files of all loadable classes but excluding the "META-INF/MANIFEST.MF" file.

getAllClasses

public ImmutableSet<ClassPath.ClassInfo> getAllClasses()

Returns all classes loadable from the current class path.

Since:

16.0

getTopLevelClasses

public ImmutableSet<ClassPath.ClassInfo> getTopLevelClasses()

Returns all top level classes loadable from the current class path. Note that "top-level-ness" is determined heuristically by class name (see ClassPath.ClassInfo.isTopLevel()).

getTopLevelClasses

public ImmutableSet<ClassPath.ClassInfo> getTopLevelClasses(String packageName)

Returns all top level classes whose package name is packageName.

getTopLevelClassesRecursive

public ImmutableSet<ClassPath.ClassInfo> getTopLevelClassesRecursive(String packageName)

Returns all top level classes whose package name is packageName or starts with packageName followed by a '.'.