点击下载所需要的jar包下载(Hibernate官网)(Hibernate Validator 6.0)

所必须的jar包

SpringMVC 数据校验(JSR303)_字符串

简介

• Spring 4.0 拥有自己独立的数据校验框架,同时支持 JSR 303 标准的校验框架。

• Spring 在进行数据绑定时,可同时调用校验框架完成数据校验工作。在 Spring MVC 中可直接通过注解驱动的方式进行数据校验 。

• Spring 的 LocalValidatorFactroyBean 既实现了 Spring 的 Validator 接口,也实现了 JSR 303 的 Validator 接口。只要 在 Spring 容器中定义了一个 LocalValidatorFactoryBean,即可将其注入到需要数据校 验的 Bean 中。

• Spring 本身并没有提供 JSR303 的实现,所以必须将 JSR303 的实现者的 jar 包放到类路径下。

• 会默认装配好一个 LocalValidatorFactoryBean,通过在处理方法的入参上标注 @valid 注解即可让 Spring MVC 在完成数据绑定后执行 数据校验的工作

• 在已经标注了 JSR303 注解的表单/命令对象前标注一个 @Valid,Spring MVC 框架在将请求参数绑定到该入参对象后,就会调用校验框架根据注解声明的校验规则实施校验

• Spring MVC 是通过对处理方法签名的规约来保存校验结果的:前一个表单/命令对象的校验结果保存到随后的入参中,这个保存校验结果的入参必须是 BindingResult 或 Errors 类型,这两个类都位于 org.springframework.validation 包中

注意

• 需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的,它们之间不允许声明其他的入参

• Errors 接口提供了获取错误信息的方法,如 getErrorCount() 或 getFieldErrors(String field)

• BindingResult 扩展了 Errors 接口

SpringMVC 数据校验(JSR303)_spring_02

在目标方法中获取校验结果

• 在表单/命令对象类的属性中标注校验注解,在处理方法对应的入参前添加 @Valid,Spring MVC 就会实施校验并将校 验结果保存在被校验入参对象之后的 BindingResult 或 Errors 入参中。

• 常用方法:

– FieldError getFieldError(String field):错误信息字段

– List getFieldErrors() :所有错误信息

– Object getFieldValue(String field) :错误信息字段值

– Int getErrorCount() :错误信息个数

–FieldError getDefaultMessage():错误信息内容

JSR303定义的校验类型

空检查
@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 对象是否符合正则表达式的规则(若判断是否为正则表达式,则必须导入javax.el.jar包)
 
数值检查

建议使用在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=) 检查数字是否介于min和max之间.
@Range(min=10000,max=50000,message="range.bean.wage")
private BigDecimal wage;
 
@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber信用卡验证
@Email  验证是否是邮件地址,如果为null,不进行验证,算通过验证。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)

例如

index.jsp

<%--
  Created by IntelliJ IDEA.
  User: 23369
  Date: 3/31/2019
  Time: 3:03 PM
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
  <title>$Title$</title>
</head>
<body>
<form action="testInitBinder" method="post">s
  用户名<input type="text" name="username"><br>
  密码<input type="password" name="userpass"><br>
  邮箱<input type="text" name="useremail"><br>
  年龄<input type="text" name="userage"><br>
  日期<input type="date" name="userdate"><br>
  身高<input type="text" name="userheight"><br>
  省份<input type="text" name="address.procity"><br>
  城市<input type="text" name="address.city"><br>
  <input type="submit" value="提交">
</form>
</body>
</html>

UserInfo.class(JavaBean)

package com.user;

import lombok.Getter;
import lombok.NonNull;
import lombok.Setter;
import org.hibernate.validator.constraints.Range;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.format.annotation.NumberFormat;

import javax.validation.constraints.Digits;
import javax.validation.constraints.Email;
import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.Past;
import java.util.Date;

@Setter
@Getter
public class UserInfo {

    @NotEmpty//username不能为空
    private String username;
    private String userpass;

    @Email//useremail必须为日期格式
    private String useremail;

    @Range(min = 1,max = 101)//userage最大值和最小值
    @NumberFormat(pattern = "###")
    private String userage;

    @Past//userdate必须为之前的时间
    @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)//设置日期格式为yyyy-MM-dd,也可以设置为@DateTimeFormat(pattern = "yyyy-MM-dd")
    private Date userdate;

    @NumberFormat(pattern = "#,###,###.##")//设置为数字格式
    private Double userheight;

    private Address address;


    public UserInfo() {
        super();
    }

    public UserInfo(@NotEmpty String username, String userpass, @Email String useremail, @Range(min = 1, max = 101) String userage, @Past Date userdate, Double userheight, Address address) {
        this.username = username;
        this.userpass = userpass;
        this.useremail = useremail;
        this.userage = userage;
        this.userdate = userdate;
        this.userheight = userheight;
        this.address = address;
    }

    @Override
    public String toString() {
        return "UserInfo{" +
                "username='" + username + '\'' +
                ", userpass='" + userpass + '\'' +
                ", useremail='" + useremail + '\'' +
                ", userage='" + userage + '\'' +
                ", userdate=" + userdate +
                ", userheight=" + userheight +
                ", address=" + address +
                '}';
    }
}

TestInitBinder .class

package com.hello2;


import com.user.UserDate;
import com.user.UserInfo;
import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.InitBinder;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.validation.Valid;
import java.util.List;

@Controller
public class TestInitBinder {

    @RequestMapping("testInitBinder")
    public String testInitBinder(@Valid UserInfo userInfo, BindingResult bindingResult){

        //判断是否有错
        if (bindingResult.getErrorCount() > 0){
            System.out.println("页面信息有错");

            //输出错误信息
            for (FieldError error:bindingResult.getFieldErrors()){
                System.out.println(error.getField() + ":" + error.getDefaultMessage());
            }

            return "success";

        }

        return "success";
    }
}