Java EE 6核心特征:Bean Validation解析
Bean Validation是Java EE 6數據驗證新框架,Validation API并不依賴特定的應用層或是編程模型,這樣同一套驗證可由應用的所有層共享。它還提供了通過擴展Validation API來增加客戶化驗證約束的機制以及查詢約束元數據倉庫的手段。
在Java EE 6的Bean Validation出現之前,開發者不得不在表示層框架、業務層以及持久層中編寫驗證規則以保證這些規則的同步性,但這么做非常浪費時間而且極易出錯。Bean Validation是通過約束實現的,這些約束以注解的形式出現,注解可以放在JavaBean(如backing bean)的屬性、方法或是類上面。約束既可以是內建的注解(位于javax.validation.constraints包下面),也可以由用戶定義。一些常用的內建注解列舉如下:
◆Min:被@Min所注解的元素必須是個數字,其值要大于或等于給定的最小值。
◆Max:被@Max所注解的元素必須是個數字,其值要小于或等于給定的最大值。
◆Size:@Size表示被注解的元素必須位于給定的最小值和最大值之間。支持Size驗證的數據類型有String、Collection(計算集合的大?。ap以及數組。
◆NotNull:@NotNull確保被注解的元素不能為null。
◆Null:@Null確保被注解的元素一定為null。
◆Pattern:@Pattern確保被注解的元素(String)一定會匹配給定的Java正則表達式。
代碼中通過Bean Validation注解聲明了一些約束:
- public class Address {
- @NotNull @Size(max=30)
- private String addressline1;
- @Size(max=30)
- private String addressline2;
- public String getAddressline1() {
- return addressline1;
- }
- public void setAddressline1(String addressline1) {
- this.addressline1 = addressline1;
- }
- }
@NotNull指定被注解的元素addressline1不能為null;@Size指定被注解的元素addressline1和addressline2不能超過給定的最大值,即30個字符。
在驗證Address對象時,addressline1的值被傳遞到針對@NotNull約束的驗證類以及針對@Size約束的驗證類中,而addressline2的值被傳遞到針對@Size約束的驗證類中,由相關的驗證類進行驗證。如下代碼自定義了一個名為ZipCode的約束:
- @Size(min=5, max=5)
- @ConstraintValidator(ZipcodeValidator.class)
- @Documented
- @Target({ANNOTATION_TYPE, METHOD, FIELD})
- @Retention(RUNTIME)
- public @interface ZipCode {
- String message() default "Wrong zipcode";
- String[] groups() default {};
- }
可以將@ZipCode用在類、屬性或是方法上,就像其他約束一樣。
- public class Address {
- @ZipCode
- private String zipCode;
- public String getZipCode() {
- return zipCode;
- }
- public void setZipCode(String zipCode) {
- this.zipCode = zipCode;
- }
- }
Validation API
開發者可以借助于Validation API以編程的方式驗證JavaBean。Bean Validation API的默認包是javax.validation。下面對該包中的一些類進行說明:
ConstraintValidator:這是一個接口,具體的約束驗證類需要實現該接口。該接口定義了相關的邏輯以驗證給定對象類型中的約束。
Validator:Validahttp://java.sun.com/javaee/6/docs/api/index.html?javax/validation/Validator.htmltor接口持有對象驗證圖的契約。該接口的實現必須是線程安全的。
ConstraintViolation:ConstraintViolation接口表示給定bean上的約束驗證失敗,它公開了約束違背上下文以及描述該違背情況的信息。
ValidationException:如果在驗證過程中出現了某些不可恢復的錯誤就會拋出ValidationException異常。某些情況下可以指定該異常,如不合法的分組(group)定義、不合法的約束定義以及不合法的約束聲明等等。
約束元數據請求API
Bean Validation規范提供了查詢約束倉庫的手段。該API主要用于工具支持和與其他框架、庫以及JSR的集成。Bean Validation規范旨在為對象約束提供一個驗證引擎和元數據倉庫。需要進行約束定義、驗證和元數據的框架(Java EE或Java SE)可以利用Bean Validation規范完成這些功能,從應用或是基礎設施的角度來看,這么做可以避免不必要的重復工作。
Bean Validation已經集成到了JSF 2.0和JPA 2.0中。在JSF中可以將表單輸入域與域對象的屬性綁定起來。JSF 2和Bean Validation可以判斷出綁定的是哪個屬性并執行與之相關的驗證,還會將約束違背的信息顯示給用戶。Hibernate Validator 4是Bean Validation規范的參考實現框架,其最新版增加了不少新特性,如分組驗證、與JPA 2和JSF 2的自然集成以及擴展的注解集等等。
【編輯推薦】