Java Bean Annotation Constraint Validation 未完待续

边学边用，有问题欢迎指出。

Chapter 1. 简单的 Annotation Constraint 的使用

package tutorial.chapter01;import javax.validation.constraints.Min;import javax.validation.constraints.NotNull;import javax.validation.constraints.Size;public class Car {@NotNullprivate String manufacturer;@NotNull@Size(min = 2, max = 14)private String licensePlate;@Min(2)private int seatCount;public Car(String manufacturer, String licencePlate, int seatCount) {this.manufacturer = manufacturer;this.licensePlate = licencePlate;this.seatCount = seatCount;}}

以上的代码片段，我们应用annotation 来限制 

1.  `manufacturer`不为 null

2. `licensePlate` string的长度在 2-14之间

3. ·seaCount· 的值最小为2

使用一下代码片段来检验

package tutorial.chapter01;import java.util.Set;import javax.validation.ConstraintViolation;import javax.validation.Validation;import javax.validation.Validator;import javax.validation.ValidatorFactory;import org.junit.BeforeClass;import org.junit.Test;import static org.junit.Assert.assertEquals;public class CarTest {private static Validator validator;@BeforeClass    public static void setUp() {        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();        validator = factory.getValidator();    }    @Test    public void manufacturerIsNull() {        Car car = new Car( null, "DD-AB-123", 4 );        Set<ConstraintViolation<Car>> constraintViolations =                validator.validate( car );//这里我们故意将manufacture 设成 null, 其他项是正确的，我们将返回一个相对应的violation        assertEquals( 1, constraintViolations.size() );        assertEquals( "may not be null", constraintViolations.iterator().next().getMessage() );    }    @Test    public void licensePlateTooShort() {        Car car = new Car( "Morris", "D", 4 );        Set<ConstraintViolation<Car>> constraintViolations =                validator.validate( car );        assertEquals( 1, constraintViolations.size() );        assertEquals(                "size must be between 2 and 14",                constraintViolations.iterator().next().getMessage()        );    }    @Test    public void seatCountTooLow() {        Car car = new Car( "Morris", "DD-AB-123", 1 );        Set<ConstraintViolation<Car>> constraintViolations =                validator.validate( car );        assertEquals( 1, constraintViolations.size() );        assertEquals(                "must be greater than or equal to 2",                constraintViolations.iterator().next().getMessage()        );    }    @Test    public void carIsValid() {        Car car = new Car( "Morris", "DD-AB-123", 2 );        Set<ConstraintViolation<Car>> constraintViolations =                validator.validate( car );        assertEquals( 0, constraintViolations.size() );    }}

当我们使用 annotation的时候， 编译并执行的时候并不会给我们的限制进行检验，想要检验我们的变量是否满足我们的annotation的限制的时候我们需要使用`ValidatorFactory` 来创建一个 Validator instance. Validator.validate() 方法将会返回 a set of ConstraintViolation.  我们就可以通过观察 这个set来看看我们哪个 变量不符合限制。

Chapter 2. 

不同等级的 annotation 

a. 变量级别 ：从以下代码片段可以看出，我们对class 的变量使用了annotation。这个chapter 1的例子是一样的。

package org.hibernate.validator.referenceguide.chapter02.fieldlevel;public class Car {    @NotNull    private String manufacturer;    @AssertTrue    private boolean isRegistered;    public Car(String manufacturer, boolean isRegistered) {        this.manufacturer = manufacturer;        this.isRegistered = isRegistered;    }    //getters and setters...}

b. 方法级别: 以下 的作用和以上是一样的，因为当我们 对方法进行限制的时候我们实际上是对它的 返回类型进行限制。

package org.hibernate.validator.referenceguide.chapter02.propertylevel;public class Car {    private String manufacturer;    private boolean isRegistered;    public Car(String manufacturer, boolean isRegistered) {        this.manufacturer = manufacturer;        this.isRegistered = isRegistered;    }    @NotNull    public String getManufacturer() {        return manufacturer;    }    public void setManufacturer(String manufacturer) {        this.manufacturer = manufacturer;    }    @AssertTrue    public boolean isRegistered() {        return isRegistered;    }    public void setRegistered(boolean isRegistered) {        this.isRegistered = isRegistered;    }}

c. class 级别: 这个是对整个的类的内容进行限制，需要我们自己根据需求进行定制。 以后会提到，先从基础来。

d. 因为不同级别的annotation，我们就会问那夫类和子类之间的继承或者接口是怎么处理的。很好的问题，其实也很简单，那就是无论是继承还是实现我们都会原封不动的接受得到的限制。但是！ 接收到的限制不一定会表达，例如以下的例子。 如果我们把 @Valid 注释掉，然后我门对Car 进行 validate， 那么 Person 类是不会被 validate的。要想在validate Car的时候也Validate person那我们需要加上@Valid annotation. 

package org.hibernate.validator.referenceguide.chapter02.objectgraph;public class Car {    @NotNull    //@Valid    private Person driver;    //...}

package org.hibernate.validator.referenceguide.chapter02.objectgraph;public class Person {    @NotNull    private String name;    //...}

@Valid的作用简单来说就是继续validate 被@Valid 标记的变脸内部的变脸

e.g. 这样的话我们仅仅validate来list是否是 null

@NotNullList<Person> list;

加上valid 才会继续去validate person内部。

@NotNull@ValidList<Person> list;

e. 当得到 constraint violation 之后我门如何通过 ConstraintViolation 的instance来找到我门的violation.

Java Doc - ConstraintViolation 这里是他的方法。我就拿其中一个我觉的有点意思的举个例子. 考虑以下代码，当我们实例化一个valid 的car和person 但是 personname 的age是错的。那当我们得到constraintviolation怎么知道personname的路径在哪里呢？ 使用: 

gePropertyPath()

结果是 

driver.personName.age

Class Car {  @NotNull  @Valid  Person person;  //.....}Class  Person {  @NotNull  @Valid  PersonName personName;  //...}Class PersonName {  @Min(18)  int age;}

Chapter 03: 方法的parameter 和 return value 的constraint

这章总结来看，主要介绍了如何给一个方法的paramter 和 return value进行constraint validate.