• SpringBoot整合JSR-303表单校验

    JSR-303表单校验

    思考一个问题，引出JSR-303

    为什么前端做了参数校验，后端还要进行参数校验？

    普通用户通过页面操作，前端可以校验住参数的正确性。但如果有人获取到接口，利用接口调用工具比如：postman对后端接口直接发起请求，这样就可以绕过前端校验，此时如果后端不做参数校验就不能保证数据规则。而JSR-303验证框架提供了丰富的参数校验注解来支持后端的表单校验。

    image-20221126193348025

    1.概述

    ● 概述

    1. 对输入的数据(比如表单数据)，进行必要的验证，并给出相应的提示信息。
    2. 对于验证表单数据，springMVC 提供了很多实用的注解, 这些注解由 JSR 303 验证框架提供

    ● JSR 303 验证框架

    1.JSR 303 是 Java 为 Bean 数据合法性校验提供的标准框架，它已经包含在 JavaEE 中

    1. JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max 等标准的注解指定校验规则， 并通过标准的验证接口对 Bean 进行验证

    2. JSR 303 提供的基本验证注解有:

      空检查
@Null 验证对象是否为null
@NotNull 验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
@NotEmpty 检查约束元素是否为NULL或者是EMPTY.

Booelan检查
@AssertTrue 验证 Boolean 对象是否为 true
@AssertFalse 验证 Boolean 对象是否为 false

长度检查
@Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内
@Length(min=, max=) Validates that the annotated string is between min and max included.

日期检查
@Past 验证 Date 和 Calendar 对象是否在当前时间之前，验证成立的话被注释的元素一定是一个过去的日期
@Future 验证 Date 和 Calendar 对象是否在当前时间之后 ，验证成立的话被注释的元素一定是一个将来的日期
@Pattern 验证 String 对象是否符合正则表达式的规则，被注释的元素符合制定的正则表达式，regexp:正则表达式 flags: 指定 Pattern.Flag 的数组，表示正则表达式的相关选项。

数值检查
建议使用在Stirng,Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为Stirng为”“,Integer为null
@Min 验证 Number 和 String 对象是否大等于指定的值
@Max 验证 Number 和 String 对象是否小等于指定的值
@DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
@DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
@Digits 验证 Number 和 String 的构成是否合法
@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度。
@Range(min=, max=) 被指定的元素必须在合适的范围内
@Range(min=10000,max=50000,message=”range.bean.wage”)
@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber信用卡验证
@Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。
@ScriptAssert(lang= ,script=, alias=)
//验证URL是否正确
@URL(protocol=,host=, port=,regexp=, flags=)

      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7
      • 8
      • 9
      • 10
      • 11
      • 12
      • 13
      • 14
      • 15
      • 16
      • 17
      • 18
      • 19
      • 20
      • 21
      • 22
      • 23
      • 24
      • 25
      • 26
      • 27
      • 28
      • 29
      • 30
      • 31
      • 32
      • 33
      • 34
      • 35

    ● Hibernate Validator 扩展注解

    1. Hibernate Validator 和 Hibernate 没有关系，只是 JSR 303 实现的一个扩展.

    2. Hibernate Validator 是 JSR 303 的一个参考实现，除支持所有标准的校验注解外，它还支 持以下的扩展注解:

    3. 扩展注解有如下

    image-20220618170242629

    2.应用实例

    1.基础校验

    准备工作

    1.创建SpringBoot项目

    2.引入依赖，以SpringBoot为例，spring-boot-starter-web依赖中包含了校验框架。

    <dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-webartifactId>
dependency>

    • 1
    • 2
    • 3
    • 4

    image-20221126185410911

    代码实现

    1.controller层代码，使用@Validated开启校验

    @RestController
@RequestMapping("commodity/brand")
public class BrandController {
    @Autowired
    private BrandService brandService;

