如何使用java validation api進行參數校驗----Hibernate-Validation

在平常開發中，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

舉個使用的例子：

 

1.  
   public class User {
2.  
    
3.  
   @NotBlank
4.  
   private String name;
5.  
    
6.  
   //年齡要大於18歲
7.  
   @Min(18)
8.  
   private int age;
9.  
    
10.  
    @Email
11.  
    private String email;
12.  
     
13.  
    //嵌套驗證
14.  
    @Valid
15.  
    private Product products;
16.  
     
17.  
    ... //省略getter，setter
18.  
    }
19.  
     
20.  
    public class Product {
21.  
     
22.  
    @NotBlank
23.  
    private String name;
24.  
     
25.  
    //價格在10元-50元之間
26.  
    @Range(min=10,max=50)
27.  
    private int price;
28.  
     
29.  
    ... //省略getter，setter
30.  
    }

本人當時測試引入的依賴爲：

 

1.  
   <dependency>
2.  
   <groupId>org.hibernate</groupId>
3.  
   <artifactId>hibernate-validator</artifactId>
4.  
   <version>5.3.4.Final</version>
5.  
   </dependency>
6.  
   <dependency>
7.  
   <groupId>javax.el</groupId>
8.  
   <artifactId>javax.el-api</artifactId>
9.  
   <version>2.2.4</version>
10.  
    </dependency>
11.  
    <dependency>
12.  
    <groupId>org.glassfish.web</groupId>
13.  
    <artifactId>javax.el</artifactId>
14.  
    <version>2.2.4</version>
15.  
    </dependency>