JSR 303 约束

一.JSR303约束介绍：
JSR 303 约束是一种spring自带的验证框架。它是Java为Bean数据合法性校验所提供的标准框架，JSR 303通过在Bean属性上标注校验注解指定校验规则，并通过标准的验证接口对Bean进行验证。而Spring本身没有提供JSR 303的实现，实现者是Hibernate Validator。

二.校验时用到的jar包：
hibernate-validator-4.3.2.Final.jar
jboss-logging-3.1.0.CR2.jar
validation-api-1.0.0.GA.jar

三、JSR 303 主要的校验规则：
空检查
@Null 验证对象是否为null
@NotNull 验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,仅仅对字符串,且会去掉前后空格.
@NotEmpty 检查约束元素是否为NULL或者是EMPTY.

Booelan检查
@AssertTrue 验证 Boolean 对象是否为 true
@AssertFalse 验证 Boolean 对象是否为 false

长度检查
@Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内
@Length(min=, max=) Validates that the annotated string is between min and max included.

日期检查
@Past 验证 Date 和 Calendar 对象是否在当前时间之前，验证成立的话被凝视的元素一定是一个过去的日期
@Future 验证 Date 和 Calendar 对象是否在当前时间之后 ，验证成立的话被凝视的元素一定是一个将来的日期
@Pattern 验证 String 对象是否符合正則表達式的规则。被凝视的元素符合制定的正則表達式，regexp:正則表達式 flags: 指定 Pattern.Flag 的数组，表示正則表達式的相关选项。

数值检查
建议使用在Stirng,Integer类型。不建议使用在int类型上，由于表单值为“”时无法转换为int，但能够转换为Stirng为”“,Integer为null
@Min 验证 Number 和 String 对象是否大等于指定的值
@Max 验证 Number 和 String 对象是否小等于指定的值
@DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的參数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
@DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的參数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
@Digits 验证 Number 和 String 的构成是否合法
@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字，interger指定整数精度。fraction指定小数精度。
@Range(min=, max=) 被指定的元素必须在合适的范围内
@Range(min=10000,max=50000,message=”range.bean.wage”)
@Valid 递归的对关联对象进行校验, 假设关联对象是个集合或者数组,那么对当中的元素进行递归校验,假设是一个map,则对当中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber信用卡验证
@Email 验证是否是邮件地址，假设为null,不进行验证。算通过验证。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)

四.示例说明校验（使用Spring表单标签实现新增用户功能
加入JSR 303验证，定义输入规则）
1.创建一个maven项目：
依次编写spring MVC-servlet.xml和web.xml文件
spring MVC-servlet.xml：

<!-- 对转向页面的路径解析。prefix：前缀， suffix：后缀,配置访问路径的前置和后缀 -->

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" >
		<property name="prefix" value="/WEB-INF/jsp/"/>
		<property name="suffix" value=".jsp"/>
	</bean>
    <context:component-scan base-package="com.bdqn.controller"/>
   <mvc:annotation-driven/>

web.xml：

 <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
    <filter>
        <filter-name>characterEncoding</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>utf-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncoding</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

2.导入jar包：

 <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>5.4.1.Final</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.jboss.logging/jboss-logging -->
        <dependency>
            <groupId>org.jboss.logging</groupId>
            <artifactId>jboss-logging</artifactId>
            <version>3.1.4.GA</version>
        </dependency>

3.建立一个实体类（User）

package com.bdqn.pojo;

import org.hibernate.validator.constraints.Length;
import org.hibernate.validator.constraints.NotEmpty;
import org.springframework.format.annotation.DateTimeFormat;

import javax.validation.constraints.*;
import java.util.Date;

public class User {
	@NotNull
	@Min(15)
	@Max(100)
	private int age;
	@NotNull(message = "密码不能为空")
	@Length(min=6,max=10,message="用户密码长度为6-10")
	private String password;
	@NotEmpty(message = "用户名不为空")
	private String userName; //用户名称
	@Past(message="必须是一个过去的时间")
	@DateTimeFormat(pattern = "yyy-WW-dd")
	private Date birthday;
	@Pattern(regexp = "[1][3,4,5,7,8][0-9]{9}",message = "手机号格式不正确")
	private String phone;


	public User() {
	}

	public User(int age, String password, String userName, Date birthday, String phone) {
		this.age = age;
		this.password = password;
		this.userName = userName;
		this.birthday = birthday;
		this.phone = phone;
	}

	@Override
	public String toString() {
		return "User{" +
				"age=" + age +
				", password='" + password + '\'' +
				", userName='" + userName + '\'' +
				", birthday=" + birthday +
				", phone='" + phone + '\'' +
				'}';
	}

	public int getAge() {
		return age;
	}

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

	public String getPassword() {
		return password;
	}

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

	public String getUserName() {
		return userName;
	}

	public void setUserName(String userName) {
		this.userName = userName;
	}

	public Date getBirthday() {
		return birthday;
	}

	public void setBirthday(Date birthday) {
		this.birthday = birthday;
	}

	public String getPhone() {
		return phone;
	}

	public void setPhone(String phone) {
		this.phone = phone;
	}
}

4.编写一个添加页面（addUser.jsp），欢迎页面（welcome.jsp）
addUser.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@taglib prefix="fm" uri="http://www.springframework.org/tags/form" %>
<jsp:useBean id="user" class="com.bdqn.pojo.User" scope="request"/>
<style>
    span{color:red}
</style>
<html>
<head>
    <title>Title</title>
</head>
<body>
<fm:form action="addUser.do" method="POST" commandName="user">

<p>用户名：<fm:input path="userName"/><span> <fm:errors path="userName"/></span></p>
    <p>密码：<fm:input path="password"/><fm:errors path="password"/></p>
<p>生日：<fm:input path="birthday"/><fm:errors path="birthday"/></p>
<p>手机号：<fm:input path="phone"/><fm:errors path="phone"/></p>
    <input type="submit" name="添加">
</fm:form>
</body>
</html>

welcome.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
欢迎进入welcome页面
</body>
</html>

5.编写一个控制类（AddUserController）

@Controller
public class AddUserController {
    @RequestMapping(value = "/addUser.do",method = RequestMethod.GET)
    public String addUser(){
        return "addUser";
    }
    @RequestMapping("/newUser") // 这里需要提前注入一个user对象
    public String newUser(@ModelAttribute("user") User user) {
        return "addUser";
    }
    @RequestMapping(value = "/addUser.do",method = RequestMethod.POST)
    public String saveUser(@Valid User user, BindingResult bindingResult){
//        System.out.println(user);
        if (bindingResult.hasErrors()) {

          return "addUser"  ;
        }else {
            return "welcome";
        }
    }
}

6.运行结果如下：
失败,有异常：

成功：