JSR 303 - Bean Validation 初试

正学习Spring 3，发现其中的validation使用了JSR303的RI实现，这为何物？如何使用？抱着疑问，写个例子瞅瞅先。
 TestJSR303.rar  

ValidationMessages.properties

me.test.Pattern.message=必须匹配正则表达式 "{regexp}"
me.test.NotNull.message=不能为null
me.test.Min.message=必须大于等于{value}
me.test.Max.message=必须小于等于{value}
me.test.Size.message=长度必须位于{min}和{max}之间

Person.java

package me.test;

import javax.validation.constraints.Max;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;
import javax.validation.constraints.Size;

public class Person {

    @Pattern(regexp = "^U\\d{3}$", message = "{me.test.Pattern.message}")
    private String id;

    @NotNull(message = "用户名不能为null")
    private String name;

    @Min(value = 1, message = "{me.test.Min.message}")
    @Max(value = 150)
    private Integer age;

    @Size(min = 5, max = 10, message = "地址长度不能为>={min} && <=10")
    private String address = null;

    // getter && setter
}

PersonTest.java

package me.test;

import java.util.ResourceBundle;
import java.util.Set;

import javax.validation.Configuration;
import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ValidatorFactory;

import junit.framework.TestCase;

import org.hibernate.validator.engine.ResourceBundleMessageInterpolator;
import org.junit.Before;
import org.junit.Test;

/**
 * 什么是JSR303-Bean Validation?
 *  是一套类似于Apache Commons Validator，但是可以通过注解进行配置，
 *  也可以通过XML文件进行配置。
 *
 *
 * 参考实现：
 *  Hibernate Validator
 *
 *
 * 注意：
 *  Hibernate Validator 4.2.0.Beta2版本的压缩包中包含中文的文档，在线看时总#￥@的被连接重置。
 *  但这个工程里我使用的是 4.1.0.Final 版
 *
 * 小结：
 *  1. 缺少一些感觉比较常用的Validate，
 *     比如，对字符串类型的日期格式验证。
 *      假如一个字段是"yyyyMMdd"格式的年月日字符串，
 *      可以通过@Pattern用正则表达式限定为全部为字符串，
 *      可是用户仍能发送"20011299" 或 "20010231"这样不存在的日期。
 *      JSR303中只提供了@Past,@Future以对java.util.Date和java.util.Calendar
 *      验证其是否是过去/将来的时间。
 *
 *     比如，如果要保证某个字符串的长队必须为某个固定的值，这时可以使用@Size，
 *     但是@Size是用来保证长度在一个区域内的，有个min和max，
 *     若把min和max设为某个固定值，则消息不太合适。
 *
 *  2. 该规范以及RI实现中只能够对单个字段进行Validate，没有类似Struts中使用的 validateWhen.
 *     若是能够提供一个使用EL表达式的类似实现就好了。
 *     也许这种验证应该拿到业务里进行验证吧？使用Spring的Validator？
 *
 *  RI实现中又扩展了4个注解：@Email,@Length,@NotEmpty,@Range
 *  其中@Length与规范中定义的@Size类似，但仅仅适用于string类型，而@Size则不限于String，还可以用于Collection,Map,Array
 *
 * 工程目录树：
 * /
 * |- src
 * |    |  ValidationMessages.properties
 * |     |- me
 * |      |- test
 * |                      Person.java
 * |                      PersonTest.java
 * |- lib:
 *           hibernate-validator-4.0.1.GA.jar
 *                jpa-api-2.0.Beta-20090815.jar
 *                log4j-1.2.14.jar
 *                slf4j-api-1.5.6.jar
 *                slf4j-log4j12-1.5.6.jar
 *                validation-api-1.0.0.GA.jar
 *                junit-4.6.jar
 *
 * @author [e-mail]
 *
 */
public class PersonTest {

    private Validator validator = null;

    @Before
    public void setUp() {
        if (validator == null) {
            // Configuration config = Validation.byDefaultProvider().configure();
            // config.messageInterpolator(new ResourceBundleMessageInterpolator(ResourceBundle.getBundle("me.test.ValidationMessages") ));
            // validator = config.buildValidatorFactory().getValidator();
            ValidatorFactory validatorFactory = Validation.buildDefaultValidatorFactory();
            validator = validatorFactory.getValidator();
        }
    }

    /**
     * 正常 - 全部检验通过
     */
    @SuppressWarnings("unchecked")
    @Test
    public void test001() {
        // ■ 准备环境
        // ■ 准备参数
        Person p = new Person();
        p.setId("U001");
        p.setName("zhang3");
        p.setAge(25);
        p.setAddress("abcdefg");
        // ■ 执行
        Set<ConstraintViolation<Person>> violations = validator.validate(p);
        // ■ 验证结果
        ConstraintViolation<Person>[] arr = violations.toArray(new ConstraintViolation[0]);
        TestCase.assertEquals(0, arr.length);
        // ■ 验证环境
    }

