Hibernate Validator

hibernate Validator 是 Bean Validation 的參考實現 。Hibernate Validator 提供了 JSR 303 規範中全部內置 constraint 的實現，除此以外還有一些附加的 constraint。

在平常開發中，Hibernate Validator常常用來驗證bean的字段，基於註解，方便快捷高效。

 

1. Bean Validation 中內置的 constraint

           註解                                      做用

 

@Valid	被註釋的元素是一個對象，須要檢查此對象的全部字段值
@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)	被註釋的元素必須符合指定的正則表達式

2. Hibernate Validator 附加的 constraint

註解	做用
@Email	被註釋的元素必須是電子郵箱地址
@Length(min=, max=)	被註釋的字符串的大小必須在指定的範圍內
@NotEmpty	被註釋的字符串的必須非空
@Range(min=, max=)	被註釋的元素必須在合適的範圍內

@NotBlank	被註釋的字符串的必須非空
@URL(protocol=, host=,    port=,  regexp=, flags=)	被註釋的字符串必須是一個有效的url
@CreditCardNumber	被註釋的字符串必須經過Luhn校驗算法， 銀行卡，信用卡等號碼通常都用Luhn 計算合法性
@ScriptAssert (lang=, script=, alias=)	要有Java Scripting API 即JSR 223  ("Scripting for the JavaTM Platform")的實現
@SafeHtml (whitelistType=,  additionalTags=)	classpath中要有jsoup包

hibernate補充的註解中，最後3個不經常使用，可忽略。

 

主要區分下@NotNull  @NotEmpty  @NotBlank 3個註解的區別：

@NotNull           任何對象的value不能爲null

@NotEmpty       集合對象的元素不爲0，即集合不爲空，也能夠用於字符串不爲null

@NotBlank        只能用於字符串不爲null，而且字符串trim()之後length要大於0