Spring MVC代码实例系列-12：使用自带的validation实现自定义message表单校验

超级通道 ：Spring MVC代码实例系列-绪论

本章主要记录，如何在Spring MVC使用自带的validation实现自定义消息-表单校验。

1.历史回顾

在Spring MVC代码实例系列-06：Spring MVC配置Hibernate-Validator以及自定义校验注解中记录了如果通过注册自定义的校验驱动，配置自定义校验消息。
根据那篇文章记录的配置方式，实现了自定义message。
但是由于本人水平有限，有一个十分致命的缺点：不能通过EL表达式动态加载min、max等参数。下面，举例说明：
实体类：

@Length(min = 5,max = 10, message = "{user.username.length}")
private String username;

message.properties

user.username.length = 用户名的长度必须在5至10之间！

如果这时username的校验规则变为：长度范围4~9。
则我们分别需要修改实体类和message.properties，不仅繁琐，而且容易改错。

2.新的方式

通过查看hibernate-validator-5.4.1.Final.jar，可知hibernate-validator的message资源文件名为ValidationMessages.propperties，是一组国际化资源包(Internationalized Resources Bundle)，形如：

本章记录的实现方式：替代Spring自带的ValidationMessages.propperties Resources Bundle。

首先看一下实现之后的效果：
实体类：

@Length(min = 5,max = 10, message = "{user.username.length}")
private String username;

message.properties

user.username.length = 用户名 [${validatedValue}] 的长度必须在{min}至{max}之间！

如果这时username的校验规则变为：长度范围4~9。则只需要修改实体类的min和max即可，十分方便。

下面对配置方法进行说明：

3.配置方式

3.1.pom.xml引入相关jar包

    <hibernate-validator.version>5.4.1.Final</hibernate-validator.version>

    <!-- 验证的jar -->
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>${hibernate-validator.version}</version>
    </dependency>

3.2.创建校验消息的国际化资源包

3.2.1.关于国际化资源包

下面对Resources Bundle进行简单说明，如需了解详细情况，请自行查阅。

• Resources Bundle是实现软件国际化的一种支持，相关类：java.util.ResourceBundle。
• Resources Bundle可以根据本地语音环境自动选择正确的资源文件。
• Resources Bundle的乱码可以通过native2ascii.exe工具解决。
• Resources Bundle的properties(属性文件)的命名规则：文件名_语言代码_国家/地区代码.properties

举例： 现有资源文件如下，

1. env.properties : 默认/全局配置(建议必有)
2. env_zh_CN.properties : 中文(大陆)配置
3. env_en_us.properties : 英文(美国)配置

java在加载env.properties时，会遵循以下原则：

• 如果在中文操作系统下，会选择读取env_zh_CN.properties的配置信息；
• 如果是英文操作系统，会选择读取env_en_us.properties的配置信息；
• 如果无法找与当前系统匹配的配置文件，就会读取默认的配置文件：env.properties。

3.2.2.创建Resources Bundle

根据上面对Resources Bundle的简介，在src/main/resources/目录下依次创建：
ValidationMessages.properties、ValidationMessages_zh_CN.properties。
由于本人的IDE是IDEA，所以能够自动将这两个文件转换成一个Resources Bundle（国际化资源包），如下图所示：

编写本项目的properties如下（至少要保证一个有值）：

ValidationMessages.properties

# 全局配置
user.username.length = 用户名 [${validatedValue}] 的长度必须在{min}至{max}之间！
user.password.length = 密码 [${validatedValue}] 的长度必须在{min}至{max}之间！

ValidationMessages_zh_CN.properties

# 全局配置
user.username.length = 用户名 [${validatedValue}] 的长度必须在{min}至{max}之间！
user.password.length = 密码 [${validatedValue}] 的长度必须在{min}至{max}之间！

其中，[${validatedValue}] 是实际参数的占位符。

3.3.编写校验实体类

public class User {
    /** 用户名 */
    @NotNull
    @Length(min = 5,max = 10, message = "{user.username.length}")
    private String username;

    /** 密码 */
    @NotNull
    @Length(min = 5,max = 10, message= "{user.password.length}")
    private String password;

    //toString equals hashCode setter getter等
}

4.result