    /**
     * 异常 - id格式不正确
     */
    @SuppressWarnings("unchecked")
    @Test
    public void test002() {
        // ■ 准备环境
        // ■ 准备参数
        Person p = new Person();
        p.setId("U00X");
        p.setName("zhang3");
        p.setAge(25);
        p.setAddress("abcdefg");
        // ■ 执行
        Set<ConstraintViolation<Person>> violations = validator.validate(p);
        // ■ 验证结果
        ConstraintViolation<Person>[] arr = violations.toArray(new ConstraintViolation[0]);
        TestCase.assertEquals(1, arr.length);
        ConstraintViolation<Person> violation = arr[0];
        String propertyPath = violation.getPropertyPath().toString();
        TestCase.assertEquals("id", propertyPath);
        String message = violation.getMessage();
        TestCase.assertEquals("必须匹配正则表达式 \"^U\\d{3}$\"", message);
        // ■ 验证环境
    }

    /**
     * 异常 - name == null
     */
    @SuppressWarnings("unchecked")
    @Test
    public void test003() {
        // ■ 准备环境
        // ■ 准备参数
        Person p = new Person();
        p.setId("U001");
        p.setName(null);
        p.setAge(25);
        p.setAddress("abcdefg");
        // ■ 执行
        Set<ConstraintViolation<Person>> violations = validator.validate(p);
        // ■ 验证结果
        ConstraintViolation<Person>[] arr = violations.toArray(new ConstraintViolation[0]);
        TestCase.assertEquals(1, arr.length);
        ConstraintViolation<Person> violation = arr[0];
        String propertyPath = violation.getPropertyPath().toString();
        TestCase.assertEquals("name", propertyPath);
        String message = violation.getMessage();
        TestCase.assertEquals("用户名不能为null", message);
        // ■ 验证环境
    }

    /**
     * 异常 - age值的范围不正确(0)
     */
    @SuppressWarnings("unchecked")
    @Test
    public void test004() {
        // ■ 准备环境
        // ■ 准备参数
        Person p = new Person();
        p.setId("U001");
        p.setName("zhang3");
        p.setAge(0);
        p.setAddress("abcdefg");
        // ■ 执行
        Set<ConstraintViolation<Person>> violations = validator.validate(p);
        // ■ 验证结果
        ConstraintViolation<Person>[] arr = violations.toArray(new ConstraintViolation[0]);
        TestCase.assertEquals(1, arr.length);
        ConstraintViolation<Person> violation = arr[0];
        String propertyPath = violation.getPropertyPath().toString();
        TestCase.assertEquals("age", propertyPath);
        String message = violation.getMessage();
        TestCase.assertEquals("必须大于等于1", message);
        // ■ 验证环境
    }

    /**
     * 异常 - age值的范围不正确(200)
     */
    @SuppressWarnings("unchecked")
    @Test
    public void test005() {

        // ■ 准备环境
        // ■ 准备参数
        Person p = new Person();
        p.setId("U001");
        p.setName("zhang3");
        p.setAge(200);
        p.setAddress("abcdefg");
        // ■ 执行
        Set<ConstraintViolation<Person>> violations = validator.validate(p);
        // ■ 验证结果
        ConstraintViolation<Person>[] arr = violations.toArray(new ConstraintViolation[0]);
        TestCase.assertEquals(1, arr.length);
        ConstraintViolation<Person> violation = arr[0];
        String propertyPath = violation.getPropertyPath().toString();
        TestCase.assertEquals("age", propertyPath);
        String message = violation.getMessage();
        TestCase.assertEquals("must be less than or equal to 150", message);
        // ■ 验证环境
    }

    /**
     * 异常 - address长度不正确(3)
     */
    @SuppressWarnings("unchecked")
    @Test
    public void test006() {

        // ■ 准备环境
        // ■ 准备参数
        Person p = new Person();
        p.setId("U001");
        p.setName("zhang3");
        p.setAge(25);
        p.setAddress("abc");
        // ■ 执行
        Set<ConstraintViolation<Person>> violations = validator.validate(p);
        // ■ 验证结果
        ConstraintViolation<Person>[] arr = violations.toArray(new ConstraintViolation[0]);
        TestCase.assertEquals(1, arr.length);
        ConstraintViolation<Person> violation = arr[0];
        String propertyPath = violation.getPropertyPath().toString();
        TestCase.assertEquals("address", propertyPath);
        String message = violation.getMessage();
        TestCase.assertEquals("地址长度不能为>=5 && <=10", message);
        // ■ 验证环境
    }
}