JSR

JSR

JSR 是 Java Specification Requests 的缩写,意思是 Java 规范提案. 是指向 JCP ( Java Community Process ) 提出新增一个标准化技术规范的正式请求. 任何人都可以提交 JSR,以向 Java 平台增添新的 API 和服务. JSR 已成为 Java 界的一个重要标准.

JSR-303

JSR-303 是 JAVA EE 6 中的一项子规范,叫做 Bean Validation,Hibernate Validator 是 Bean Validation 的参考实现. Hibernate Validator 提供了 JSR 303 规范中所有内置 constraint 的实现,除此之外还有一些附加的 constraint.

引入依赖

1
2
3
4
5
<!-- JSR303依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>

JSR303检验

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
空检查 
@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(protocol=,host=, port=,regexp=, flags=)