【精品】hibernate-validator 校验规则详解

关于JSR-303规范

JSR-303是JAVA EE6中的一项子规范，validation-api是一套标准（JSR-303），叫做Bean Validation，Hibernate Validator是Bean Validation的参考实现，提供了JSR-303 规范中所有内置constraint的实现，除此之外Hibernate Validator还附加了一些constraint。

validation-api内置的constraints

注解	说明
@AssertTrue	用于 boolean 字段，该字段只能为 true
@AssertFalse	用于 boolean 字段，该字段只能为 false
@DecimalMax	用于 Number 字段，只能小于或等于该值
@DecimalMin	用于 Number 字段，只能大于或等于该值
@Digits(integer=2,fraction=20)	检查是否是数字，校验整数位及小数位
@Email	被标注的元素必须是一个在可接受范围内的数字
@Future	检查该字段的日期是否是属于将来的日期
@FutureOrPresent	被标注的元素必须是现在或将来的日期
@Past	验证日期是否在当前时间之前，否则无法通过校验
@PastOrPresent	被注释的元素必须是一个过去或现在的日期
@Length(min=2,max=6)	用于字符串，检查字段长度是否在指定范围内
@Max	用于 Number 字段，只能小于或等于该值
@Min	用于 Number 字段，只能大于或等于该值
@NotNull	该字段不能为空
@NotEmpty	用于字符串，该字段不能为空字符串
@NotBlank	用于字符串，该字段不能为空字符串，忽略空格
@Null	该字段必须为空
@Size(min=2,max=4)	用于字符串、数组、集合、Map等，检查该字段的size是否在指定范围
@Digits(integer = 2, fraction = 2)	验证数字的整数位和小数位的位数是否超过指定的长度
@Pattern(regexp = “[abc]”)	用于验证字段是否与给定的正则相匹配
@Negative	被标注的元素必须是一个严格的负数，不包含0
@NegativeOrZero	被标注的元素必须是一个严格的负数，包含0
@Positive	被标注的元素必须是严格的正数，不包含0
@PositiveOrZero	被标注的元素必须是严格的正数，包含0

hibernate-validator内置的constraints

hibernate-validator	概述
@CodePointLength	验证字符序列的编码点长度在min和max之间，可以通过设置规范化策略来验证规范化值
@ConstraintComposition	布尔运算符，应用于合成约束注释的所有约束，组合约束注释可以定义组成它的约束的布尔组合，参考ConstraintComposition实现
@CreditCardNumber	被注释元素必须是一个有效的信用卡号码，这是Luhn算法的实现，目的是检查用户的错误，而不是信用卡的有效性
@Currency	参考moneyaryamount和CurrencyUnit实现
@EAN	检查被注释的字符序列是否有效，EAN长度为13，支持的类型是String，当字符串为null被认为有效的
@Email	被注释的字符串必须是正确格式的电子邮件地址【已禁用】
@ISBN	检查被注释字符序列是否有效，支持的类型是String，null将被认为有效的，在验证过程中，忽略所有非ISBN字符，所有数字和“X”都被认为是有效的ISBN字符。主要用于证以破折号分隔的ISBN时，这很有用，例如：239-992-190-873-492
@Length	被注释的字符串的长度必须在指定的范围内
@LuhnCheck	Luhn算法检查约束，用于验证一系列数字通过Luhn
@Mod10Check	允许验证一系列数字通过Mod10校验和算法。经典的Mod10是通过把每一个奇数加起来计算出来的数字(从右到左)的值乘以乘数，例如：ISBN-13是Modulo 10校验和乘数= 3，在已知的情况下，代码使用乘数的偶数和奇数数字；为了支持这种实现，Mod10约束使用权重选项，它具有与乘数相同的效果，但为偶数数字，支持的类型是String。null被认为有效的
@Mod11Check	允许验证一系列数字通过Mod11校验和算法，对于最常见的Mod11变体的总和计算是通过乘以一个权重最右边的数字(不包括校验数字)到最左边。权重从2开始，每个数字加1。然后结果为11- (sum% 11)计算校验数字。
@ModCheck	被注解的元素表示验证一系列数字通过mod
@Normalized	验证字符序列是否为规范化形式，可以通过设置规范化策略来验证规范化值
@NotBlank	同StringUtils.isNotBlank，只作用在String上，在String属性上加上@NotBlank约束后，该属性不能为null且trim()之后size>0（同validation-api）【已禁用】
@NotEmpty	同StringUtils.isNotEmpty，作用在集合类上面，在Collection、Map、数组上加上@NotEmpty约束后，该集合对象是不能为null的，并且不能为空集，即size>0【已禁用】
@Range	被注释的元素必须在合适的范围内
@SafeHtml	验证用户提供的富文本，以确保它不包含恶意代码，如嵌入式元素。注意，这个约束假设您想要验证代表HTML文档正文片段的输入。如果你想要验证代表一个完整HTML文档的输入，在校验的白名单中添加HTML、head和body标记【已禁用】
@ScriptAssert	类级约束，它对脚本表达式求值注释的元素。此约束可用于实现验证日常活动，依赖于注释元素的多个属性。脚本表达式可以写在任何脚本或表达式语言中，其中的JSR
@UniqueElements	验证集合中的每个对象都是唯一的，即不能找到两个相等的元素集合，这对于JAX-RS很有用，它总是将集合反序列化为一个列表。因此，当重复的将其转换为一个集合时，会被隐式或默认的删除掉
@URL	验证带注释的字符串是一个URL，参数protocol、host和port对应URL的相应部分。可以加上一个额外的正则表达式regexp和flags可以进一步定制URL的验证标准。默认情况下，约束验证使用java.net.URL构造函数来验证字符串，这意味着匹配的协议处理程序需要可用，需要保证程序中以下协议的处理程序在默认JVM-HTTP、HTTPS、FTP文件和JAR中存在的

详解

空检查

@Null 验证对象是否为null
@NotNull：用在基本类型上面。验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank：用在String上面。检查约束字符串是不是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 对象是否符合正则表达式的规则

数值检查

建议使用在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”) private BigDecimal wage;

@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber信用卡验证
@Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)