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) | 被注释的元素必须符合指定的正则表达 |
被注释的元素必须是电子邮件地址 | |
@NotEmpty | 被注释的字符串必须非空 |
- 数值检查建议使用在Stirng,Integer类型,不要使用在int类型上,因为表单值为“”时无法转换为int,但可以转换为Stirng为”“,Integer为null 。
Hibernate Validator 附加的 constraint
@Length | 被注释的字符串的大小必须在指定的范围内 |
---|---|
@Range | 被注释的元素必须在合适的范围内 |
@Validated
用于修饰@Component
组件类,结合上面的属性级别constraint注解,给类属性字段加一层数据校验。一般搭配@ConfigurationProperties类级别注解使用,校验外部配置值的有效性。
- @Validated所在包路径:org.springframework.validation.annotation.Validated