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.validationgroupid>  
  3.     <artifactid>validation-apiartifactid>  
  4. dependency>  
  5.   
  6. <dependency>  
  7.     <groupid>org.hibernategroupid>  
  8.     <artifactid>hibernate-validator-annotation-processorartifactid>  
  9. dependency>  
  10. <dependency>  
  11.     <groupid>org.hibernategroupid>  
  12.     <artifactid>hibernate-validatorartifactid>  
  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区别

@NotEmpty :不能为null,且Size>0

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

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


你可能感兴趣的:(JSR-303验证框架)