Java基础：JSR 303校验

　　JSR 303是 Java 为Bean数据合法性校验提供的一个标准规范，叫做Bean Validation，随JavaEE 6发布。官方参考实现是Hibernate Validator。

　　Bean Validation为Java Bean定义了相应的数据类型和API，在应用中通过在Bean属性上标注类似于@NotNull, @Max等标准的注解指定校验规则，并通过验证接口对 Bean 进行验证。

　　该校验框架是一个运行时框架，在验证之后验证的错误信息被马上返回；核心接口是javax.validation.Validator，该接口根据目标对象类中所标注的校验注解进和地数据校验，并得到校验结果。

　　该标准目标有两个实现：Hibernate Validator和Apache bval，使用较多的是前者。

　　JSR 303官方标准：https://jcp.org/en/jsr/detail?id=303

Hibernate Validator

Hibernate Validator 提供了 JSR 303 规范中所有内置 constraint 的实现，除此之外还有一些附加的 constraint。如果想了解更多有关 Hibernate Validator 的信息：http://hibernate.org/validator/

JSR 303注解

注解	功能
@Null	验证对象是否为null
@NotNull	验证对象是否不为null，无法检查长度为0的字符串，用于验证基本数据类型
@AssertTrue	验证Boolean对象是否为true
@AssertFalse	验证Boolean对象是否为false
@Max(value)	验证Number和String对象是否小于等于指定的值
@Min(value)	验证Number和String对象是否大于等于指定的值
@DecimalMax(value)	被标注的值必须不大于约束中指中的最大值，标准的值的类型是BigDecimal
@DecimalMin(value)	被标注的值必须不小于约整中指中的最小值，标准的值的类型是BigDecimal
@Digits(integer, fraction)	验证字符串是否符合指定的数字，integer指定整数精度，fraction指定小数精度
@Size(min,max)	验证对象(Array,Collection,Map,String)长度是否在指定的范围内
@Past	验证Date和Calendar对象是否在当前时间之前
@Future	验证Date和Calendar对象是否在当前时间之后
@Pattern	验证String对象是否符合正则表达式的规则

扩展注解

注解	功能
@NotBlank	检查约束字符串是不是Null，被Trim的长度是否大于0。只对字符串，且会去掉去后空格
@URL	验证是否合法的URL
@Email	验证是否合法的邮件地址
@CreditCardNumber	验证是否合法的信用卡号码
@Length(min,max)	验证字符串的长度必须在指定的范围内
@NotEmpty	检查元素是否为Null，或者Empty。用于Array,Collection,Map,String
@Range(min,max,message)	验证属性值必须在合适的范围内

示例代码

1. pom.xml文件引入Hibernate Validator jar包和依赖包。

   <!-- JSR 303数据校验实现：hibernate-validator -->
   <dependency>
   	<groupId>org.hibernate</groupId>
   	<artifactId>hibernate-validator</artifactId>
   	<version>6.0.7.Final</version>
   </dependency>
   <!-- javax.el -->
   <dependency>
   	<groupId>javax.el</groupId>
   	<artifactId>javax.el-api</artifactId>
   	<version>2.2.5</version>
   </dependency>
   <dependency>
   	<groupId>org.glassfish.web</groupId>
   	<artifactId>javax.el</artifactId>
   	<version>2.2.5</version>
   </dependency>

2. 实体类

   import java.util.Date;
   
   import javax.validation.constraints.Email;
   import javax.validation.constraints.NotBlank;
   import javax.validation.constraints.Past;
   import javax.validation.constraints.Pattern;
   
   import org.hibernate.validator.constraints.Length;
   import org.hibernate.validator.constraints.Range;
   import org.springframework.format.annotation.DateTimeFormat;
   
   public class People {
   	
   	private String name;
   	@NotBlank(message="登录名不能为空")
   	private String loginName;
   	@Length(min=6,max=12,message="密码长度必须在6位到8位之前")
   	private String password;
   	@NotBlank(message="用户名不能为空")
   	private String userName;
   	@Range(min=15,max=60,message="年龄必须在15到60岁之间")
   	private double age;
   	@Email(message="请输入合法邮箱地址")
   	@NotBlank(message="邮箱地址不能为空")
   	private String email;
   	@DateTimeFormat(pattern="yyyy-MM-dd")
   	@Past(message="生日必须是一个过去的日期")
   	private Date birthDay;
   	@Pattern(regexp="[1][3,8][3,6,9][0-9] {8}",message="无效电话号码")
   	private String phone;
   
   	//-------set/get方法------------
   ｝

3. Controller代码
   方法中接收参数的对象添加@Valid注解

   import javax.servlet.http.HttpServletRequest;
   import javax.validation.Valid;
   
   import org.springframework.stereotype.Controller;
   import org.springframework.ui.Model;
   import org.springframework.validation.Errors;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RequestMethod;
   
   import com.ssm.entity.People;
   
   @Controller
   @RequestMapping("/user")
   public class LoginController {
   
   	@RequestMapping(value = "/registerForm")
   	public String registerForm() {
   		return "registerForm";
   	}
   	
   	@RequestMapping(value="/login", method=RequestMethod.POST)
   	public String login(@Valid People people, Errors errors, Model model) {
   		System.err.println(people);
   		System.err.println(errors);
   		if(errors.hasErrors()) {
   			String defaultMessage = errors.getFieldError("age").getDefaultMessage();
   			System.out.println(defaultMessage);
   			return "registerForm";
   		}
   		model.addAttribute("people", people);
   		return "success";
   	}
   }

4. 表单代码

   <%@ page language="java" contentType="text/html; charset=UTF-8"	pageEncoding="UTF-8"%>
   <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
   <!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">
   
   <script type="text/javascript"
   	src="${pageContext.request.contextPath}/static/js/jquery-1.11.0.js"></script>
   
   <title>JSR 303 Validation</title>
   </head>
   <body>
   	<h3>注册页面</h3>
   	<form action="${pageContext.request.contextPath}/user/login"
   		method="post">
   		<table>
   			<tr>
   				<td>登录名：</td>
   				<td><input name="loginName"></td>
   			</tr>
   			<tr>
   				<td>密码：</td>
   				<td><input name="password"></td>
   			</tr>
   			<tr>
   				<td>用户名：</td>
   				<td><input name="userName"></td>
   			</tr>
   			<tr>
   				<td>年龄：</td>
   				<td><input name="age"></td>
   			</tr>
   			<tr>
   				<td>邮箱：</td>
   				<td><input name="email"></td>
   			</tr>
   			<tr>
   				<td>生日：</td>
   				<td><input name="birthDay"></td>
   			</tr>
   			<tr>
   				<td>电话：</td>
   				<td><input name="phone"></td>
   			</tr>
   			<tr>
   				<td><input type="submit" value="提交"></td>
   			</tr>
   		</table>
   
   	</form>
   </body>
   </html>