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

舉個使用的例子：

public class User {

    @NotBlank
    private String name;

    //年齡要大於18歲
    @Min(18)
    private int age;

    @Email
    private String email;

    //嵌套驗證
    @Valid
    private Product products;

    ... //省略getter，setter
}

public class Product {

    @NotBlank
    private String name;

    //價格在10元-50元之間
    @Range(min=10,max=50)
    private int price;

    ... //省略getter，setter
}

public class User {
	
	@NotBlank
	private String name;
	
	//年齡要大於18歲
	@Min(18)
	private int age;

	@Email
	private String email;
	
	//嵌套驗證
	@Valid
	private Product products;
	
	... //省略getter，setter
}

public class Product {
	
	@NotBlank
	private String name;
	
	//價格在10元-50元之間
	@Range(min=10,max=50)
	private int price;
	
	... //省略getter，setter
}

轉載地址：http://blog.csdn.net/u011851478/article/details/51842157