SpringBoot参数校验的最佳实战教程

更新时间：2021年08月25日 09:21:19 作者：范闲

开发过程中,后台的参数校验是必不可少的,下面这篇文章主要给大家介绍了关于SpringBoot参数校验的最佳实战,文中通过示例代码介绍的非常详细,需要的朋友可以参考下

前言

我们这里使用hibernate-validator作为对象参数验证器，所以在正式介绍SpringBoot参数验证之前，需要先简单了解一下hibernate-validator的使用。

hibernate-validator基本使用

引入依赖

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

编写需要验证对象

验证要求 person对象的用户名不能为空，年龄在1-150岁之间。

@Data
public class Person {

    @NotBlank(message = "username must not be null")
    private String username;

    @Min(value = 1, message = "age must be >= 1")
    @Max(value = 150, message = "age must be < 150")
    private Integer age;
}

验证对象属性是否符合要求

    /**
     * 对象验证器
     */
    public Validator validator() {
        ValidatorFactory validatorFactory =
                Validation
                        .byProvider(HibernateValidator.class)
                        .configure()
                        // 验证属性时，如果有一个验证不通过就返回，不需要验证所有属性
                        .addProperty("hibernate.validator.fail_fast", "true")
                        .buildValidatorFactory();
        return validatorFactory.getValidator();
    }

    @Test
    public void test() throws Exception {
        Person person = new Person();
        Set<ConstraintViolation<Person>> validate = validator().validate(person);
        validate.forEach(errorParam -> {
            System.out.println(errorParam.getMessage());
        });
    }

我们只需要验证的对象实例即可完成对象验证，如果验证成功，那么返回一个空的集合，如果验证失败，会返回具体的验证失败的属性信息。
我们输出验证失败的错误信息如下：

username must not be null

验证规则

validator提供了大量的验证注解供我们使用，主要以下几类：

空/非空验证

@Null 元素必须为空
@NotNull 元素不能为空，空字符串""是非空

以下所有验证规则都在元素非空的时候才会进行验证，如果传入的元素为空，验证都会通过。

bool

@AssertTrue 元素必须为true
@AssertFalse 元素必须为false

时间

@Future 元素必须是未来的某个时间。
@FutureOrPresent 元素必须是未来或者现在的某个时间。
@Past 元素必须是过去的某个时间。
@PastOrPresent 元素必须是过去或者现在的某个时间。

数学

数字类型可以是BigDecimal、BigInteger、CharSequence 、byte 、 short 、 int 、 long以及它们各自的包装器类型

@Digits 元素必须是该数字类型下可以被接受的数值范围内。
@Negative 元素必须是负数
@NegativeOrZero 元素必须小于等于0
@Positive 元素必须大于0
@PositiveOrZero 元素必须大于等于0
@Max,@Min 元素的大小必须符合指定大小

字符串

@Email 邮箱格式验证
@NotBlack 验证字符串非空，空字符串""也属于空
@Pattern 字符串正则验证

模板正则

validator提供了字符串模板正则的注解，这里提供一份常用的正则表达式，大家可以直接作为常量工具类放到项目里使用

public interface ValidatorPattern {

    /**
     * 正则表达式：验证用户名
     * 1.长度在5-17
     * 2.由大写小写字母构成
     */
    String REGEX_USERNAME = "^[a-zA-Z]\w{5,17}$";

    /**
     * 正则表达式：验证密码
     * 密码只能为 6 - 12位数字，字母及常用符号组成。
     */
    String REGEX_PASSWORD = "^(?=.*[a-zA-Z])(?=.*[0-9])[A-Za-z0-9._~!@#$^&*]{6,12}$";

    /**
     * 正则表达式：验证手机号
     */
    String REGEX_MOBILE = "^[1][34578]\d{9}$";

    /**
     * 正则表达式：验证邮箱
     */
    String REGEX_EMAIL = "^.+@([a-z0-9A-Z]+(-[a-z0-9A-Z]+)?\.)+[a-zA-Z]{2,}$";

