JSR303校验

JSR表示Java Specification Requests,Java 规范提案。JSR-303 是JAVA EE 6 中的一项子规范,叫做Bean Validation。用于验证bean属性注入值类型,格式等有效性。

Maven依赖

主要是hibernate-validator

<!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator -->
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>7.0.1.Final</version>
</dependency>

Maven加载hibernate-validator的时候,会默认载入jakarta.validation-api

<!-- https://mvnrepository.com/artifact/jakarta.validation/jakarta.validation-api -->
<dependency>
    <groupId>jakarta.validation</groupId>
    <artifactId>jakarta.validation-api</artifactId>
    <version>3.0.0</version>
</dependency>

jakarta.validation 中内置的 constraint

@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 被注释的元素必须是电子邮件地址
@NotEmpty 被注释的字符串必须非空
  • 数值检查建议使用在Stirng,Integer类型,不要使用在int类型上,因为表单值为“”时无法转换为int,但可以转换为Stirng为”“,Integer为null 。

Hibernate Validator 附加的 constraint

@Length 被注释的字符串的大小必须在指定的范围内
@Range 被注释的元素必须在合适的范围内

@Validated

用于修饰@Component组件类,结合上面的属性级别constraint注解,给类属性字段加一层数据校验。一般搭配@ConfigurationProperties类级别注解使用,校验外部配置值的有效性。

  • @Validated所在包路径:org.springframework.validation.annotation.Validated
posted @ 2021-04-01 14:13  每天向前一步  阅读(258)  评论(0编辑  收藏  举报