    /**
     * 信息
     */
    @RequestMapping("/info/{id}")
    public R info(@PathVariable("id") Long id) {
        BrandEntity brand = brandService.getById(id);
        return R.ok().put("brand", brand);
    }

    /**
     * 保存
     * @Validated({SaveGroup.class})
     * 指定分组校验之后，@Validated修饰的类，每个字段必须指定组否则校验不会生效
     */
    @RequestMapping("/save")
    public R save(@Validated @RequestBody BrandEntity brand) {
        brandService.save(brand);
        return R.ok();
    }

    /**
     * 修改
     */
    @RequestMapping("/update")
    public R update(@Validated @RequestBody BrandEntity brand) {
        brandService.updateById(brand);
        return R.ok();
    }

}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36

    说明：开启校验需要在方法入参使用@Validated修饰

    @Valid与@Validated区别：https://blog.csdn.net/qq_33274797/article/details/109060226

    2.在@Validated修饰的类上，不同类型字段上添加对应的验证注解

    @Data
@TableName("commodity_brand")
public class BrandEntity implements Serializable {
    private static final long serialVersionUID = 1L;

    @TableId
    @Null(message = "添加不能指定id")
    private Long id;

    @NotBlank(message = "品牌名不能为空")
    private String name;
    /**
     * logo
     */
    @NotBlank(message = "logo不能为空")
    @URL(message = "logo不是一个合法的URL")
    private String logo;
    /**
     * 说明
     */
    private String description;
    /**
     * 显示
     */
    @NotNull(message = "显示状态不能为空")
    private Integer isshow;
    /**
     * 检索首字母
     */
    @NotBlank(message = "检索首字母不能为空")
    @Pattern(regexp = "^[a-zA-Z]$", message = "检索字母必须是一个字母")
    private String firstLetter;
    /**
     * 排序
     */
    @NotNull(message = "排序值不能为空")
    @Min(value = 0, message = "排序值要求大于等于 0")
    private Integer sort;

}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40

    测试

    image-20221126194246610

    2.分组校验

    为了满足新增、修改不同的参数校验，JSR-303校验框架还支持分组校验。这里以新增、修改为例

    1.创建新增、修改分组校验标识接口

    /**
 * 没有什么具体代码，就在做一个分组的标识
 * 表示新增组的校验标识
 */
public interface SaveGroup {


}
//用于修改组的校验标识
public interface UpdateGroup {


}


    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

    2.在controller层代码中修改@Validated注解，使用@Validated({分组类名.class})来进行分组校验

    /**
 * 保存
 * @Validated({SaveGroup.class})
 * 指定分组校验之后，@Validated修饰的类，每个字段必须指定组否则校验不会生效
 */
@RequestMapping("/save")
public R save(@Validated({SaveGroup.class}) @RequestBody BrandEntity brand) {
    brandService.save(brand);
    return R.ok();
}

/**
 * 修改
 */