    /**
     * 正则表达式：验证汉字
     */
    String REGEX_CHINESE = "^[\u4e00-\u9fa5],*$";

    /**
     * 正则表达式：验证身份证
     */
    String REGEX_ID_CARD = "(^\d{18}$)|(^\d{15}$)";

    /**
     * 正则表达式：验证URL
     */
    String REGEX_URL = "http(s)?://([\w-]+\.)+[\w-]+(/[\w- ./?%&=]*)?";

    /**
     * 正则表达式：验证IP地址
     */
    String REGEX_IP_ADDR = "(25[0-5]|2[0-4]\d|[0-1]\d{2}|[1-9]?\d)";

    /**
     * 车牌号正则
     */
    String LICENSE_NO = "^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z][A-Z][A-Z0-9]{4,5}[A-Z0-9挂学警港澳]$";

    /**
     * 姓名校验
     * 1~15位
     * 姓名支持空格和中文的点
     */
    String NAME = "[\u4e00-\u9fa5\u00b7\sA-Za-z]{1,15}$";

    /**
     * 表情正则
     */
    String EMOJI = "[\ud83c\udc00-\ud83c\udfff]|[\ud83d\udc00-\ud83d\udfff]|[\u2600-\u27ff]";

    /**
     * 数字正则
     */
    String NUMBER = "^[0-9]*$";

    /**
     * n位的数字
     */
    String N_NUMS = "^\d{n}$";

}

SpringBoot整合hibernate-validator

引入依赖

这个不再赘述，直接拷贝上文的依赖信息

配置hibernate-validator验证器对象

在配置类中加入hibernate-validator验证器对象

    @Bean
    @Primary
    public Validator validator() {
        ValidatorFactory validatorFactory =
                Validation
                        .byProvider(HibernateValidator.class)
                        .configure()
                        .addProperty("hibernate.validator.fail_fast", "true")
                        .buildValidatorFactory();
        return validatorFactory.getValidator();
    }

借助SpringMVC统一异常处理处理参数校验结果

配置好后，Spring会自动帮助我们进行参数验证，如果参数验证不通过，会抛出BindException异常，我们刚刚手动验证时的Set<ConstraintViolation<Person>>通过该异常获取。

我们这可以通过借助SpringMVC统一异常处理的能力处理这个异常

@Slf4j
@RestControllerAdvice
public class BaseExceptionHandler {
    /**
     * spring validation 自动校验的参数异常
     *
     * @param e BindException
     * @return R<Void>
     */
    @ResponseStatus(org.springframework.http.HttpStatus.PAYMENT_REQUIRED)
    @ExceptionHandler(BindException.class)
    public R<Void> handler(BindException e) {
        String defaultMsg = e.getBindingResult().getAllErrors()
                .stream()
                .map(ObjectError::getDefaultMessage)
                .collect(Collectors.joining(":"));
        log.warn(defaultMsg);
        return R.of(IRespCode.PARAMETERS_ANOMALIES.getCode(), e.getMessage());
    }
}

使用参数校验

我们只需要在校验参数的方法传参上标注@Valid或者@Validated都行

    @PostMapping("register")
    public R<Void> register(@Valid @RequestBody Person person) {
        // todo 
        return R.ok();
    }

分组校验

那么@Valid和@Validated有什么区别呢？

Validated比Valid多了一个属性，这个属性用于分组校验使用

public @interface Valid {
}
public @interface Validated {
    Class<?>[] value() default {};
}

啥叫分组校验？

就是一个实体类中的属性，在不同的方法传参中，方法的对属性的要求不同。

比如说，Person类中有三个属性，一个是用户名称，一个是邮箱，一个是年龄。

在注册用户接口中，用户名称，邮箱和年龄都不能为空，但是在更改用户的信息接口中，用户的年龄和邮箱都可以为空，但是用户名称不能为空。

