Using Java EE 6 Bean Validation

Question

I am trying to use Java EE 6 Validation as specified here

http://docs.oracle.com/javaee/6/tutorial/doc/gircz.html

I have annotated a simple field

Answer 1

Just putting a constraint annotation to a field will not cause its evaluation. Instead some mechanism must trigger validation via the javax.validation.Validator API; this happens transparently e.g. for JPA entities, properties bound to JSF input elements or constrained methods of CDI beans in Java EE 7. If you want to validate an un-managed POJO, you have to invoke the validator yourself.

Answer 2

Your use of the annotations is just fine. There's a validator implementation for each of those rest assured.

However, at some point you need to trigger the validation of this POJO. If it were an @Entity it would be your JPA provider which triggers validation, in your case you need to do it yourself.

There's a nice documentation for Hibernate Validator which is the reference implementation for JSR-303.

Example

public class Car {
    @NotNull
    @Valid
    private List<Person> passengers = new ArrayList<Person>();
}

Using Car and validating:

Car car = new Car( null, true );

ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
Validator validator = factory.getValidator();
Set<ConstraintViolation<Car>> constraintViolations = validator.validate( car );

assertEquals( 1, constraintViolations.size() );
assertEquals( "may not be null", constraintViolations.iterator().next().getMessage() );

You may also want to read how bean validation is integrated with other frameworks (JPA, CDI, etc.).