java参数校验:ValidatorUtils校验框架工具类的使用

🍅 作者主页：Java李杨勇

🍅 简介：Java领域优质创作者🏆、【java李杨勇】公号作者✌ 简历模板、学习资料、面试题库【关注我，都给你】

在日常开发中经常对参数进行校验、可以使用Validator，一般情况下用来验证web前端页面传过来的对象数据属性是否符合标准要求预期。

首先需要在需要校验的java实体类中对需要校验的对象属性添加相关注解说明：

用户对象举例：


package com.railway.modules.sys.entity;import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.railway.common.validator.group.AddGroup;
import com.railway.common.validator.group.UpdateGroup;
import lombok.Data;
import javax.validation.constraints.Email;
import javax.validation.constraints.NotBlank;
import java.io.Serializable;
import java.util.Date;
import java.util.List;/*** 系统用户** @author lyy */
@Data
@TableName("sys_user")
public class SysUserEntity implements Serializable {private static final long serialVersionUID = 1L;/*** 用户ID*/@TableIdprivate Long userId;/*** 用户名*/@NotBlank(message="用户名不能为空", groups = {AddGroup.class, UpdateGroup.class})private String username;/*** 密码*/@NotBlank(message="密码不能为空", groups = AddGroup.class)private String password;/*** 盐*/private String salt;/*** 邮箱*/@NotBlank(message="邮箱不能为空", groups = {AddGroup.class, UpdateGroup.class})@Email(message="邮箱格式不正确", groups = {AddGroup.class, UpdateGroup.class})private String email;/*** 手机号*/private String mobile;/*** 状态  0：禁用   1：正常*/private Integer status;/*** 角色ID列表*/@TableField(exist=false)private List<Long> roleIdList;/*** 创建者ID*/private Long createUserId;private String roleName;private String position;/*** 创建时间*/private Date createTime;}

注解参数说明：

验证注解	验证的数据类型	说明
@AssertFalse	Boolean,boolean	验证注解的元素值是false
@AssertTrue	Boolean,boolean	验证注解的元素值是true
@NotNull	任意类型	验证注解的元素值不是null
@Null	任意类型	验证注解的元素值是null
@Min(value=值)	BigDecimal，BigInteger, byte,short, int, long，等任何Number或CharSequence（存储的是数字）子类型	验证注解的元素值大于等于@Min指定的value值
@Max（value=值）	和@Min要求一样	验证注解的元素值小于等于@Max指定的value值
@DecimalMin(value=值)	和@Min要求一样	验证注解的元素值大于等于@ DecimalMin指定的value值
@DecimalMax(value=值)	和@Min要求一样	验证注解的元素值小于等于@ DecimalMax指定的value值
@Digits(integer=整数位数, fraction=小数位数)	和@Min要求一样	验证注解的元素值的整数位数和小数位数上限
@Size(min=下限, max=上限)	字符串、Collection、Map、数组等	验证注解的元素值的在min和max（包含）指定区间之内，如字符长度、集合大小
@Past	java.util.Date,java.util.Calendar;Joda Time类库的日期类型	验证注解的元素值（日期类型）比当前时间早
@Future	与@Past要求一样	验证注解的元素值（日期类型）比当前时间晚
@NotBlank	CharSequence子类型	验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的首位空格
@Length(min=下限, max=上限)	CharSequence子类型	验证注解的元素值长度在min和max区间内
@NotEmpty	CharSequence子类型、Collection、Map、数组	验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）
@Range(min=最小值, max=最大值)	BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子类型和包装类型	验证注解的元素值在最小值和最大值之间
@Email(regexp=正则表达式,flag=标志的模式)	CharSequence子类型（如String）	验证注解的元素值是Email，也可以通过regexp和flag指定自定义的email格式
@Pattern(regexp=正则表达式,flag=标志的模式)	String，任何CharSequence的子类型	验证注解的元素值与指定的正则表达式匹配
@Valid	任何非原子类型	指定递归验证关联的对象如用户对象中有个地址对象属性，如果想在验证用户对象时一起验证地址对象的话，在地址对象上加@Valid注解即可级联验证

ValidatorUtils校验类

/*** hibernate-validator校验工具类** 参考文档：http://docs.jboss.org/hibernate/validator/5.4/reference/en-US/html_single/** @author admin*/
public class ValidatorUtils {private static Validator validator;static {validator = Validation.buildDefaultValidatorFactory().getValidator();}/*** 校验对象* @param object        待校验对象* @param groups        待校验的组* @throws RRException  校验不通过，则报RRException异常*/public static void validateEntity(Object object, Class<?>... groups)throws RRException {Set<ConstraintViolation<Object>> constraintViolations = validator.validate(object, groups);if (!constraintViolations.isEmpty()) {StringBuilder msg = new StringBuilder();for(ConstraintViolation<Object> constraint:  constraintViolations){msg.append(constraint.getMessage()).append("<br>");}throw new RRException(msg.toString());}}
}

Controller层使用：

/*** 保存用户*/@PostMapping("/save")public R save(@RequestBody SysUserEntity user){ValidatorUtils.validateEntity(user, AddGroup.class);sysUserService.saveUser(user);return R.ok();}