spring boot自定义注解校验参数(枚举校验)

引入spring boot的spring-boot-starter-validation实现自定义注解校验参数,实现校验枚举值参数数据是否合规,提高接口的安全性和开发效率。

1.引入validation的starter

xml 复制代码
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-validation</artifactId>
</dependency>

2.创建校验的枚举基类

创建IBaseEnumParam类的目的是为了统一枚举类的创建规则,能够通过继承的方式去校验参数值是否在枚举类当中。

java 复制代码
/**
 * 基础枚举参数
 * @author wxz
 */
public interface IBaseEnumParam<T> {

    /** 获取code码
     *
     * @return
     */
    T getCode();

    /**
     * 获取描述信息
     * @return
     */
    String getDesc();

}

3.创建基础枚举类的子类

通过子类去校验参数

java 复制代码
@AllArgsConstructor
public enum SexEnum implements IBaseEnumParam<Integer> {
    MAN(1,"男"),
    WOMAN(0,"女");

    /**
     * 编码
     */
    private final Integer code;
    /**
     * 描述
     */
    private final String desc;

    @Override
    public Integer getCode() {
        return code;
    }

    @Override
    public String getDesc() {
        return desc;
    }
}

4.创建校验的自定义注解

1.message,groups,payload字段默认带上
2.enums字段自定义传入字符串数组进行校验可以不用依赖枚举基类(适合不需要拓展的)
3.baseEnum字段传入IBaseEnumParam的子类进行校验(适合后期需要拓展的,不用修改校验代码)
4.@Constraint告诉validation是验证注解,EnumValidator.class验证的实现类

java 复制代码
/**
 * 枚举验证器
 * @author wxz
 */
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy ={EnumValidator.class})
public @interface EnumValidate {

    /**
     * 枚举的集合
     * @return
     */
    String[] enums() default {};

    /**
     * baseEnum
     * @return
     */
    Class<? extends IBaseEnumParam<?>> baseEnum();

    String message() default "枚举错误";

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

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

5.校验规则实现

1.实现ConstraintValidator第一个泛型是验证注解,第二个泛型是需要验证的字段类型

2.initialize方法获取注解上的数据

3.isValid方法具体的验证实现

java 复制代码
/**
 * 枚举验证器
 * @author wxz
 */
public class EnumValidator implements ConstraintValidator<EnumValidate,Object> {

    private String[] enums;

    private Class<? extends IBaseEnumParam<?>> baseEnum;

    @Override
    public boolean isValid(Object val, ConstraintValidatorContext constraintValidatorContext) {
        // 优先执行基础的枚举判断
        if (Objects.nonNull(baseEnum)){
            IBaseEnumParam<?>[] enumConstants = baseEnum.getEnumConstants();
            for (IBaseEnumParam<?> baseEnumParam : enumConstants){
                if (Objects.equals(String.valueOf(baseEnumParam.getCode()),String.valueOf(val))){
                    return true;
                }
            }
            return false;
        }
        if (this.enums == null || this.enums.length == 0){
            return true;
        }
        for (String enumVal : enums){
            if (Objects.equals(enumVal,String.valueOf(val))){
                return true;
            }
        }
        return false;
    }

    @Override
    public void initialize(EnumValidate constraintAnnotation) {

        this.enums = constraintAnnotation.enums();
        this.baseEnum = constraintAnnotation.baseEnum();
    }

}

代码结束!

示例:

java 复制代码
	@PostMapping("/role/edit")
    @ApiOperation(value = "编辑角色",notes = "编辑角色 有id更新 无id新增")
    public BizResult<Void> roleEdit(@RequestBody @Validated RoleEditDTO roleEditDTO){
        sysRoleService.roleEdit(roleEditDTO);
        return BizResult.success();
    }
    
	@Data
	@ApiModel("RoleEditDTO")
	public class RoleEditDTO {

	    @ApiModelProperty("id 有则修改 无则新增")
	    private Long id;
	
	    @ApiModelProperty("名称")
	    @Length(min = 1, max = 50, message = "名称长度超出范围")
	    private String roleName;
	
	    @ApiModelProperty("编码")
	    @Length(min = 1, max = 50, message = "编码长度超出范围")
	    private String roleCode;
	
	    @ApiModelProperty("状态 0 可用 1 不可用")
	    @EnumValidate(baseEnum = StatusEnum.class,message = "状态的值错误")
	    private Integer status;

	}
相关推荐
果果软件7 小时前
2026 后台管理系统选型:若依、JeecgBoot、芋道、NocoBase 和 GewuMind Boot 怎么选?
java·人工智能·后端·ai·开源
码云社区10 小时前
Java家政服务系统源码:人员技能、服务范围与多商家业务落地
java·开发语言·家政服务·家政小程序·家政系统
Sashtok11 小时前
cpp基础知识(10)
c++·后端
摇滚侠11 小时前
《On Java 中文版 基础卷》阅读笔记 接口 18
java·笔记·python
CoderYanger12 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
行百里er12 小时前
【Spring Insight 技术分享】runtime-settings.json 的妙用
后端·开源·监控
databook13 小时前
处理一批 PDF,怎么算真的处理完了
后端·python
苏三说技术14 小时前
为什么越来越多人用 Docling ? - 苏三说技术
后端
nice_lcj52014 小时前
【从零理解计算机网络 · 12】登录态的载体:Cookie、Session、Token 在网络层怎么走
后端·计算机网络·面试·jwt·token·cookie·session
jaysee-sjc14 小时前
【黑马点评】Day02:优惠券秒杀与分布式锁
java·分布式·nginx·spring·node.js·tomcat·maven