Springmvc整合Hibernate Validator进行验证

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的配置文件中配置一个<mvc:annotation-driven></mvc:annotation-driven>，上述注解驱动会默认装配

好一个 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
				+ "]";
	}

}

4.springmvc方法入参出，在需要验证的pojo加上@valid注解，同时，紧跟在该pojo后面给一个Errors或者BindingResult，具体后台代码如下：

@RequestMapping(value="/user",method=RequestMethod.POST)
public String save(@Valid User user,Errors errors){
	
	if (errors.hasErrors()) {
		
		List<FieldError> 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" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
	<h1>Input Page</h1>
	<form:form action="${pageContext.request.contextPath }/springmvc/user" 
			   method="post"
			   modelAttribute="user">
		Name:<form:input path="name"/><br>
		<form:errors path="name"></form:errors><br><br>
		
		Age:<form:input path="age"/><br>
		<form:errors path="age"></form:errors><br><br>
		
		Birth:<form:input path="birth"/><br>
		<form:errors path="birth"></form:errors><br><br>
		
		Year Salary:<form:input path="yearSalary"/><br>
		<form:errors path="yearSalary"></form:errors><br><br>
		<input type="submit" value="Save"/>
	</form:form>
</body>
</html>

5.验证错误消息国际化

如果没有配置校验错误信息国际化，校验出错时，前台打印出来的错误消息是一些默认的错误消息，我们可以手动进行配置校验错误信息。

① springmvc配置文件配置国际化资源文件

<bean id="messageSource" 
	class="org.springframework.context.support.ResourceBundleMessageSource">
	<property name="basenames">
		<list>
			<value>validationMessage</value>
		</list>
	</property>
</bean>

② classpath下创建一个validationMessage.properties国际化资源文件，注意 国际化资源文件的名字如果是A.properties这种形式，配置文件中basename的value值就是A；如果是A_zh_CN.properties这种形式，则basename是第一个下划线前面的字符串A。国际化资源文件名称一般就这两种规范，别写一些奇葩的就OK。结合第2步中的配置，给出完整的springmvc配置

<context:component-scan base-package="com.mercy.springmvc"></context:component-scan>

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
	<property name="prefix" value="/WEB-INF/views/"></property>
	<property name="suffix" value=".jsp"></property>
</bean>

<bean id="messageSource" 
	class="org.springframework.context.support.ResourceBundleMessageSource">
	<property name="basenames">
		<list>
			<value>validationMessage</value>
		</list>
	</property>
</bean>

<mvc:annotation-driven></mvc:annotation-driven>
<mvc:default-servlet-handler/>

③ 国际化资源文件中配置每个验证错误消息的规范如下：

验证注解名.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=年薪格式不正确！

6. 出现验证出错时，前端显示的错误消息