如何在枚举中动态加载 properties 文件中的实际值（而非键名）_技术教程

本文介绍一种安全、可维护的方式，让 java 枚举能根据 properties 文件中的键名自动解析出对应的实际字符串值（如错误消息和错误码），避免直接将键名误作值使用。

在 Java 开发中，常通过 enum 统一管理业务错误码与提示信息，并期望从外部配置（如 errorcodes.properties）中动态加载其真实内容。但若直接将属性键（如 "error.id.required.message"）传入枚举构造器并赋值给字段，运行时得到的只是键名本身——而非 properties 中定义的值（如 "Id is required to get the details."）。这是因为枚举实例在类加载时即完成初始化，而此时 Properties 尚未加载，也无法在构造器中执行动态查表逻辑。

✅ 正确方案：分离配置加载与枚举语义

核心思想是 让枚举保持不可变性与语义清晰性，将配置读取与键值解析职责委托给专用的单例存储类。以下是推荐实现：

1. 定义枚举（仅声明键名，不持有实际值）

import lombok.RequiredArgsConstructor;

@RequiredArgsConstructor(access = lombok.AccessLevel.PACKAGE)
public enum ErrorCode {
    ID_REQUIRED("error.id.required.message", "error.id.required.code"),
    ID_INVALID("error.id.invalid.message", "error.id.invalid.code");

    private final String messageKey;
    private final String codeKey;

    public String getMessage() {
        return ErrorCodeStore.getInstance().getValue(messageKey);
    }

    public String getCode() {
        return ErrorCodeStore.getInstance().getValue(codeKey);
    }
}

✅ 优势：枚举仍保持 final、线程安全、可序列化；getMessage()/getCode() 方法延迟解析，确保返回真实配置值。

2. 创建配置存储单例（ErrorCodeStore）

import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

import lombok.RequiredArgsConstructor;

@RequiredArgsConstructor(access = lombok.AccessLevel.PRIVATE)
final class ErrorCodeStore {
    private static ErrorCodeStore instance;

    public static ErrorCodeStore getInstance() {
        if (instance == null) {
            throw new IllegalStateException("ErrorCodeStore not initialized. Call initFrom() first.");
        }
        return instance;
    }

    private final Properties properties;

    public static ErrorCodeStore initFrom(InputStream in) throws IOException {
        Properties props = new Properties();
        props.load(in);
        instance = new ErrorCodeStore(props);
        return instance;
    }

    String getValue(String key) {
        String value = properties.getProperty(key);
        if (value == null || value.trim().isEmpty()) {
            // 可选：记录警告或抛出异常，避免静默失败
            return key; // fallback to key itself for debugging
        }
        return value.trim();
    }
}

⚠️ 注意事项：

initFrom() 必须在应用启动早期调用（如 Spring 的 @PostConstruct 或 main() 中），且 InputStream 需显式关闭（示例中为简洁省略，生产环境建议使用 try-with-resources）；

getValue() 提供 fallback 行为（返回原 key），便于快速定位缺失配置；

ErrorCode 与 ErrorCodeStore 需位于同一包内，以保障 PACKAGE 访问权限的正确性。

3. 初始化与使用示例

public class ErrorDemo {
    public static void main(String[] args) throws IOException {
        // ✅ 在使用前初始化配置存储
        try (InputStream is = ErrorDemo.class.getResourceAsStream("/errorcodes.properties")) {
            if (is == null) {
                throw new IllegalArgumentException("errorcodes.properties not found in classpath");
            }
            ErrorCodeStore.initFrom(is);
        }

        // ✅ 现在可安全获取真实值
        System.out.println(ErrorCode.ID_REQUIRED.getMessage()); // 输出: Id is required to get the details.
        System.out.println(ErrorCode.ID_REQUIRED.getCode());    // 输出: 110
    }
}

4. 集成到自定义异常中（如 CustomException）

public class CustomException extends RuntimeException {
    private final String errorCode;
    private final String errorMessage;

    public CustomException(ErrorCode code) {
        super(code.getMessage()); // 使用动态解析的消息
        this.errorCode = code.getCode();
        this.errorMessage = code.getMessage();
    }

    // getters...
}