JSR-303验证框架

JSR303 校验框架介绍：

定义：JSR-303 是JAVA EE 6 中的一项子规范，叫做Bean Validation,官方参考实现是hibernate Validator，
现在一共有两个规范:BeanValidation1.0(即JSR303)和BeanValidation1.1(即JSR349),主要用于对数据进行校验,确保输入进来的数据从语 义上来讲是正确的。
特点：1.JSR 303 用于对Java Bean 中的字段的值进行验证,使得验证逻辑从业务代码中脱离出来。
   2.是一个运行时的数据验证框架，在验证之后验证的错误信息会被马上返回。
应用场景:一般用于表单提交页面(如用户名必填、只能由数字字母组成等等)

• JSR303 用于对JavaBean 中的字段的值进行验证,使得验证逻辑从业务代码中脱离出来

• 是一个运行时的数据验证框架，在验证之后验证的错误信息会被马上返回

• 一般用于表单提交页面(如用户名必填、只能由数字字母组成等等)

需要引入jar包：

1. <dependency>  
2.     <groupid>javax.validation</groupid>  
3.     <artifactid>validation-api</artifactid>  
4. </dependency>  
5.   
6. <dependency>  
7.     <groupid>org.hibernate</groupid>  
8.     <artifactid>hibernate-validator-annotation-processor</artifactid>  
9. </dependency>  
10. <dependency>  
11.     <groupid>org.hibernate</groupid>  
12.     <artifactid>hibernate-validator</artifactid>  
13. </dependency>  

JSR303 校验框架注解类：

• @NotNull  注解元素必须是非空

• @Null  注解元素必须是空

• @Digits  验证数字构成是否合法

• @Future  验证是否在当前系统时间之后

• @Past  验证是否在当前系统时间之前

• @Max  验证值是否小于等于最大指定整数值

• @Min  验证值是否大于等于最小指定整数值

•@Pattern  验证字符串是否匹配指定的正则表达式

• @Size  验证元素大小是否在指定范围内

• @DecimalMax  验证值是否小于等于最大指定小数值

• @DecimalMin  验证值是否大于等于最小指定小数值

• @AssertTrue  被注释的元素必须为true

• @AssertFalse  被注释的元素必须为false

空检查 
@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=)

HibernateValidator 扩展

HibernateValidator扩展注解类：

• @Email  被注释的元素必须是电子邮箱地址

• @Length  被注释的字符串的大小必须在指定的范围内

• @NotEmpty  被注释的字符串的必须非空

• @Range  被注释的元素必须在合适的范围内

• @NotBlank(message =)   验证字符串非null，且长度必须大于0 

@NotNull和@NotEmpty和@NotBlank区别

1 @NotEmpty :不能为null，且Size>0

2  @NotNull:不能为null，但可以为empty,没有Size的约束

3  @NotBlank:只用于String,不能为null且trim()之后size>0