SpringMVC（20）：資料校驗功能 -- 使用JSR303實作伺服器端的資料校驗

2018年1月24日

一、JSR-303 簡介

JSR-303 是 Java EE 6 中的一項子規範，叫做 Bean Validation，官方參考實作是Hibernate Validator。此實作與 Hibernate ORM 沒有任何關系。 JSR 303 用于對 Java Bean 中的字段的值進行驗證。 Spring MVC 3.x 之中也大力支援 JSR-303，可以在控制器中對表單送出的資料友善地驗證。 

注:可以使用注解的方式進行驗證。

二、作用及使用場景

1.JSR 303 用于對Java Bean 中的字段的值進行驗證,使得驗證邏輯從業務代碼中脫離出來。

2.是一個運作時的資料驗證架構，在驗證之後驗證的錯誤資訊會被馬上傳回。

使用場景：一般用于表單送出頁面。

三、準備校驗時使用的Jar

1.1 validation-api-1.0.0.GA.jar：JDK的接口；

1.2 hibernate-validator-4.2.0.Final.jar是對上述接口的實作；

1.3 log4j、slf4j、slf4j-log4j

四、案例分析

空檢查

@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=)