Maven多模块项目中资源共享与配置管理指南

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>com.company.project</groupId>
        <artifactId>project</artifactId>
        <version>${project.version}</version>
    </parent>

    <artifactId>project-algo</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <!-- 依赖 project-base 模块 -->
        <dependency>
            <groupId>com.company.project</groupId>
            <artifactId>project-base</artifactId>
            <version>${project.version}</version>
        </dependency>

        <!-- 新增：依赖 project-config 模块 -->
        <dependency>
            <groupId>com.company.project</groupId>
            <artifactId>project-config</artifactId>
            <version>${project.version}</version>
            <!-- 建议使用 test 范围，如果该配置只用于测试 -->
            <scope>test</scope> 
        </dependency>

        <!-- 其他依赖... -->
    </dependencies>
</project>

project-config
├── pom.xml
└── src
    └── main
        └── resources
            └── application_config.yaml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>com.company.project</groupId>
        <artifactId>project</artifactId>
        <version>${project.version}</version>
    </parent>

    <artifactId>project-config</artifactId>
    <packaging>jar</packaging>

    <build>
        <resources>
            <!-- 默认资源目录 -->
            <resource>
                <directory>src/main/resources</directory>
            </resource>
            <!-- 将 configs 目录也作为资源目录 -->
            <resource>
                <directory>configs</directory>
                <includes>
                    <include>**/*.yaml</include>
                </includes>
                <!-- targetPath 可以指定资源在 JAR 包中的路径，默认为根目录 -->
                <targetPath>.</targetPath> 
            </resource>
        </resources>
        <plugins>
            <!-- 其他插件 -->
        </plugins>
    </build>
    <!-- 其他配置 -->
</project>

package com.company.project.util.io;

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper; // 泛化，如果YamlReader也用于JSON
import com.fasterxml.jackson.dataformat.yaml.YAMLMapper;
import java.io.IOException;
import java.io.InputStream;

public class YamlReader {

    // 假设 ConfigParent 是一个通用的父接口或类
    // public interface ConfigParent {} 

    public static <C extends ConfigParent> C readConfiguration(Class<C> configClass, String yamlFileName) throws IOException {
        InputStream inputStream = null;
        try {
            // 使用当前类的类加载器来获取资源
            // 资源路径是相对于类路径根目录的
            // 如果 application_config.yaml 在 src/main/resources 下，直接使用文件名
            // 如果在 project-config/configs 下并通过 pom 配置为资源，也直接使用文件名
            inputStream = YamlReader.class.getClassLoader().getResourceAsStream(yamlFileName);

            if (inputStream == null) {
                // 尝试使用线程上下文类加载器，有时在某些环境中更可靠
                inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream(yamlFileName);
            }

            if (inputStream == null) {
                throw new IOException("Resource not found on classpath: " + yamlFileName);
            }

            YAMLMapper mapper = new YAMLMapper();
            mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
            mapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);

            return mapper.readValue(inputStream, configClass);
        } finally {
            if (inputStream != null) {
                inputStream.close();
            }
        }
    }

    // 示例用法（在 AlgorithmTest 中）
    // public void testReadConfig() {
    //     try {
    //         MyConfig config = YamlReader.readConfiguration(MyConfig.class, "application_config.yaml");
    //         // 处理 config 对象
    //     } catch (IOException e) {
    //         e.printStackTrace();
    //     // }
    // }
}