Java如何实现获取指定包名下所有文件列表的方法？

核心逻辑是先将点分隔的包名转换为类加载器可识别的相对路径，遍历路径下的所有资源，同时兼容本地文件系统、jar包内资源两种部署场景，过滤子目录后返回文件名列表。

通用无框架依赖实现 #

该实现不依赖任何第三方库，适配所有Java运行环境：

import java.io.File;
import java.io.IOException;
import java.net.JarURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Enumeration;
import java.util.List;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;

public List<String> getContents(String packageName) throws IOException {
    List<String> fileNames = new ArrayList<>();
    // 包名转类路径格式
    String packagePath = packageName.replace('.', '/');
    // 获取当前线程上下文类加载器，避免不同类加载器导致的资源找不到问题
    Enumeration<URL> resources = Thread.currentThread().getContextClassLoader().getResources(packagePath);

    while (resources.hasMoreElements()) {
        URL resource = resources.nextElement();
        String protocol = resource.getProtocol();
        if ("file".equals(protocol)) {
            // 处理本地文件系统目录：IDE运行、解压部署场景
            String dirPath = URLDecoder.decode(resource.getFile(), StandardCharsets.UTF_8);
            File dir = new File(dirPath);
            if (!dir.exists() || !dir.isDirectory()) {
                continue;
            }
            // 仅收集目录下的文件，过滤子目录
            File[] files = dir.listFiles(File::isFile);
            if (files != null) {
                for (File file : files) {
                    fileNames.add(file.getName());
                }
            }
        } else if ("jar".equals(protocol)) {
            // 处理jar包内资源：SpringBoot fatjar、依赖jar包场景
            JarURLConnection jarConn = (JarURLConnection) resource.openConnection();
            try (JarFile jarFile = jarConn.getJarFile()) {
                Enumeration<JarEntry> entries = jarFile.entries();
                String entryBase = packagePath + "/";
                while (entries.hasMoreElements()) {
                    JarEntry entry = entries.nextElement();
                    String entryName = entry.getName();
                    // 只保留当前包层级的文件，排除子包、目录项
                    if (entryName.startsWith(entryBase)
                            && !entry.isDirectory()
                            && entryName.indexOf('/', entryBase.length()) == -1) {
                        fileNames.add(entryName.substring(entryBase.length()));
                    }
                }
            }
        }
    }
    return fileNames;
}

实现要点 #

• 路径转换：统一将包名的.替换为/，符合类路径资源的寻址规范
• 类加载器选择：使用线程上下文类加载器加载资源，避免Web容器、模块化环境下的资源寻址失败问题
• 多场景兼容：同时支持本地文件、jar包内资源两种常见部署形式，不会出现本地运行正常、打包后扫不到文件的问题
• 过滤规则：严格限定只返回当前包层级下的文件，自动跳过子目录、子包内的内容
• 编码兼容：对路径做UTF-8解码，避免路径包含中文、特殊字符时出现乱码错误

Spring环境简化实现 #

如果是Spring/SpringBoot项目，可以直接用框架内置的资源解析工具，不用手动处理jar包遍历逻辑，代码更简洁：

import org.springframework.core.io.Resource;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public List<String> getContents(String packageName) throws IOException {
    List<String> fileNames = new ArrayList<>();
    String pattern = "classpath*:" + packageName.replace('.', '/') + "/*";
    Resource[] resources = new PathMatchingResourcePatternResolver().getResources(pattern);
    for (Resource res : resources) {
        if (res.isFile()) {
            fileNames.add(res.getFilename());
        }
    }
    return fileNames;
}

注意该方案需要依赖Spring核心包，非Spring项目不建议使用。

内容的提问来源于stack exchange，提问作者Abhishek Ranjan