SpringMVC使用HibernateValidator验证用户输入-创新互联

一 简介

梅州网站制作公司哪家好，找成都创新互联！从网页设计、网站建设、微信开发、APP开发、成都响应式网站建设公司等网站项目制作，到程序开发，运营维护。成都创新互联从2013年开始到现在10年的时间，我们拥有了丰富的建站经验和运维经验，来保证我们的工作的顺利进行。专注于网站建设就选成都创新互联。

SpringMVC支持与JSR 349 Bean Validation API的集成。借助于Bean验证，可以非常容易地将验证元数据应用到实体类，并且通过合适的视图向用户展示可能的错误结果。在模型类中可以通过注解对属性验证进行定义，常见的注解有：@Size ，@Email ，@Pattern，@Max等，分别验证长度，邮箱格式，自定义正则表达式，大值（PS：更多相关注解可以百度或者查API）

二 测试实例

（1）新建一个动态Java web项目，然后下载“Hibernate Validator”的jar包，下载地址：http://hibernate.org/validator/ ，最后是导入必要的几个jar包和springmvc所需要的jar包，最后的项目结构如下：

    

（2）配置文件web.xml：

	
		springmvc
		org.springframework.web.servlet.DispatcherServlet
		1
	

	
		springmvc
		*.html
	
	
	
		characterEncodingFilter
		org.springframework.web.filter.CharacterEncodingFilter
		
			encoding
			UTF-8
		
	
	
		characterEncodingFilter
		/*
	

在web.xml中定义了springmvc处理请求的后缀是.html，同时设置了编码为UTF-8

（3）配置文件springmvc-servlet.xml：

在这里，主要是配置了视图相关配置，国际化（PS：在这里就是根据中文和英文网页显示不同的错误提示信息），以及定义了验证相关的配置。需要注意的是，还需要在mvc命名空间的annotation-driven标签中定义验证程序

（4）两个国际化文件errors_zh_CN.properties和errors_en_US.properties：

errors_zh_CN.properties文件：

error.password = \u5BC6\u7801\u662F\u5FC5\u987B\u540C\u65F6\u5305\u542B\u5927\u5199\u5B57\u6BCD\u3001\u5C0F\u5199\u5B57\u6BCD\u548C\u6570\u5B57\u76846-20\u4F4D\u5B57\u7B26
error.username = \u7528\u6237\u540d\u9700\u8981\u0033\u002d\u0032\u0030\u4f4d
error.age = \u5e74\u9f84\u6700\u5927\u662f\u0031\u0032\u0030\u5c81

这里以键值对的形式定义了三个中文错误提示信息，需要注意的是使用了“Unicode编码”，如果开发工具不能自动编码的话，可以在这个网页进行手动转换编码：http://tool.chinaz.com/tools/unicode.aspx

errors_en_US.properties文件：

error.password = Passwords are 6-20 bit characters that must contain both upper and lower case letters and digits at the same time.
error.username = username needs 3-20 bit characters
error.age = Max age is 120 years old

（5）实体类User.java：

package cn.zifangsky.model;

import javax.validation.constraints.Max;
import javax.validation.constraints.Pattern;
import javax.validation.constraints.Size;

import org.hibernate.validator.constraints.Email;

public class User {
	@Size(min = 3, max = 20, message = "{error.username}")
	private String username;

	@Email
	private String email;

	@Pattern(regexp = "^((?=.*\\d)(?=.*[a-z])(?=.*[A-Z])).{6,20}$", message = "{error.password}")
	private String password;

	@Max(value = 120, message = "{error.age}")
	private int age;

	public String getUsername() {
		return username;
	}

	public void setUsername(String username) {
		this.username = username;
	}

	public String getEmail() {
		return email;
	}

	public void setEmail(String email) {
		this.email = email;
	}

	public String getPassword() {
		return password;
	}

	public void setPassword(String password) {
		this.password = password;
	}

	public int getAge() {
		return age;
	}

	public void setAge(int age) {
		this.age = age;
	}

}

这里验证了：用户名必须是3-20位，如果验证不通过则通过配置的“message”参数根据语言环境在前台页面显示错误提示信息；邮箱使用默认配置验证了邮箱格式是否正确；密码这一项通过一个正则表达式验证了必须是包含大写字母、小写字母和数字的6-20位的字符；年龄验证了大是120岁

（6）UserController.java这个controller类：

package cn.zifangsky.controller;

import javax.validation.Valid;

import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

import cn.zifangsky.model.User;

@Controller
public class UserController {

	@RequestMapping(value = "/form")
	public ModelAndView user() {
		ModelAndView modelAndView = new ModelAndView("userForm");
		modelAndView.addObject("user", new User());

		return modelAndView;
	}

	@RequestMapping(value = "/result", method = RequestMethod.POST)
	public ModelAndView processUser(@Valid User user, BindingResult result) {
		ModelAndView modelAndView = new ModelAndView("userResult");
		modelAndView.addObject("u", user);
		// 如果出现验证错误，则转到"userForm"视图
		if (result.hasErrors()) {
			modelAndView.setViewName("userForm");
		} else {
			modelAndView.setViewName("userResult");
		}

		return modelAndView;
	}

}

从代码可以看出，定义了两个方法，user方法负责处理”/form”请求，然后转到“userForm.jsp”这个视图页面；在processUser方法中，对用户输入的验证由@Valid注解触发，该注解被递归地应用到实体类User的各个属性中。同时在这个方法中接收了一个额外的参数result，该参数是一个BindingResult实例，通过使用该参数来检查在将请求参数映射到实体类属性的过程中是否发生了任何验证错误。最后是根据条件转到相关视图页面

（7）三个前台jsp页面：

i）根目录下的index.jsp：

<% response.sendRedirect("form.html"); %>

这个文件就简单的一句话，在项目启动时直接请求“form.html”

ii）userForm.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<%@taglib uri="http://www.springframework.org/tags/form" prefix="mvc"%>




.formFieldError {
	background-color: #FAFFBD;
}




	
用户注册：
	
		
			

			

				
用户名：
				

				

			
			

				
邮箱：
				

				

			
			

				
密码：
				

				

			
			

				
年龄：
				

				

			
			

				
		
	

这个文件中定义的errors标签就是分别显示各个参数验证之后的错误提示信息

iii）userResult.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<%@taglib uri="http://www.springframework.org/tags/form" prefix="mvc"%>





	
用户注册结果
	

		

			
用户名：
			
${u.username}
		
		

			
邮箱：
			
${u.email}
		
		

			
密码：
			
${u.password}
		
		

			
年龄：
			
${u.age}
		
	

这个文件只是简单的信息展示，不多做解释

三 测试

（1）中文环境下的错误提示：

项目启动后，使用中文类型的浏览器填写表单，可以发现，出现错误后显示的提示信息如下：

可以发现，出现了预期的提示效果

（2）英文环境下的错误提示：

由于我装的浏览器是中文的，而且也不想更改浏览器的语言，因此我通过在提交表单时抓包手动更改Header中的“Accept-Language”这一项属性，改成“en-US,en;q=0.5”，相当于给服务端说我是英语环境（PS：q参数表示用户的喜爱度，不用管，随便设一个就行）

最后的显示效果如下：

注：实际上，应该把页面中其他的一些中文也设置成国际化形式，那样就可以在英文环境中显示成英文了。不过为了减小理解难度，因此在这里就没有添加上这个步骤，当然我在后面可能会单独写一写SpringMVC的国际化

创新互联www.cdcxhl.cn，专业提供香港、美国云服务器，动态BGP最优骨干路由自动选择，持续稳定高效的网络助力业务部署。公司持有工信部办法的idc、isp许可证， 机房独有T级流量清洗系统配攻击溯源，准确进行流量调度，确保服务器高可用性。佳节活动现已开启，新人活动云服务器买多久送多久。

当前文章：SpringMVC使用HibernateValidator验证用户输入-创新互联
分享网址：http://shouzuofang.com/article/deejop.html