Spring MVC自定义验证注释

在上一教程中，我展示了如何使用注释来验证表单。这对于简单的验证非常有用，但是最终，您需要验证一些现成的注释中没有的自定义规则。例如，如果您需要根据输入的出生日期来验证用户已超过21岁，或者可能需要验证用户的电话区号在美国内布拉斯加州，该怎么办。本教程包含完整的源代码，将显示如何创建自定义验证注释，您可以在上一教程中探讨的JSR-303和Hibernate Validator注释中使用这些注释。

如果您想继续，可以在GitHub上获取本教程的代码。

对于此示例，假设我们有一个带有电话号码字段和生日日期字段的表单，并且我们要验证电话号码是否有效（简单检查格式）以及该用户出生于1989年。支持这些的现成的注释（据我所知），因此我们将编写自定义验证注释，然后可以重复使用它们，就像内置的JSR-303一样。

完成后，我们将注释应用于表单对象，如下所示：

public class Subscriber {...@Phoneprivate String phone;@Year(1989)private Date birthday;// getters setters ...}

让我们开始使用@Phone批注。我们将创建两个类： Phone （即批注）和PhoneConstraintValidator其中包含验证逻辑）。第一步是创建Phone注释类：

@Documented
@Constraint(validatedBy = PhoneConstraintValidator.class)
@Target( { ElementType.METHOD, ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface Phone {String message() default "{Phone}";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};}

上面的代码大部分只是样板。 JSR-303规范要求使用批注中的三种方法。如果我们的注释接受了任何参数，那么我们将在那里定义为方法。我们将在本教程后面的下一个批注中看到这一点。上面的类中最重要的部分是该类上的@Constraint批注，该批注指定我们将使用PhoneConstraintValidator类进行验证逻辑。 message()方法定义如何解析消息。通过指定“ {Phone}”，我们可以使用Phone键覆盖Spring资源束中的消息（有关消息的详细信息，请参见我的其他验证教程）。

现在，我们定义约束验证器：

public class PhoneConstraintValidator implements ConstraintValidator<Phone, String> {@Overridepublic void initialize(Phone phone) { }@Overridepublic boolean isValid(String phoneField, ConstraintValidatorContext cxt) {if(phoneField == null) {return false;}return phoneField.matches("[0-9()-\.]*");}}

让我们看一下上面的代码。超类的模板化类型有两种类型：它支持的注释的类型和它验证的属性的类型（在此示例中为Phone，String）。

“ initialize”方法在此处为空，但可用于保存注释中的数据，如下面定义其他注释时所见。

最后，实际的逻辑发生在“ isValid”方法中。字段值作为第一个参数传入，我们在这里进行验证。如您所见，我只是在验证电话号码仅包含数字，括号或破折号。

就是这个注解！现在可以在字段上使用批注，如上面在我们的表单对象上所示。

现在，让我们做第二个注释。这个有点人为的-我们将验证用户的生日是在1989年。不过，将来，我们可能需要验证日期在其他年份，因此，我们而不是创建用于验证年份为1989年的注释。将使用一个参数来指定要验证的年份。用法示例：

@Year(1989)
private Date birthDate;

现在，注释：

@Documented
@Constraint(validatedBy = YearConstraintValidator.class)
@Target( { ElementType.METHOD, ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface Year {int value();String message() default "{Year}";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};}

注意“ value（）”方法。这暴露了注释的“值”参数，我们将使用它传递注释应针对的年份。其余代码大部分都是样板

现在，约束验证器：

public class YearConstraintValidator implements ConstraintValidator<Year, Date> {private int annotationYear;@Overridepublic void initialize(Year year) {this.annotationYear = year.value();}@Overridepublic boolean isValid(Date target, ConstraintValidatorContext cxt) {if(target == null) {return true;}Calendar c = Calendar.getInstance();c.setTime(target);int fieldYear = c.get(Calendar.YEAR);return fieldYear == annotationYear;}}

首先要注意的是，这一次，我们将传递到批注中的年份保存为约束验证器类的成员变量。这使我们可以在“ isValid”方法中访问该值。

isValid方法是非常简单的代码，可以与令人讨厌的Date / Calendar API进行搏斗，以验证带注释的字段的值是否与指定的验证注释的年份匹配（我可以在某个时候使用JodaTime发布示例）。现在，如果我们启动我们的Web应用程序，我们的两个验证就位并可以使用！

自定义验证示例e1372733063855