validation校验包常用校验注解@NotEmpty,@NotBlank,@NotNull等注解

时间:2025-03-01 10:45:41

一、常用注解@NotEmpty,@NotBlank,@NotNull介绍
包位置:

@NotEmpty 用在集合上面,一般用来校验List类型(不能注释枚举),而且长度必须大于0

@NotBlank 用在String上面,一般用来校验String类型不能为空,而且调用trim()后,长度必须大于0。

@NotNull 用在所有类型上面,一般用来校验Integer类型不能为空,但可以为empty。

需要搭配@Valid使用,在检验Controller的入参是否符合规范时

使用方法如下:

请求类:

public class re {
    /**
     * 昵称
     */
    @NotBlank(message = "昵称不能为空", groups = {})
    private String nickname;
   /**
     * 用户ID
     */
    @NotEmpty(message = "ID不能为空", groups = {})
    private List<String> userIds;
}

"groups = {}" 表示分组校验,需写类,如下

/**
 * 接口参数校验组对象
 */
public class ValidatedGroup {

    /**
     * 新增操作校验组
     */
    public interface AddGroup{};

    /**
     * 更新操作校验组
     */
    public interface UpdateGroup{};

    /**
     * 查询操作校验组
     */
    public interface QueryGroup{};
}

Controller代码:

 public Result<?> test(@Validated @RequestBody re  re){
        …………逻辑代码
}


-------例-------
@PostMapping(value = "/settingServiceCharge")
public Result<?> settingServiceCharge(@Validated({}) @RequestBody PcSettingServiceChargeRequest request) {
        return (request);
}


此包下的其他注解:

注解    含义
@Null    元素必须为null
@NotNull    元素不能null
@AssertTrue    元素必须为true
@AssertFalse    元素必须是false
@Min(value)    元素必须是一个数字,其值必须大于等于指定的最小值
@Max(value)    元素必须是一个数字,其值必须小于等于指定的最大值
@DecimalMin(value)    元素必须是一个数字,其值必须大于等于指定的最小值
@DecimalMax(value)    元素必须是一个数字,其值必须小于等于指定的最大值
@Size(max,min)    元素的大小必须在指定的范围内
@Digits(integer,fraction)    元素必须是一个数字,其值必须在可接受的范围内
@Past    元素必须是一个过去的日期
@Future    元素必须是一个将来的日期
@Pattern(value)    元素必须符合指定的正则表达式
@Email    元素必须是电子邮箱地址
@Length    字符串的大小必须在指定的范围内
@NotEmpty    字符串必须非空
@Range    元素必须在合理的范围内
当然知道了上面注解的用法后,还需要知道@Valid与@Validated的使用与区别