当前位置：首页 > Java

java 如何扫描package

2026-03-22 00:57:17Java

扫描 Java 包的方法

在 Java 中扫描指定包下的类通常需要使用反射和类加载机制。以下是几种常见的方法：

使用 ClassLoader 扫描包

通过 ClassLoader 获取包下的所有类资源路径，然后筛选出符合条件的类。

public static List<Class<?>> scanPackage(String packageName) throws IOException {
    ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
    String path = packageName.replace('.', '/');
    Enumeration<URL> resources = classLoader.getResources(path);
    List<Class<?>> classes = new ArrayList<>();
    while (resources.hasMoreElements()) {
        URL resource = resources.nextElement();
        if (resource.getProtocol().equals("file")) {
            classes.addAll(findClasses(new File(resource.getFile()), packageName));
        }
    }
    return classes;
}

private static List<Class<?>> findClasses(File directory, String packageName) {
    List<Class<?>> classes = new ArrayList<>();
    if (!directory.exists()) {
        return classes;
    }
    File[] files = directory.listFiles();
    for (File file : files) {
        if (file.isDirectory()) {
            classes.addAll(findClasses(file, packageName + "." + file.getName()));
        } else if (file.getName().endsWith(".class")) {
            String className = packageName + '.' + file.getName().substring(0, file.getName().length() - 6);
            try {
                classes.add(Class.forName(className));
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            }
        }
    }
    return classes;
}

使用 Reflections 库

Reflections 是一个专门用于扫描类路径的第三方库，简化了操作。

Reflections reflections = new Reflections("com.example.package");
Set<Class<?>> classes = reflections.getSubTypesOf(Object.class);

使用 Spring 的 ClassPathScanningCandidateComponentProvider

如果项目基于 Spring 框架，可以使用其内置的类扫描工具。

ClassPathScanningCandidateComponentProvider scanner = 
    new ClassPathScanningCandidateComponentProvider(false);
scanner.addIncludeFilter(new AnnotationTypeFilter(Component.class));
Set<BeanDefinition> components = scanner.findCandidateComponents("com.example.package");
for (BeanDefinition component : components) {
    Class<?> clazz = Class.forName(component.getBeanClassName());
}

使用 Java 9+ 的 Module API

在 Java 9 及以上版本，可以通过 Module 和 ModuleLayer 进行更高效的类扫描。

java 如何扫描package

ModuleLayer.boot().modules().forEach(module -> {
    try {
        Class<?> clazz = Class.forName(module, "com.example.package.ClassName");
    } catch (ClassNotFoundException e) {
        e.printStackTrace();
    }
});