在Maven项目中优雅地读取ZIP依赖中的JSON文件

<dependency>
    <groupId>org.foo</groupId>
    <artifactId>myComponent</artifactId>
    <version>1.0</version>
    <type>zip</type>
    <scope>compile</scope>
    <exclusions>
        <exclusion>
            <groupId>*</groupId>
            <artifactId>*</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<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>
                        <!-- 将ZIP内容解压到 target/classes/zip-resources 目录下 -->
                        <outputDirectory>${project.build.directory}/classes/zip-resources</outputDirectory>
                        <!-- 仅处理类型为 zip 的依赖 -->
                        <includeTypes>zip</includeTypes>
                        <!-- 如果有多个ZIP依赖，或者只想解压特定的ZIP，可以使用以下配置： -->
                        <!-- <includeArtifactIds>myComponent</includeArtifactIds> -->
                        <!-- <excludeTransitive>true</excludeTransitive> -->
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.BufferedReader;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

public class ZipResourceReader {

    /**
     * 从解压后的ZIP依赖中读取JSON文件内容。
     * 假设ZIP文件内的结构是 myFolder/myFile.json，
     * 且Maven插件将ZIP内容解压到了 target/classes/zip-resources 目录下。
     *
     * @return JSON文件的字符串内容，如果读取失败则返回null。
     */
    public String readJsonFromZipDependency() {
        // 注意资源路径前缀，它对应于 Maven 插件配置中 outputDirectory 定义的子目录
        String resourcePath = "/zip-resources/myFolder/myFile.json";
        StringBuilder contentBuilder = new StringBuilder();

        try (InputStream inputStream = getClass().getResourceAsStream(resourcePath)) {
            if (inputStream == null) {
                System.err.println("错误：未找到资源文件: " + resourcePath + "。请检查Maven配置和文件路径。");
                return null;
            }
            // 使用 UTF-8 编码读取文件内容
            try (BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream, StandardCharsets.UTF_8))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    contentBuilder.append(line).append("\n");
                }
            }
        } catch (IOException e) {
            System.err.println("读取JSON文件时发生IO错误: " + e.getMessage());
            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内容:\n" + jsonContent);
            // 在此处，您可以使用Jackson、Gson等JSON库来解析 jsonContent
            // 例如：
            // ObjectMapper mapper = new ObjectMapper();
            // MyDataObject data = mapper.readValue(jsonContent, MyDataObject.class);
            // System.out.println("解析后的数据: " + data);
        } else {
            System.out.println("未能读取JSON内容。");
        }
    }
}