Java自定义注解校验枚举值类型参数

　　项目开发中会经常使用到各种枚举值，枚举值一般都是固定的，不会随意改变其中的值。

比如性别分为男女，确定之后一般都不会轻易改变，这时候使用枚举值就非常地方便。很多

时候，在页面中传入的参数就是枚举值中的一个，比如性别，或者是星期，月份，以及自定义

的各种类型等等。如果是手动校验就非常麻烦，假如有50个枚举值，不可能每一个枚举值都

进行手动校验，那这时候如何更好的校验呢？答案很简单，使用自定义的校验注解即可。

先上代码，然后在慢慢地讲解。自定义的校验注解如下：

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR,ElementType.PARAMETER})

@Retention(RetentionPolicy.RUNTIME)

@Documented

@Constraint(validatedBy = {EnumValidateValidator.class})

public @interface EnumValidate {

Class<? extends Enum<?>> enumClass();

String enumMethod() default "isValid";

String message() default "必须传入枚举类型的class";

boolean nullAble() default false;

//分组

Class<?> [] groups() default {};

// 负载

Class<? extends Payload> [] payload() default {};

// 指定多个时使用

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR,ElementType.PARAMETER})

@Retention(RetentionPolicy.RUNTIME)

@Documented

@interface List {

EnumValidate [] value();

}

}

自定义校验注解验证器如下：

public class EnumValidateValidator implements ConstraintValidator<EnumValidate, Object> {

private Class<? extends Enum<?>> enumClass;

private String enumMethod;

private boolean nullAble;

@Override

public void initialize(EnumValidate constraintAnnotation) {

enumClass = constraintAnnotation.enumClass();

enumMethod = constraintAnnotation.enumMethod();

nullAble = constraintAnnotation.nullAble();

}

@Override

public boolean isValid(Object value, ConstraintValidatorContext context) {

if (value == null) {

return nullAble;

}

try {

Object[] enumConstants = enumClass.getEnumConstants();

Method method = enumClass.getMethod(enumMethod, value.getClass());

Object result = method.invoke(enumConstants[0], value);

System.out.println("invoke--->" + result);

return (Boolean)result;

} catch (Exception ex) {

ex.printStackTrace();

throw new RuntimeException("枚举类型验证错误");

}

}

}

自定义的测试枚举如下：

public enum  TestEnum {

TYPE_ONE("ONE", "成功"),

TYPE_TWO("TYPE_TWO", "失败"),

;

/*

* 编码

*/

private String code;

/*

* 信息

*/

private String msg;

public String getCode() {

return code;

}

TestEnum(String code, String msg) {

this.code = code;

this.msg = msg;

}

/* @Description: 枚举里面的自定义校验方法

* @author: yilang

* @date: 2022/12/6 20:53

* @param: value

* @return: boolean

*/

public boolean isValid(String value) {

for(TestEnum testEnum : TestEnum.values()) {

if (testEnum.getCode().equals(value)) {

return true;

}

}

return false;

}

}

测试入参如下:

@Data

public class ParamTest {

/*

* 名称

*/

@NotNull(message = "名称不能为null")

private String name;

/*

* 简介

*/

@Length(max = 10, message = "简介长度最大为10")

private String abs;

@EnumValidate(enumClass = TestEnum.class, nullAble = false, message = "传入的枚举类型参数错误")

private String enumTest;

}

Controller中的测试方法如下：

@Slf4j

@RestController

@RequestMapping("/happy/yilang")

public class TestControlelr {

@PostMapping("/enum")

public String enumTest(@Valid @RequestBody ParamTest paramTest){

return "枚举类型统计";

}

}

自定义注解中主要有几个自定参数，

// 限定传入的class为枚举类型

Class<? extends Enum<?>> enumClass();

// 指定传入的需要调用的枚举类的检验方法

String enumMethod() default "isValid";

// 错误提示信息

String message() default "必须传入枚举类型的class";

// 待校验的参数是否允许为null

boolean nullAble() default false;

//分组-自定义注解最好加上

Class<?> [] groups() default {};

// 负载-自定义注解必加参数，否则报错

Class<? extends Payload> [] payload() default {};

自定义注解校验器EnumValidateValidator 需要实现接口ConstraintValidator，然后重写里面的校验方法。

// 返回枚举类的元素 enumClass是通过注解拿到的，然后初始化的时候赋值给成员变量

Object[] enumConstants = enumClass.getEnumConstants();

// 获取需要执行的方法 enumMethod是通过注解拿到的，然后初始化的时候赋值给成员变量

//  value.getClass() 可以获取到原始传入数据的类型

Method method = enumClass.getMethod(enumMethod, value.getClass());

// 使用反射的方式执行方法，传入枚举变量和参数 程序底层会调用注解中获取到的需要执行的校验方法，默认为isValid，可以任意修改

Object result = method.invoke(enumConstants[0],  value);

// 自定义枚举类中isValid 方法返回的值是一个Object类型，可以转换为布尔类型

return (Boolean)result;

自定义枚举类中， isValid是自定义方法，名称可以随便取。 TestEnum.values()是每一个枚举类中都自带的方法，可以获取当前枚举的所有值。

public boolean isValid(String value) {

for(TestEnum testEnum : TestEnum.values()) {

if (testEnum.getCode().equals(value)) {

return true;

}

}

return false;

}

Controller中的方法和参数中使用注解的方式都很常规，不在赘述。

测试结果如下，通过校验的测试

未通过校验的测试

参考文章:

https://blog.csdn.net/h2604396739/article/details/83825148