@RequestMapping("/update")
public R update(@Validated({UpdateGroup.class}) @RequestBody BrandEntity brand) {
    brandService.updateById(brand);
    return R.ok();
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19

    注意：@Validated注解指定分组校验之后，@Validated修饰的类，每个字段必须指定组否则校验不会生效

    3.在@Validated修饰的类上，不同类型字段上添加对应的验证注解并标识不同的分组

    @Data
@TableName("commodity_brand")
public class BrandEntity implements Serializable {
    private static final long serialVersionUID = 1L;

    /**
     * id
     * 1. @NotNull(message = "修改要求指定id",groups = {UpdateGroup.class})
     * 表示@NotNull 在UpdateGroup校验组生效
     * 
    
     * 2. @Null(message = "添加不能指定id",groups = {SaveGroup.class})
     * 表示@Null 在SaveGroup校验组生效
     */
    @TableId
    @NotNull(message = "修改要求id不能为空",groups ={UpdateGroup.class})
    @Null(message = "添加不能指定id",groups = {SaveGroup.class})
    private Long id;

    /**
     * 品牌名
     * 说明
     * 1. @NotBlank 表示name必须包括一个非空字符
     * 2. message = "品牌名不能为空" 是老师指定的一个校验消息
     * 3. 如果没有指定 message = "品牌名不能为空" ,就会返回默认的校验消息  key = javax.validation.constraints.NotBlank.message
     * 4. 这个默认的消息是在  ValidationMessages_zh_CN.properties 文件配置 javax.validation.constraints.NotBlank.message        = \u4e0d\u80fd\u4e3a\u7a7a
     * 5. @NotBlank 可以用于  CharSequence
     * 6. groups = {SaveGroup.class, UpdateGroup.class}
     * 就是@NotBlank 在 SaveGroup 和 UpdateGroup都生效
     */
    @NotBlank(message = "品牌名不能为空", groups = {SaveGroup.class, UpdateGroup.class})
    private String name;
    /**
     * logo
     */
    @NotBlank(message = "logo不能为空",groups = {SaveGroup.class, UpdateGroup.class})
    @URL(message = "logo不是一个合法的URL",groups = {SaveGroup.class, UpdateGroup.class})
    private String logo;
    /**
     * 说明
     */
    private String description;
    /**
     * 显示
     */
    @NotNull(message = "显示状态不能为空",groups = {SaveGroup.class, UpdateGroup.class})
    private Integer isshow;
    /**
     * 检索首字母
     */
    @NotBlank(message = "检索首字母不能为空",groups = {SaveGroup.class, UpdateGroup.class})
    @Pattern(regexp = "^[a-zA-Z]$", message = "检索字母必须是一个字母",groups = {SaveGroup.class, UpdateGroup.class})
    private String firstLetter;
    /**
     * 排序
     */
    @NotNull(message = "排序值不能为空",groups = {SaveGroup.class, UpdateGroup.class})
    @Min(value = 0, message = "排序值要求大于等于 0",groups = {SaveGroup.class, UpdateGroup.class})
    private Integer sort;

}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54
    • 55
    • 56
    • 57
    • 58
    • 59
    • 60

    说明，上面的代码表示添加时不需要填写id,修改时需要填写id； 其他参数修改、新增都做相同校验

    4.测试

    新增时，指定id。提示添加时不能指定id

    image-20221126195527698

    而修改时，指定id时可以的

    image-20221126195600517

    3.自定义校验

    引出自定义校验的必要性，为什么要使用自定义校验？

    @NotNull(message = "显示状态不能为空",groups = {SaveGroup.class, UpdateGroup.class})
private Integer isshow;

    • 1
    • 2

    image-20221126195916213

    如上所示，针对是否显示做校验，比如我们想让1-表示显示，0-表示不显示。即isshow的值只能为0或者1。

    当然前面提到的@Pattern注解可以实现这个功能，但@Pattern只能修饰字符串类型的字段。修饰其他字段则会抛出异常。因此如下代码是不成立的。

    @NotNull(message = "显示状态不能为空",groups = {SaveGroup.class, UpdateGroup.class})
@Pattern(regexp = "^[0-1]$", message = "显示状态的值为0或1",groups = {SaveGroup.class, UpdateGroup.class})
private Integer isshow;

    • 1
    • 2
    • 3
    1.创建自定义校验注解
    /**
 * 1. EnumConstraintValidator是真正的校验器,即校验的逻辑是写在这里的
 * 2. EnumConstraintValidator需要实现接口 ConstraintValidator
 * 3.  表示该校验器是针对 @EnumValidate 传入的Integer类型数据进行校验
 */
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = {EnumConstraintValidator.class})
public @interface EnumValidate {

    /**
     * 指定错误信息描述所在类的所在字段
     * @return
     */
    String message() default "{com.llp.common.valid.EnumValidate.message}";

    /**
     * 指定分组
     * @return
     */
    Class<?>[] groups() default { };

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

    //增加values属性
    int[] values() default {};

