mvn archetype:generate -DarchetypeGroupId=org.hibernate ???????????????????????-DarchetypeArtifactId=hibernate-validator-quickstart-archetype ???????????????????????-DarchetypeVersion=4.2.0.Final ???????????????????????-DarchetypeRepository=http://repository.jboss.org/nexus/content/groups/public-jboss/ ???????????????????????-DgroupId=com.mycompany ???????????????????????-DartifactId=hv-quickstart

packagecom.mycompany;importjavax.validation.constraints.Min;importjavax.validation.constraints.NotNull;importjavax.validation.constraints.Size;publicclassCar{@NotNullprivateStringmanufacturer;@NotNull@Size(min=2,max=14)privateStringlicensePlate;@Min(2)privateintseatCount;publicCar(Stringmanufacturer,StringlicencePlate,intseatCount){this.manufacturer=manufacturer;this.licensePlate=licencePlate;this.seatCount=seatCount;}//gettersandsetters...}

packagecom.mycompany;importstaticorg.junit.Assert.*;importjava.util.Set;importjavax.validation.ConstraintViolation;importjavax.validation.Validation;importjavax.validation.Validator;importjavax.validation.ValidatorFactory;importorg.junit.BeforeClass;importorg.junit.Test;publicclassCarTest{privatestaticValidatorvalidator;@BeforeClasspublicstaticvoidsetUp(){ValidatorFactoryfactory=Validation.buildDefaultValidatorFactory();validator=factory.getValidator();}@TestpublicvoidmanufacturerIsNull(){Carcar=newCar(null,"DD-AB-123",4);Set<ConstraintViolation<Car>>constraintViolations=validator.validate(car);assertEquals(1,constraintViolations.size());assertEquals("maynotbenull",constraintViolations.iterator().next().getMessage());}@TestpublicvoidlicensePlateTooShort(){Carcar=newCar("Morris","D",4);Set<ConstraintViolation<Car>>constraintViolations=validator.validate(car);assertEquals(1,constraintViolations.size());assertEquals("sizemustbebetween2and14",constraintViolations.iterator().next().getMessage());}@TestpublicvoidseatCountTooLow(){Carcar=newCar("Morris","DD-AB-123",1);Set<ConstraintViolation<Car>>constraintViolations=validator.validate(car);assertEquals(1,constraintViolations.size());assertEquals("mustbegreaterthanorequalto2",constraintViolations.iterator().next().getMessage());}@TestpublicvoidcarIsValid(){Carcar=newCar("Morris","DD-AB-123",2);Set<ConstraintViolation<Car>>constraintViolations=validator.validate(car);assertEquals(0,constraintViolations.size());}}

2.1.1.字段级(field level) 约束

例2.1.字段级(field level) 约束

packagecom.mycompany;importjavax.validation.constraints.NotNull;publicclassCar{@NotNullprivateStringmanufacturer;@AssertTrueprivatebooleanisRegistered;publicCar(Stringmanufacturer,booleanisRegistered){super();this.manufacturer=manufacturer;this.isRegistered=isRegistered;}}

注意

这个字段的访问级别( private, protected 或者 public) 对此没有影响.

注意

静态字段或者属性是不会被校验的.

2.1.2.属性级别约束

注意

如果要定义约束在属性级别上的话,那么只能定义在访问器(getter)上面,不能定义在修改器(setter)上.

例2.2.属性级约束

packagecom.mycompany;importjavax.validation.constraints.AssertTrue;importjavax.validation.constraints.NotNull;publicclassCar{privateStringmanufacturer;privatebooleanisRegistered;publicCar(Stringmanufacturer,booleanisRegistered){super();this.manufacturer=manufacturer;this.isRegistered=isRegistered;}@NotNullpublicStringgetManufacturer(){returnmanufacturer;}publicvoidsetManufacturer(Stringmanufacturer){this.manufacturer=manufacturer;}@AssertTruepublicbooleanisRegistered(){returnisRegistered;}publicvoidsetRegistered(booleanisRegistered){this.isRegistered=isRegistered;}}

提示

It is recommended to stick either to fieldorproperty annotations within one class. It is not recommended to annotate a fieldandthe accompanying getter method as this would cause the field to be validated twice.

2.1.3.类级别约束

例2.3.类级别约束

packagecom.mycompany;importjavax.validation.constraints.Min;importjavax.validation.constraints.NotNull;importjavax.validation.constraints.Size;@PassengerCountpublicclassCar{@NotNullprivateStringmanufacturer;@NotNull@Size(min=2,max=14)privateStringlicensePlate;@Min(2)privateintseatCount;privateList<Person>passengers;publicCar(Stringmanufacturer,StringlicencePlate,intseatCount){this.manufacturer=manufacturer;this.licensePlate=licencePlate;this.seatCount=seatCount;}//gettersandsetters...}

2.1.4.约束继承

例2.4.约束继承

packagecom.mycompany;importjavax.validation.constraints.NotNull;publicclassRentalCarextendsCar{privateStringrentalStation;publicRentalCar(Stringmanufacturer,StringrentalStation){super(manufacturer);this.rentalStation=rentalStation;}@NotNullpublicStringgetRentalStation(){returnrentalStation;}publicvoidsetRentalStation(StringrentalStation){this.rentalStation=rentalStation;}}

2.1.5.对象图

例2.5.Class Person

packagecom.mycompany;importjavax.validation.constraints.NotNull;publicclassPerson{@NotNullprivateStringname;publicPerson(Stringname){super();this.name=name;}publicStringgetName(){returnname;}publicvoidsetName(Stringname){this.name=name;}}

例2.6.Adding a driver to the car

packagecom.mycompany;importjavax.validation.Valid;importjavax.validation.constraints.NotNull;publicclassCar{@NotNull@ValidprivatePersondriver;publicCar(Persondriver){this.driver=driver;}//gettersandsetters...}

• 数组

• 实现了java.lang.Iterable接口( 例如Collection,List和Set)

• 实现了java.util.Map接口

例2.7.Car with a list of passengers

packagecom.mycompany;importjava.util.ArrayList;importjava.util.List;importjavax.validation.Valid;importjavax.validation.constraints.NotNull;publicclassCar{@NotNull@ValidprivateList<Person>passengers=newArrayList<Person>();publicCar(List<Person>passengers){this.passengers=passengers;}//gettersandsetters...}

注意

对象图校验的时候是会被忽略null值的.

2.2.1.获取一个Validator的实例

例2.8.Validation.buildDefaultValidatorFactory()

ValidatorFactoryfactory=Validation.buildDefaultValidatorFactory();Validatorvalidator=factory.getValidator();

2.2.2.Validator中的方法

使用validate()方法对一个给定的实体对象中定义的所有约束条件进行校验 (例2.9 “Validator.validate() 使用方法”).

ValidatorFactoryfactory=Validation.buildDefaultValidatorFactory();Validatorvalidator=factory.getValidator();Carcar=newCar(null);Set<ConstraintViolation<Car>>constraintViolations=validator.validate(car);assertEquals(1,constraintViolations.size());assertEquals("maynotbenull",constraintViolations.iterator().next().getMessage());

通过validateProperty()可以对一个给定实体对象的单个属性进行校验. 其中属性名称需要符合JavaBean规范中定义的属性名称.

Validatorvalidator=Validation.buildDefaultValidatorFactory().getValidator();Carcar=newCar(null);Set<ConstraintViolation<Car>>constraintViolations=validator.validateProperty(car,"manufacturer");assertEquals(1,constraintViolations.size());assertEquals("maynotbenull",constraintViolations.iterator().next().getMessage());

例如,Validator.validateProperty可以被用在把Bean Validation集成进JSF 2中的时候使用 (请参考第7.4节 “展示层校验”).

通过validateValue()方法,你能够校验如果把一个特定的值赋给一个类的某一个属性的话,是否会违反此类中定义的约束条件.

Validatorvalidator=Validation.buildDefaultValidatorFactory().getValidator();Set<ConstraintViolation<Car>>constraintViolations=validator.validateValue(Car.class,"manufacturer",null);assertEquals(1,constraintViolations.size());assertEquals("maynotbenull",constraintViolations.iterator().next().getMessage());