Hibernate Validator 第11篇：返回值约束

在一些例子中，一个约束既可以应用在可执行的参数上，又可以应用在返回值上。这种情况的一个例子是自定义约束，它允许通过脚本或EL（表达式语言），指定一个校验规则。

一、返回值约束

这样的约束，必须定一个个成员validationAppliesTo()。它可以用在声明的时机，指定约束的目标。

如下例，在其中我们在一个可执行参数上，通过指定：

• validationAppliesTo = ConstraintTarget.PARAMETER，
• ConstraintTarget.RETURN_VALUE，应用这种约束。

public class Garage {    
    @ELAssert(expression = "...", validationAppliesTo = ConstraintTarget.PARAMETERS)    
    public Car buildCar(List<Part> parts) {   
     //...       
       return null;   
    }    
    @ELAssert(expression = "...", validationAppliesTo = ConstraintTarget.RETURN_VALUE)    
    public Car paintCar(int color) {      
    //...     
        return null;   
    }
}

尽管这个约束可以应用在参数和返回值上，但是这个目标被自动的推断。下面是这种情况，如果约束被定义在这些上面的话：

• 一个void的带有参数的方法（约束可以应用在参数上）。
• 一个带有返回值，没有参数（约束应用在返回值上）的可执行的方法。

在这些情况中，我们不必指定约束的目标，当然为了增加代码的可读性，还是推荐这样做。如果约束目标在这些情况中没有指定。

它不能被自动的判断，会引起一个ConstraintDeclarationException。

一个方法或构造器的后置条件，可以通过加一个约束注解来实现，见如下例子：

public class RentalStation {    
    @ValidRentalStation    
    public RentalStation() {        
    //...    
    }    
    @NotNull    
    @Size(min = 1)    
    public List<@NotNull Customer> getCustomers() {      
     //...   
       return null;   
    }
}

• 任何新创建的RentalStation对象，必须满足这个@ValidRentalStation约束。
• getCustomers()返回的list，必须不能是null 的，必须包含至少一个元素。
• getCustomers()返回的list，必须不能包含null对象。