    //增加regexp
    String regexp() default "";
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    2.自定义校验器

    这里正则校验和数组元素校验存在重复，仅作为示例

    /**
 * 自定义校验器
 */
public class EnumConstraintValidator implements ConstraintValidator<EnumValidate, Integer> {

    Set<Integer> set = new HashSet<>();
    private String regexp = "";

    /**
     * 初始化验证器，为isValid(Object, ConstraintValidatorContext)调用做准备。传递给定约束声明的约束注释。
     * 保证在使用此实例进行验证之前调用此方法。 默认的实现是无操作的
     *
     * @param constraintAnnotation 自定义注解
     */
    @Override
    public void initialize(EnumValidate constraintAnnotation) {
        int[] values = constraintAnnotation.values();
        for (int value : values) {
            set.add(value);
        }
        regexp = constraintAnnotation.regexp();
    }

    /**
     * 如果返回true表示验证成功-通过
     * 返回false，表示验证失败-没有通过
     *
     * @param value
     * @param context
     * @return
     */
    @Override
    public boolean isValid(Integer value, ConstraintValidatorContext context) {
        boolean contains = set.contains(value);
        if (!contains) {
            return false;
        }
        if (!value.toString().matches(regexp)) {
            return false;
        }
        return true;
    }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    3.自定义错误提示信息

    在类路径resource目录下创建ValidationMessages.properties文件，“显示状态的值需要是0或者1”中文部分需转换为unicode码。

    com.llp.common.valid.EnumValidate.message=显示状态的值需要是0或者1

    • 1
    4.在表单校验的类中添加自定义校验注解
    @NotNull(message = "显示状态不能为空", groups = {SaveGroup.class, UpdateGroup.class})
@EnumValidate(values = {0, 1}, message = "显示只必须为1或者0", regexp = "^[0-1]$", groups = {SaveGroup.class, UpdateGroup.class})
private Integer isshow;

    • 1
    • 2
    • 3
    5.测试

    可以看到针对isshow的校验信息，显示只必须为1或者0

    image-20221126211241942

    3.注意事项和使用细节

    1. 一个自定义校验注解，可以由多个校验器来组合校验 ，如下

      /**
 * 1. EnumConstraintValidator是真正的校验器,即校验的逻辑是写在这里的
 * 2. EnumConstraintValidator需要实现接口 ConstraintValidator
 * 3.  表示该校验器是针对 @EnumValidate 传入的Integer类型数据进行校验
 */
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = {EnumConstraintValidator.class})
public @interface EnumValidate {

    /**
     * 指定错误信息描述所在类的所在字段
     * @return
     */
    String message() default "{com.llp.common.valid.EnumValidate.message}";

    /**
     * 指定分组
     * @return
     */
    Class<?>[] groups() default { };

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

    //增加values属性
    int[] values() default {};

    //增加regexp
    String regexp() default "";
}

      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7
      • 8
      • 9
      • 10
      • 11
      • 12
      • 13
      • 14
      • 15
      • 16
      • 17
      • 18
      • 19
      • 20
      • 21
      • 22
      • 23
      • 24
      • 25
      • 26
      • 27
      • 28
      • 29
      • 30
      • 31

    2. 注意, validatedBy = {EnumConstraintValidator.class} 是可以带校验器类型数组的.

  • 相关阅读:
    POJ3259虫洞题解
    【周末闲谈】谈谈数学转码这一年来的体会与反思
    LVS集群
    MySQL read 查询语句1
    乘法除法运算符规范
    JAVA毕业设计冠军体育用品购物网站计算机源码+lw文档+系统+调试部署+数据库
    内存泄漏问题,4种智能指针(介绍+模拟实现)
    react-生命周期与组件传参
    【POJ No. 1442】 黑盒子 Black Box
    SpringCloud-微服务-Gateway网关配置
  • 原文地址：https://blog.csdn.net/qq_44981526/article/details/128057393