自定义注解搭配枚举是Java中组织多状态逻辑分支的轻量高效方案：用枚举定义有限状态，注解声明枚举属性实现类型安全的策略标识，运行时通过反射读取并分发处理，支持扩展与多态。
自定义注解搭配枚举，是 java 中组织多状态逻辑分支的轻量高效方案。核心思路是：用枚举定义有限、明确的状态集合，再通过注解将该枚举作为属性传入，让框架或工具类在运行时读取并分发处理——既保留编译期类型安全，又避免硬编码字符串或冗长 if-else。
枚举作为注解属性的必要前提
Java 要求注解的属性类型必须是“可序列化常量”，枚举天然满足这一条件。只要枚举类被正确声明（非匿名、无外部依赖），就可直接用作注解成员：
- 注解中声明枚举字段时，必须使用 public enum 类型名，不能是泛型或通配符
- 枚举类本身需是 public static 可见，且每个常量必须有明确含义
- 推荐为枚举添加描述字段（如 code/desc）和根据 code 查找的静态方法，便于后续解析
定义带枚举属性的自定义注解
以「接口幂等控制」为例，定义一个注解标识不同幂等策略：
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Idempotent {
// 枚举属性：指定幂等依据
IdempotentStrategy value() default IdempotentStrategy.TOKEN;
// 可选字符串参数，配合枚举细化行为
String keyPrefix() default "";
}
public enum IdempotentStrategy {
TOKEN("基于请求 token 校验"),
PARAMS("基于请求参数签名"),
BUSINESS_ID("基于业务唯一 ID");
private final String desc;
IdempotentStrategy(String desc) { this.desc = desc; }
public String getDesc() { return desc; }
}
在切面或处理器中读取并分发逻辑
利用反射获取注解中的枚举值，再按枚举常量执行对应分支。这种方式比 switch 字符串更安全，也比 if-else 更易扩展：
- 通过
method.getAnnotation(Idempotent.class)获取注解实例 - 调用
annotation.value()得到具体枚举常量（如TOKEN） - 用 switch 枚举（JDK 14+ 支持）或 if 判断枚举常量，调用对应校验器
- 新增策略只需在枚举中加一项 + 扩展一个校验实现，不改动原有分发逻辑
进阶：枚举自带行为，实现真正多态分发
让枚举实现统一接口，把状态相关的逻辑内聚到枚举自身，注解只负责“选中”哪个策略：
public interface IdempotentHandler {
boolean check(Object context);
}
public enum IdempotentStrategy implements IdempotentHandler {
TOKEN {
public boolean check(Object ctx) {
return TokenChecker.validate((HttpServletRequest) ctx);
}
},
PARAMS {
public boolean check(Object ctx) {
return ParamSignChecker.check(ctx);
}
};
// 抽象方法由各常量自行实现
public abstract boolean check(Object context);
}
此时处理器代码极度简洁：annotation.value().check(context) —— 枚举常量即策略实例，无需额外工厂或 Map 映射。
