自定义注解实现枚举值校验需定义带@Constraint的注解并指定validatedBy类，枚举类提供code字段及ofCode静态查找方法，验证器通过反射调用ofCode判断合法性，支持泛型与enumClass属性提升复用性，配合@Valid和全局异常处理返回结构化错误响应。
自定义注解定义校验规则
先创建一个自定义注解，用于标记需要校验枚举值的字段。注解需声明校验逻辑的触发时机（如 @Target({ElementType.FIELD, ElementType.PARAMETER})），并指定运行时保留（@Retention(RetentionPolicy.RUNTIME)）。关键点是添加 @Constraint(validatedBy = EnumValueValidator.class)，将校验委托给具体实现类。
编写枚举类并约定校验依据
枚举类应提供统一的取值入口，比如定义 code 字段表示外部传入的标识符，并提供静态方法 ofCode(String code) 用于查找对应枚举项。该方法在验证器中被调用，若返回 null 则视为非法值。例如：
public enum OrderStatus {
PENDING("pending"),
PAID("paid"),
SHIPPED("shipped");
private final String code;
OrderStatus(String code) { this.code = code; }
public static OrderStatus ofCode(String code) {
return Arrays.stream(values())
.filter(e -> e.code.equals(code))
.findFirst()
.orElse(null);
}
}
实现 ConstraintValidator 接口完成校验逻辑
编写 EnumValueValidator 类，泛型参数为自定义注解类型和待校验字段类型（通常为 String 或枚举本身）。重写 isValid 方法：若入参为 null，根据业务决定是否允许；否则调用枚举的 ofCode 方法判断是否存在匹配项。支持泛型枚举校验可提取通用逻辑，避免为每个枚举写单独验证器。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- 校验器中通过 Class<? extends Enum> 获取目标枚举类型，再反射调用其静态方法
- 注解上可增加 enumClass() 属性，运行时传入具体枚举类，提升复用性
- 错误提示消息通过 message() 属性配置，默认使用国际化键（如 enum.not.supported）
在 Controller 中使用并配合全局异常处理
在 DTO 或请求参数对象的字段上添加自定义注解，例如：@ValidEnum(enumClass = OrderStatus.class, message = "订单状态不合法") private String status;。Spring MVC 自动触发校验，失败时抛出 MethodArgumentNotValidException。配合 @ControllerAdvice 统一捕获，提取 BindingResult 中的错误信息，返回结构化 JSON 响应（如 code=400, msg="订单状态不合法"）。
注意开启校验支持：确保控制器方法参数带有 @Valid 或 @Validated，且项目引入了 spring-boot-starter-validation 依赖。
