超级通道 :Spring MVC代码实例系列-绪论
本章主要记录,如何在Spring MVC使用自带的validation实现自定义消息-表单校验。
在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,不仅繁琐,而且容易改错。
通过查看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即可,十分方便。
下面对配置方法进行说明:
<hibernate-validator.version>5.4.1.Finalhibernate-validator.version>
<dependency>
<groupId>org.hibernategroupId>
<artifactId>hibernate-validatorartifactId>
<version>${hibernate-validator.version}version>
dependency>
下面对Resources Bundle进行简单说明,如需了解详细情况,请自行查阅。
文件名_语言代码_国家/地区代码.properties
举例: 现有资源文件如下,
java在加载env.properties时,会遵循以下原则:
env_zh_CN.properties
的配置信息;env_en_us.properties
的配置信息;env.properties
。根据上面对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}] 是实际参数的占位符。
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等
}