在BeanValidation1.1中,约束注解不但可以应用在JavaBean和它们的属性上面,还可以应用在任何类型的方法的参数和返回值上面。
一、引言
方法约束这种方式,有下列几种方式:
- 在方法或构造器之前,调用方必须满足的先决条件(通过可执行的参数应用约束)。
- 在方法或构造器之后,保证给调用者的后置条件(通过对可执行文件的返回值应用约束)。
为了讲解的目的,如果没有另外说明,方法约束指的是两个,方法和构造器约束。有时可执行的类型指的是方法和构造器。
与传统的方法相比,这种方法在参数和返回值方面有个优点:
- 检查不需要手动执行(例如,通过抛出一个异常或者是相似的),产生更少的代码,更少的维护。
- 一个可执行的前置后置的条件不用再一次表示在它的文档中,自从约束注解可以自动的包括在生成的java文档中,这避免了冗余,并减少了在实现和文档之间不一致。
为了使注解显示在带注释的javadoc文档中,这些注解类型必须被注解上元数据类型@Documented。这是所有内置约束的情况,被认为是任何自定义约束的最佳实践。
在本篇的后续文章,你将学习如何通过使用ExecutableValidator API,声明参数和返回值约束,如何验证它们。