Java EE 6 Bean Validation提供了实体验证元数据模型与API

20顶
1踩

2010-03-23 08:31 by 正式记者 YiSingQ 评论(20) 有10134人浏览

Bean Java

声明：ITeye资讯文章的版权属于ITeye网站所有，严禁任何网站转载本文，否则必将追究法律责任！

Bean Validation（JSR 303）——Java EE 6的一个核心特性，它为实体验证定义了一个元数据模型和API。其默认的元数据源是注解，但开发者可以通过XML描述符对其进行扩展。Validation API并不依赖特定的应用层或是编程模型，这样同一套验证可由应用的所有层共享。它还提供了通过扩展Validation API来增加客户化验证约束的机制以及查询约束元数据仓库的手段。

在JEE6的Bean Validation出现之前，开发者不得不在表示层框架、业务层以及持久层中编写验证规则以保证这些规则的同步性，但这么做非常浪费时间而且极易出错。Bean Validation是通过约束实现的，这些约束以注解的形式出现，注解可以放在JavaBean（如backing bean）的属性、方法或是类上面。约束既可以是内建的注解（位于javax.validation.constraints包下面），也可以由用户定义。一些常用的内建注解列举如下：

Min：被@Min所注解的元素必须是个数字，其值要大于或等于给定的最小值。
Max：被@Max所注解的元素必须是个数字，其值要小于或等于给定的最大值。
Size：@Size表示被注解的元素必须位于给定的最小值和最大值之间。支持Size验证的数据类型有String、Collection（计算集合的大小）、Map以及数组。
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的自然集成以及扩展的注解集等等。

分享到：

20
顶

1
踩

评论共 20 条请登录后发表评论

20 楼 star022 2010-04-18 21:57

rainv 写道

加个验证过滤层不行？要注解干嘛。。
请求-独立验证层-action..

这样设计是不合适的，
这些数据验证一般都是些简单的验证，如数据长度，是否为null之类的，
完全没有业务逻辑的，
从高内聚的角度看，这些基本验证放在实体模型层合适。

19 楼 shinezhou 2010-03-25 23:22

不错~

18 楼 lkf520java 2010-03-25 19:42

我想知道如果数据不符合验证规则，错误信息会以什么方式提示出来？
还想问的是，这个是服务器端验证还是客户端验证？

17 楼 passnet 2010-03-25 16:40

seam中早已经借助hibernate实现了相应的机制

16 楼 mercyblitz 2010-03-24 15:17

这个东西，自己实现了

15 楼 yidao620c 2010-03-24 15:04

star022 写道

3年前，差点冲动自己搞出这么一套自定义注解~~

其实你本应该冲动一把的。

14 楼 zcq100 2010-03-24 13:31

注解还是相当实用的，在很多的地方能简化开发。

13 楼 protel.robin 2010-03-24 09:58

和使用xml解析各有优点，看使用习惯吧！

12 楼 treblesoftware 2010-03-24 09:45

有了这个功能好多了，免得去写那恶心的size()<30等等这些东西。数据归根到底还是给数据自己进行验证，设计的不错。

11 楼 Diego玄霄 2010-03-24 09:34

是个不错的想法，但问题是，不符合验证的数据， JVM会怎么处理？抛异常？

10 楼 workfish 2010-03-24 09:23

不喜欢这样的思路，一堆注解感觉好乱，而且缺乏逻辑性，对程序员的要求太高了，而且所谓的提示还是需要自己的重新定制的，没办法直接使用，还不如添加一个类似于验证代理框架

9 楼 rainv 2010-03-23 18:03

加个验证过滤层不行？要注解干嘛。。
请求-独立验证层-action..

8 楼 star022 2010-03-23 15:08

3年前，差点冲动自己搞出这么一套自定义注解~~

7 楼 xieyongwei 2010-03-23 15:05

这个是很好的发展
可惜来的有点迟了
还有JavaEE6成为业界通用平台也还需要时间

6 楼 sosyi 2010-03-23 14:49

怎么像 JPA？？

5 楼 niyong 2010-03-23 12:35

晕，重复劳动

4 楼 zhu_chen001 2010-03-23 10:02

注解太多了不是好事情

3 楼毕竟红尘 2010-03-23 10:00

这种思路看起来不错...

2 楼 mdream 2010-03-23 09:56

以前用过hibernate Validator的，感觉一般。不知道Bean Validation会有多少优越感。

1 楼 aofeng 2010-03-23 09:14

这样以后的校验代码是完全独立的，不需要每个方法中加一小段代码完成校验，一个注解或几个注解搞定。代码看起来更舒服。

发表评论

您还没有登录,请您登录后再发表评论

20顶1踩