1.导入Hibernate Validation jar包,如下所示,我用的是版本是hibernate-validator-6.0.2.Final。
hibernate-validator-6.0.2.Final.jar
hibernate-validator-annotation-processor-6.0.2.Final.jar
hibernate-validator-cdi-6.0.2.Final.jar
jboss-logging-3.3.0.Final.jar
classmate-1.3.1.jar
validation-api-2.0.0.Final.jar
关于el的jar需要额外处理,有些版本的Hibernate Validation中关于el的jar包有好几个,都需要额外处理,这里以我用的
版本为例,该版本中只有一个关于el的jar包:javax.el-3.0.1-b08.jar ,需要将该jar包替换tomcat服务器安装目录下,lib
目录中的关于el的jar包,具体文件路径如下:F:\win10\apache-tomcat-6.0.53\lib\el-api.jar,将该文件删除,然后将
javax.el-3.0.1-b08.jar复制到该目录即可。
2.springmvc的配置文件中配置一个
好一个 LocalValidatorFactoryBean,通过在处理方法的入参上标注 @valid注解即可让SpringMVC 在完成数据绑定
后执行数据校验的工作。
3.需要进行校验的实体类对应的属性上加上相应的注解,JSR303支持的标准校验注解如下
Hibernate Validator 除了支持JSR303所有标准注解,还扩展了下列验证注解
例:加了注解的实体类
package com.mercy.springmvc.bean;
import java.util.Date;
import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.Past;
import org.hibernate.validator.constraints.Range;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.format.annotation.NumberFormat;
public class User {
private Integer id;
@NotEmpty
private String name;
@Range(min=18)
private int age;
@Past
@DateTimeFormat(pattern="yyyy-MM-dd")
private Date birth;
@NumberFormat(pattern="###,###,###.##")
private double yearSalary;
public User() {
super();
// TODO Auto-generated constructor stub
}
public User(Integer id, String name, int age, Date birth, double yearSalary) {
super();
this.id = id;
this.name = name;
this.age = age;
this.birth = birth;
this.yearSalary = yearSalary;
}
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public Date getBirth() {
return birth;
}
public void setBirth(Date birth) {
this.birth = birth;
}
public double getYearSalary() {
return yearSalary;
}
public void setYearSalary(double yearSalary) {
this.yearSalary = yearSalary;
}
@Override
public String toString() {
return "User [id=" + id + ", name=" + name + ", age=" + age + ", birth=" + birth + ", yearSalary=" + yearSalary
+ "]";
}
}
@RequestMapping(value="/user",method=RequestMethod.POST)
public String save(@Valid User user,Errors errors){
if (errors.hasErrors()) {
List fieldErrors = errors.getFieldErrors();
for (FieldError fieldError : fieldErrors) {
System.out.println(fieldError);
}
return "user-input";
}
System.out.println(user);
System.out.println("名为 "+user.getName()+" 的用户已保存到数据库!");
return "redirect:/index.jsp";
}
当前台输入的字段值校验不通过时,所有的字段检验错误信息都会封装到Errors对象中,对其进行如上代码的遍历,可以获取到所有字段的错误信息,打印出来如下:
Field error in object 'user' on field 'yearSalary': rejected value [15,243,000xcv]; codes [typeMismatch.user.yearSalary,typeMismatch.yearSalary,typeMismatch.double,typeMismatch]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [user.yearSalary,yearSalary]; arguments []; default message [yearSalary]]; default message [Failed to convert property value of type 'java.lang.String' to required type 'double' for property 'yearSalary'; nested exception is java.lang.NumberFormatException: For input string: "15,243,000xcv"]
Field error in object 'user' on field 'name': rejected value []; codes [NotEmpty.user.name,NotEmpty.name,NotEmpty.java.lang.String,NotEmpty]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [user.name,name]; arguments []; default message [name]]; default message [不能为空]
Field error in object 'user' on field 'birth': rejected value [Tue Feb 24 00:00:00 CST 2099]; codes [Past.user.birth,Past.birth,Past.java.util.Date,Past]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [user.birth,birth]; arguments []; default message [birth]]; default message [需要是一个过去的时间]
Field error in object 'user' on field 'age': rejected value [12]; codes [Range.user.age,Range.age,Range.int,Range]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [user.age,age]; arguments []; default message [age],9223372036854775807,18]; default message [需要在18和9223372036854775807之间]
字段校验出错后,一般都会返回到前台,打出错误信息,可以通过springmvc的form:errors标签来显示字段错误消息,使用该标签的前提是,表单必须使用springmvc的form:form标签创建,否则报错,前台代码如下:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
Insert title here
Input Page
Name:
Age:
Birth:
Year Salary:
如果没有配置校验错误信息国际化,校验出错时,前台打印出来的错误消息是一些默认的错误消息,我们可以手动进行配置校验错误信息。
① springmvc配置文件配置国际化资源文件
validationMessage
② classpath下创建一个validationMessage.properties国际化资源文件,注意
国际化资源文件的名字如果是A.properties这种形式,配置文件中basename的value值就是A;如果是A_zh_CN.properties这种形式,则basename是第一个下划线前面的字符串A。国际化资源文件名称一般就这两种规范,别写一些奇葩的就OK。结合第2步中的配置,给出完整的springmvc配置
validationMessage
③ 国际化资源文件中配置每个验证错误消息的规范如下:
验证注解名.modelAttribute的value值.属性名=自定义错误消息
针对类型不匹配,验证注解名换成typeMismatch即可
例:NotEmpty.user.name=用户名不能为空!
typeMismatch.user.yearSalary=年薪格式不正确!
下面给出完成的国际化资源文件中的配置
NotEmpty.user.name=用户名不能为空!
Range.user.age=年龄不能小于18!
Past.user.birth=生日必须是过去的某个日期!
typeMismatch.user.birth=生日格式不正确!
typeMismatch.user.yearSalary=年薪格式不正确!