点击下载所需要的jar包下载(Hibernate官网)(Hibernate Validator 6.0)
所必须的jar包
简介
• 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 接口
在目标方法中获取校验结果
• 在表单/命令对象类的属性中标注校验注解,在处理方法对应的入参前添加 @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";
}
}