Spring MVC JSR-303验证框架之Hibernate-Validator

对于 JSR 303 验证，目前有两个实现，一个是 Hibernate Validator，一个是 Apache BVal。本教程采用的是 Hibernate Validator，注意它和 Hibernate 无关，只是使用它进行数据验证。

1. 下载与安装 Hibernate Validator

用户可以通过地址“https://sourceforge.net/projects/hibernate/files/hibernate-validator/”下载 Hibernate Validator，本教程选择的是 hibernate-validator-4.3.2.Final-dist.zip。

首先将下载的压缩包解压，然后将 \hibernate-validator-4.3.2.Final\dist 目录下的 hibernate-validator-4.3.2.Final.jar 和 \hibernate-validator-4.3.2.Final\dist\lib\required 目录下的 jboss-logging-3.1.0.Final.jar、validation-api-1.0.0. GA.jar 复制到应用的 \WEB-INF\lib 目录下。

2. 配置属性文件与验证器

如果将验证错误消息放在属性文件中，那么需要在配置文件中配置属性文件，并将属性文件与 Hibernate Validator 关联，具体配置代码如下：

<!-- 配置消息属性文件 -->
<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
    <!-- 资源文件名 -->
    <property name="basenames">
        <list>
            <value>/WEB-INF/resource/errorMessages</value>
        </list>
    </property>
    <!-- 资源文件编码格式 -->
    <property name="fileEncodings" value="utf-8" />
    <!-- 对资源文件内容缓存的时间，单位为秒 -->
    <property name="cacheSeconds" value="120" />
</bean>
<!-- 注册校验器 -->
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
    <!-- hibernate 校验器 -->
    <property name="providerClass" value="org.hibernate.validator.HibernateValidator" />
    <!-- 指定校验使用的资源文件，在文件中配置校验错误信息，如果不指定则默认使用 classpath下的 ValidationMessages.properties -->
    <property name="validationMessageSource" ref="messageSource" />
</bean>
<!--开启 Spring的 Valid 功能 -->
<mvc:annotation-driven conversion-service="conversionService" validator="validator" />

3.  标注类型

JSR 303 不需要编写验证器，但需要利用它的标注类型在领域模型的属性上嵌入约束。

1）空检查

• @Null：验证对象是否为 null。
• @NotNull：验证对象是否不为 null，无法检查长度为 0 的字符串。
• @NotBlank：检查约束字符串是不是 null，以及被 trim 后的长度是否大于 0，只针对字符串，且会去掉前后空格。
• @NotEmpty：检查约束元素是否为 null 或者是 empty。

示例如下：

2）boolean 检查

• @AssertTrue：验证 boolean 属性是否为 true。
• @AssertFalse：验证 boolean 属性是否为 false。

示例如下：

3）长度检查

• @Size（min=，max=）：验证对象（Array、Collection、Map、String）长度是否在给定的范围之内。
• @Length（min=，max=）：验证字符串长度是否在给定的范围之内。

示例如下：

4）日期检查

• @Past：验证 Date 和 Callendar 对象是否在当前时间之前。
• @Future：验证 Date 和 Calendar 对象是否在当前时间之后。
• @Pattern：验证 String 对象是否符合正则表达式的规则。

示例如下：

5）数值检查

示例如下：

由于篇幅有限，大家可结合下一节《Spring MVC Hibernate-Validator数据验证实例》教程学习。