这时候，我们就可以按照对属性校验的要求进行分组。

新建一个RegisterGroup分组，该分组只是一个空的接口，仅仅用于标记该校验要求

public interface RegisterGroup {
}

对校验要求进行分组

@Data
public class Person {

    @NotBlank(message = "username must not be null")
    private String username;

    @Min(value = 1, message = "age must be >= 1")
    @Max(value = 150, message = "age must be < 150")
    @NotNull(message = "age must not be null", groups = RegisterGroup.class)
    private Integer age;

    @Email(message = "email format error")
    @NotBlank(message = "email must not be null",groups = RegisterGroup.class)
    private String email;
}

方法调用时，加入分组要求

    @PostMapping("register")
    public R<Void> register(@Validated(value = RegisterGroup.class) @RequestBody Person person) {
        // todo
        return R.ok();
    }

这种方式其实不推荐使用，我在标题的时候，也已经标记为“过时”，因为，我们完全可以为这两个不同的接口创建两个不同的实体类，而不是使用分组对校验要求进行隔离，因为实际生产环境中，分组可能有非常多个，这会为我们的程序的可读性埋下隐患，后期开发人员难以维护，而且对于自动生成API文档也不友好。大家对于分组只需要了解即可，不建议在项目开发中使用。

总结

到此这篇关于SpringBoot参数校验的文章就介绍到这了,更多相关SpringBoot参数校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解如何用Java去除HTML标签
在平时工作中，偶尔会用 Java 做一些解析HTML的工作。有时需要删除所有的HTML标签，只保留纯文字内容。这个问题在做过一些爬虫工作的朋友来说很简单。下面来说说，我们平时使用到的集中解析的方法
2022-12-12
详解如何使用IntelliJ IDEA生成UML图
在软件开发中,UML（统一建模语言）是一种用于描述、构建和文档化软件系统的图形化语言,它帮助开发者以可视化的方式理解系统的结构和行为,手动绘制 UML 图可能既耗时又容易出错,所以本文给大家介绍了如何使用IntelliJ IDEA生成UML图,需要的朋友可以参考下
2024-10-10
Spring Cache扩展功能实现过程解析
这篇文章主要介绍了Spring Cache扩展功能实现解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-02-02
SpringBoot中整合Ehcache实现热点数据缓存的详细过程
这篇文章主要介绍了SpringBoot中整合Ehcache实现热点数据缓存,SpringBoot 中使用 Ehcache 比较简单，只需要简单配置，说白了还是 Spring Cache 的用法，合理使用缓存机制，可以很好地提高项目的响应速度，需要的朋友可以参考下
2023-04-04
详解spring boot mybatis全注解化
这篇文章主要介绍了spring boot mybatis全注解化的相关资料,需要的朋友可以参考下
2017-09-09
Java实现多人聊天室的原理与源码
这篇文章主要给大家介绍了关于Java实现多人聊天室的原理与源码的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-04-04
Java生成递增流水号(编号+时间+流水号)简单示例
这篇文章主要给大家介绍了关于Java生成递增流水号(编号+时间+流水号)的相关资料,在开发项目漫长的过程中常常会遇到流水号需要自动生成的问题存在,文中给出了详细的代码示例,需要的朋友可以参考下
2023-07-07
Java中@ConfigurationProperties实现自定义配置绑定问题分析
这篇文章主要介绍了@ConfigurationProperties实现自定义配置绑定问题，本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2021-08-08
Springboot 扫描mapper接口的2种操作
这篇文章主要介绍了Springboot 扫描mapper接口的2种操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-01-01
在Java中如何避免创建不必要的对象
作为Java开发者,我们每天创建很多对象,但如何才能避免创建不必要的对象呢?这需要我们好好学习,这篇文章主要给大家介绍了关于在Java中如何避免创建不必要对象的相关资料,需要的朋友可以参考下
2021-10-10