当请求参数很多，几乎每一个参数都需要后端去兜底校验时，你还在写if else去判断参数是否为空吗？？要校验为空的参数三四个还好，要是十几个，业务逻辑还没开始就写二三十行代码开始堆山了嘛，教给大家一个简单实用的方法，让大家不再在屎堆上堆代码。

注解篇

先来了解几个常用的注解

注解	含义	怎样使用
@NotBlank	字符串不为null且非空格长度至少为1	注解在String类型的参数上
@Null	必须为null	用于Long、Integer、BigDecimal基本数据类型上
@NotNull	必须不为null	用于Long、Integer、BigDecimal基本数据类型上
@NotEmpty	集合不为null且长度>0	用于集合校验
@AssertTrue	为true	用于Boolean类型上
@AssertFalse	为false	用于Boolean类型上
@Max	小于或等于某个数	一个字段的最大值为xx
@Min	大于或等于某个数	一个字段的最小值为xx
@Digits(integer=3, fraction=2)	整数和小数长度	—
@Pattern	正则匹配	手机号规则校验等
@Range（min=，max=）	数值类型范围	—
@Length	字符串长度范围	----

实战篇

请求参数

BizRequestDTO

import lombok.Data;
import org.hibernate.validator.constraints.NotBlank;

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

@Data
public class BizRequestDTO {
    /**
     * 单据编号
     */
    @NotBlank(message = "headId (单据编号)不能为空")
    private String headId;

	/**
     * 金额
     */
    @NotNull(message = "amount (金额)不能为空")
    private BigDecimal amount;


    /**
     * 提单人
     */
    @Valid
    private EmpInfoDTO submitter;

    /**
     * 分摊人列表
     */
    @Valid
    private List<EmpInfoDTO> expenseSharerList;
}

注解释义 @Valid

作用于对象,作用于集合 对象内校验方式:

    @Valid
    private EmpInfoDTO submitter;

EmpInfoDTO

    /**
     * 工号
     */
    @NotBlank(message = "工号不能为空")
    private String workNo;

    /**
     * 姓名
     */
    @NotBlank(message = "姓名不能为空")
    private String nickName;

在代码中如何写？

引入依赖

        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>6.0.16.Final</version>
        </dependency>
        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>2.0.1.Final</version>
        </dependency>

引入一个工具类

import org.hibernate.validator.HibernateValidator;

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import java.util.Set;

public class ValidatorUtils {

    private static final Validator DEFAULT_VALIDATOR;
    static {
        DEFAULT_VALIDATOR = Validation.byProvider(HibernateValidator.class)
                .configure()
                .buildValidatorFactory()
                .getValidator();
    }

    public static <T> Set<ConstraintViolation<T>> validate(T bean) {
        return DEFAULT_VALIDATOR.validate(bean);
    }
}

实际应用

    public ResponseResult<String> checkExpenseParams(RequestParamDTO requestDTO) {
        Set<ConstraintViolation<TaeExpenseLineCheckRequestDTO>> result = ValidatorUtils.validate(requestDTO);
        // 错误信息输出
        StringBuilder resultInfo = new StringBuilder();
        result.forEach(validateResult -> resultInfo.append(validateResult.getMessage()).append("\n"));
        if (StringUtils.isNotBlank(resultInfo)) {
            return ResponseResult.error(resultInfo.toString());
        }
        // 若为空则参数校验通过
        return ResponseResult.ok(null);
    }

输出示例

headId (单据编号)不能为空
amount (金额)不能为空

校验模式配置

Hibernate可以对校验模式的配置，支持快速失败，即在校验的过程中只要有一项不同过，剩余的参数就不再进行校验。默认使用的是全部校验完成后再返回，也就是在上面的例子中展示的那样。开启快速失败的具体的实现方式：

Validation.byProvider(HibernateValidator.class)
        .configure()
        .failFast(true)
        .buildValidatorFactory()
        .getValidator();

校验工具类

import org.hibernate.validator.HibernateValidator;

import javax.validation.ConstraintViolation;
import javax.validation.Validator;
import javax.validation.Validation;
import java.util.Set;

public class ValidatorUtils {

    private static final Validator DEFAULT_VALIDATOR;

    private static final Validator FAST_VALIDATOR;

    static {

     DEFAULT_VALIDATOR = Validation.byProvider(HibernateValidator.class)
                .configure()
                .buildValidatorFactory()
                .getValidator();


        FAST_VALIDATOR = Validation.byProvider(HibernateValidator.class)
                .configure()
                .failFast(true)
                .buildValidatorFactory()
                .getValidator();
    }

    public static <T> Set<ConstraintViolation<T>> validate(T bean) {
        return DEFAULT_VALIDATOR.validate(bean);
    }

	public static <T> Set<ConstraintViolation<T>> fastValidate(T bean) {
        return FAST_VALIDATOR.validate(bean);
    }
}

快速校验使用方式同上，输出示例

headId (单据编号)不能为空

对象级联校验

包含级联对象的类

对象级联校验意味着，在一个对象中的属性可以包含另外一个校验对象，被级联的对象需要用@Valid注解修饰。上面也有给出🌰，本节再详细讲解一下。

例：

import lombok.Data;
import org.hibernate.validator.constraints.NotBlank;
import org.hibernate.validator.constraints.Range;

import javax.validation.Valid;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Pattern;

@Data
public class ValidatorWithDefineExtraModel {

    @NotBlank(message="姓名不能为空")
    private String name;

    @NotNull(message = "年龄不能为空")
    @Range(min=1, max=200, message = "年龄必须大于1小于200")
    private Integer age;

    @NotBlank(message="性别不能为空")
    @Pattern(regexp = "([FM])", message = "性别只能为F(女）或者M(男）")
    private String sex;

    @NotNull(message = "validatorModelExtra不能为空")
    @Valid
    private ValidatorModelExtra validatorModelExtra;
}

被级联的对象

@Data
public class ValidatorModelExtra {
    @NotNull(message = "地址不能为空")
    @Length(max = 100, message = "地址长度不能大于100个字符")
    private String address;
}

输出示例：

地址不能为空