首页 > 编程语言 >从JAR文件读取指定目录下所有JSON文件的方法

从JAR文件读取指定目录下所有JSON文件的方法

来源：互联网 2026-07-14 08:06:05

Java应用中，JAR包内的资源无法通过传统java.io.File直接访问。可借助JavaNIO.2的FileSystemAPI将JAR挂载为虚拟文件系统，利用Path和DirectoryStream安全高效地枚举并读取指定目录下的所有文件，例如JSON文件。需注意路径格式、协议校验及资源及时关闭。

本文介绍如何正确访问 jar 包内嵌目录（如 postman/）并遍历其中所有文件，重点解决 file 对象无法直接映射 jar 内路径的问题，推荐使用 Java 7+ 的 FileSystem API 安全高效地完成资源枚举与读取。

在 Java 应用里，资源被打包进 JAR 文件后，传统基于 java.io.File 的路径操作就彻底失效了——JAR 内的目录并不是真实文件系统里的目录，它只是 ZIP 归档结构中的逻辑路径。你可能遇到过这样的场景：myFolder.exists() && myFolder.isDirectory() 返回 false，原因很简单——new File(...) 试图把 jar:file:/xxx.jar!/postman 这类 URL 解析成本地磁盘路径，可操作系统里压根不存在这么个路径。

正确的做法是什么呢？利用 Java NIO.2 的 FileSystem API 把 JAR 文件挂载成虚拟文件系统，然后通过 Path 和 DirectoryStream 安全地遍历内部目录。下面是一套完整、可复用的实现方案：

长期稳定更新的攒劲资源： >>>点此立即查看<<<

import java.io.IOException;
import java.net.URI;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.HashMap;
import java.util.Map;
import java.util.stream.Collectors;

public class JarResourceReader {
    /**
     * 从 JAR 中读取指定目录下所有匹配模式的文件（如 *.json）
     * @param jarResourcePath 类路径下的 JAR 资源路径（如 "/postman"）
     * @param filePattern 文件匹配模式（如 "*.json"），支持 glob 语法
     */
    public static void listFilesInJarFolder(String jarResourcePath, String filePattern) {
        // 1. 获取 JAR 文件的绝对 URL（注意：必须是 jar:file: 协议）
        var url = JarResourceReader.class.getResource(jarResourcePath);
        if (url == null || !url.getProtocol().equals("jar")) {
            throw new IllegalArgumentException("Resource not found or not in JAR: " + jarResourcePath);
        }
        try {
            // 2. 构建 JAR 文件 URI（提取 jar:file:... 部分）
            URI jarUri = URI.create(url.toString().split("!")[0]);
            // 3. 创建只读 FileSystem（避免创建临时文件系统）
            Map env = new HashMap<>();
            env.put("create", "false"); // 关键：设为 false，避免意外写入
            try (FileSystem jarFs = FileSystems.newFileSystem(jarUri, env)) {
                // 4. 定位到目标目录（注意：路径以 / 开头，且需与 JAR 内实际结构一致）
                Path targetDir = jarFs.getPath("/postman"); //  确保与 JAR 内路径完全匹配
                // 5. 遍历并处理文件
                try (DirectoryStream stream = Files.newDirectoryStream(targetDir, filePattern)) {
                    for (Path path : stream) {
                        if (Files.isRegularFile(path)) {
                            System.out.println("Found file: " + path);
                            // 示例：读取 JSON 内容
                            String content = Files.readString(path);
                            System.out.println("Content length: " + content.length());
                        }
                    }
                }
            }
        } catch (IOException e) {
            throw new RuntimeException("Failed to read resources from JAR", e);
        }
    }

    // 使用示例
    public static void main(String[] args) {
        listFilesInJarFolder("/postman", "*.json");
    }
}

这里有几个关键点值得留意：

路径格式必须准确：jarFs.getPath("/postman") 中的 /postman 是 JAR 内的绝对路径（根为 JAR 包顶层），不能写成 "postman" 或 "./postman"；
协议校验不可省略：确保 getResource() 返回的是 jar: 协议 URL，否则 FileSystems.newFileSystem() 会抛出异常；
及时关闭资源：FileSystem 和 DirectoryStream 都需要显式关闭（推荐 try-with-resources）；
别再用 File 构造：JAR 内路径永远无法转换成有效的 java.io.File 实例，这是设计限制，不是 bug；
如果 JAR 来源不可信，建议对 jarUri 做白名单校验，防止路径穿越或恶意 URI 注入。