Maven 项目中读取 ZIP 依赖内文件的实用指南

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>3.6.1</version> <!-- 建议使用最新稳定版本 -->
            <executions>
                <execution>
                    <id>unpack-zip-artifacts</id>
                    <goals>
                        <goal>unpack-dependencies</goal>
                    </goals>
                    <phase>generate-resources</phase>
                    <configuration>
                        <!-- 指定解压后的输出目录，这里将其放置在 classes 目录下，确保其进入类路径 -->
                        <outputDirectory>${project.build.directory}/classes/zip-resources</outputDirectory>
                        <!-- 仅解压类型为 'zip' 的依赖 -->
                        <includeTypes>zip</includeTypes>
                        <!-- 如果需要指定具体某个依赖，可以使用 <includeGroupIds> 和 <includeArtifactIds> -->
                        <!-- <includeGroupIds>org.foo</includeGroupIds> -->
                        <!-- <includeArtifactIds>myComponent</includeArtifactIds> -->
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

import java.io.InputStream;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.util.Objects;

public class ZipResourceReader {

    public String readJsonFromZipDependency() {
        // 注意路径前缀，需要与 outputDirectory 配置中的 'zip-resources' 对应
        // 且路径应以 '/' 开头，表示从类路径根目录开始
        String resourcePath = "/zip-resources/myFolder/myFile.json";
        StringBuilder contentBuilder = new StringBuilder();

        try (InputStream is = getClass().getResourceAsStream(resourcePath)) {
            if (is == null) {
                System.err.println("Resource not found: " + resourcePath);
                return null;
            }
            // 使用 try-with-resources 确保 InputStream 被正确关闭
            // 推荐使用 InputStream.readAllBytes() 或 BufferedReader 读取内容
            byte[] bytes = is.readAllBytes();
            contentBuilder.append(new String(bytes, StandardCharsets.UTF_8));
        } catch (IOException e) {
            System.err.println("Error reading resource: " + resourcePath);
            e.printStackTrace();
        }
        return contentBuilder.toString();
    }

    public static void main(String[] args) {
        ZipResourceReader reader = new ZipResourceReader();
        String jsonContent = reader.readJsonFromZipDependency();
        if (jsonContent != null) {
            System.out.println("JSON Content:\n" + jsonContent);
            // 这里可以进一步解析 JSON 字符串
        }
    }
}