Java中枚举类配合注解实现校验的核心是：自定义@ValidEnum注解+Gender等业务枚举+EnumValueValidator校验器；枚举含code/desc字段并提供fromCode方法，注解通过enumClass指定枚举类型，校验器支持String、Integer、Enum输入并反射调用fromCode或比对ordinal。
Java 中枚举类配合注解实现校验逻辑，核心思路是：**自定义校验注解 + 枚举类提供合法值集合 + ConstraintValidator 做运行时比对**。这种方式既保持类型安全，又让校验规则集中、可复用、易维护。
定义带业务语义的枚举类
枚举本身应明确表达取值范围和含义，推荐包含描述字段（如中文名、code），便于后续扩展校验或展示：
public enum Gender {
MALE("M", "男"),
FEMALE("F", "女"),
OTHER("O", "其他");
private final String code;
private final String desc;
Gender(String code, String desc) {
this.code = code;
this.desc = desc;
}
public String getCode() { return code; }
public String getDesc() { return desc; }
// 提供根据 code 查找枚举的静态方法（ConstraintValidator 里会用到）
public static Gender fromCode(String code) {
for (Gender g : Gender.values()) {
if (g.code.equalsIgnoreCase(code)) {
return g;
}
}
return null;
}
}
编写自定义校验注解
注解需标注 @Target({METHOD, FIELD, PARAMETER}) 和 @Constraint(validatedBy = EnumValueValidator.class)，并声明支持的枚举类型：
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = EnumValueValidator.class)
public @interface ValidEnum {
String message() default "不合法的枚举值";
Class<?> enumClass(); // 运行时传入具体枚举类，如 Gender.class
Class<? extends Payload>[] payload() default {};
Class<? extends Group>[] groups() default {};
}
实现 ConstraintValidator 支持泛型枚举校验
关键点在于：通过反射获取枚举类所有常量，并检查待校验值是否在其中。支持 String、Integer、Enum 三种常见输入类型：
立即学习“Java免费学习笔记（深入）”；
public class EnumValueValidator implements ConstraintValidator<ValidEnum, Object> {
private Class<?> enumClass;
@Override
public void initialize(ValidEnum constraintAnnotation) {
this.enumClass = constraintAnnotation.enumClass();
}
@Override
public boolean isValid(Object value, ConstraintValidatorContext context) {
if (value == null) return true; // 可按需改为 false（非空+枚举双重校验）
// 如果 value 本身就是该枚举类型，直接允许
if (enumClass.isEnum() && enumClass.isInstance(value)) {
return true;
}
// 尝试从枚举中查找匹配项：支持 code 字段（String）或 ordinal（Integer）
try {
if (value instanceof String str) {
// 优先调用枚举的 fromCode 方法（如有）
Method fromCode = enumClass.getDeclaredMethod("fromCode", String.class);
Object result = fromCode.invoke(null, str);
return result != null;
} else if (value instanceof Integer idx) {
Object[] constants = enumClass.getEnumConstants();
return idx >= 0 && idx < constants.length;
}
} catch (Exception ignored) {}
return false;
}
}
在 DTO 或参数中使用注解
校验时只需指定具体枚举类，清晰直观：
public class UserRequest {
@ValidEnum(enumClass = Gender.class)
private String genderCode; // 传 "M"、"F" 等字符串
@ValidEnum(enumClass = Gender.class)
private Gender genderEnum; // 也可直接传 Gender 枚举实例（前端 JSON 通常传字符串，后端反序列化为枚举需额外配置）
// getter/setter...
}
Spring Boot 项目中，配合 @Valid 使用即可触发校验：
@PostMapping("/user")
public ResponseEntity<?> createUser(@Valid @RequestBody UserRequest request) {
// ...
}
若传入非法值（如 "X"），将自动返回 400 和默认错误消息。
