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

所必须的jar包

SpringMVC 数据校验(JSR303)_java

简介

• 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";
}
}