java中枚举配合注解实现元数据配置，核心在于用枚举定义有限、稳定、语义明确的取值范围，再用注解为枚举值或代码元素附加可读、可查、可处理的额外信息，二者结合既保障类型安全与编译期校验，又提升配置表达力和运行时可操作性。
Java 中枚举配合注解实现元数据配置，核心在于：用枚举定义**有限、稳定、语义明确的取值范围**，再用注解为这些枚举值或使用它们的代码元素（如字段、方法）附加**可读、可查、可处理的额外信息**。二者结合，既保证类型安全与编译期校验，又提升配置表达力和运行时可操作性。
枚举作为配置项的合法值容器
枚举天然适合表示预定义的配置选项，比如数据库模式、日志级别、消息类型等。它确保传入值只能是已声明的几个之一，避免字符串硬编码带来的拼写错误和运行时异常。
- 定义清晰的配置枚举，每个常量可携带描述、code 或其他元数据字段
- 例如：public enum LogLevel { DEBUG("调试", 10), INFO("信息", 20), WARN("警告", 30), ERROR("错误", 40); ... }
- 这样不仅限定了可用值，还通过构造参数封装了业务含义，便于后续映射或展示
注解标注枚举使用场景
在字段、方法或参数上使用注解，把枚举值与具体配置意图绑定。注解本身不执行逻辑，但为框架或工具提供“标记+上下文”。
- 常见做法：定义一个注解，其属性类型为对应枚举，强制使用者从枚举中选值
- 例如：@interface LogConfig { LogLevel level() default LogLevel.INFO; String tag() default ""; }
- 然后在类中使用：@LogConfig(level = LogLevel.WARN, tag = "auth") public void login() { ... }
- 此时编译器会检查 level 是否为 LogLevel 的合法成员，杜绝非法字符串
自定义注解 + 枚举 + 运行时解析
真正发挥元数据作用，需要在运行时读取注解并结合枚举行为做决策。这通常借助反射完成。
- 给自定义注解加上 @Retention(RetentionPolicy.RUNTIME) 和 @Target({ElementType.METHOD, ElementType.FIELD})
- 编写工具类，扫描目标类的方法或字段，获取注解实例，调用 annotation.level() 得到枚举对象
- 根据枚举值执行不同逻辑，比如：if (config.level() == LogLevel.ERROR) sendAlert();
- 也可进一步调用枚举自身的业务方法，如 config.level().getThreshold() 获取日志阈值
进阶：枚举自身带注解，增强语义
枚举常量本身也能被注解修饰（需注解声明支持 @Target(ElementType.CONSTRUCTOR) 或 ElementType.FIELD），用于为每个枚举项添加独立元数据。
- 例如：为每个 DBMode 枚举值标注是否启用缓存、是否支持事务回滚
- 定义注解：@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface DBHint { boolean cacheable() default false; boolean rollbackSupported() default true; }
- 在枚举中使用：READ_ONLY(@DBHint(cacheable = true)), READ_WRITE(@DBHint(rollbackSupported = true))
- 运行时通过 MyEnum.READ_ONLY.getClass().getField("READ_ONLY").getAnnotation(DBHint.class) 获取该枚举项专属配置
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
