spring-boot-starter-validation校验框架

介绍

Spring Boot Starter Validation是一个Spring Boot模块,用于简化应用程序中的验证功能。它包含以下依赖:

  • Hibernate Validator:Hibernate Validator是JavaBean Validation(JSR 380)规范的参考实现,提供了一组用于验证Java对象的约束和注解。
  • javax.validation API:javax.validation API是JavaBean Validation的API,定义了可用于验证的约束和注解集。
  • Spring Validation:Spring Validation是一个模块,用于将JavaBean Validation与Spring Framework集成,包括对方法参数和返回值的验证支持。

注解全解

使用Spring Boot Starter Validation,您可以轻松地将验证功能添加到应用程序中。以下是一些常见的验证注解:

  • @Null:被注释的元素必须为null。
  • @NotNull:被注释的元素必须不为null。
  • @AssertTrue:被注释的元素必须为true。
  • @AssertFalse:被注释的元素必须为false。
  • @Min(value):被注释的元素必须是一个数字,其值必须大于或等于指定的最小值。
  • @Max(value):被注释的元素必须是一个数字,其值必须小于或等于指定的最大值。
  • @Size(min, max):被注释的元素必须是一个字符串、集合、数组或映射,其大小必须在指定的最小和最大值之间。
  • @Pattern(regexp):被注释的元素必须是一个字符串,并且必须与指定的正则表达式匹配。
  • @Valid:被注释的元素必须是一个有效的对象,其所有约束都必须通过验证。

以下是一个使用Spring Boot Starter Validation的示例:

首先,在Spring Boot应用程序中添加以下依赖:

xml 复制代码
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

接下来,创建一个包含验证注解的JavaBean:

java 复制代码
public class Person {
    @NotNull
    @Size(min = 2, max = 50)
    private String name;

    @Min(18)
    @Max(100)
    private int age;

    // getters and setters
}

然后,在控制器中使用@Valid注解来验证JavaBean:

java 复制代码
@RestController
public class PersonController {
    @PostMapping("/persons")
    public ResponseEntity createPerson(@Valid @RequestBody Person person) {
        // Do something with the person object
        return ResponseEntity.ok().build();
    }
}

最后,当调用createPerson方法时,Spring Boot将自动验证Person对象,如果验证失败,将返回一个400错误响应。

@Valid和@Pattern(regexp)是Spring Boot Starter Validation中两个常见的验证注解,用于验证Java对象和字符串。

@Valid


@Valid是一个用于在控制器方法参数上启用验证的注解。当在控制器方法参数上使用@Valid注解时,Spring Boot将自动验证该参数的所有约束,如果验证失败,则返回一个400错误响应。

例如,在下面的示例中,Person对象包含@NotNull和@Size注解,用于验证name属性。在PersonController中,使用@Valid注解来验证Person对象:

java 复制代码
public class Person {
    @NotNull
    @Size(min = 2, max = 50)
    private String name;

    // getters and setters
}

@RestController
public class PersonController {
    @PostMapping("/persons")
    public ResponseEntity createPerson(@Valid @RequestBody Person person) {
        // Do something with the person object
        return ResponseEntity.ok().build();
    }
}

当调用createPerson方法时,Spring Boot将自动验证Person对象的name属性,如果name为null或长度不在2到50之间,则返回一个400错误响应。

@Pattern(regexp)


@Pattern(regexp)是一个用于验证字符串是否匹配指定正则表达式的注解。在使用@Pattern(regexp)注解时,需要提供一个regexp属性,用于指定正则表达式。

例如,在下面的示例中,使用@Pattern(regexp)注解来验证email属性是否符合电子邮件地址的格式:

java 复制代码
public class Person {
    @Pattern(regexp = "^[\\w!#$%&'*+/=?`{|}~^-]+(?:\\.[\\w!#$%&'*+/=?`{|}~^-]+)*@(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,6}$")
    private String email;

    // getters and setters
}

当验证Person对象时,Spring Boot将自动验证email属性是否符合指定的正则表达式。如果不符合,则返回一个400错误响应。

需要注意的是,在使用@Pattern(regexp)注解时,正则表达式可能会很复杂,因此需要仔细测试和验证。同时,也需要注意正则表达式的性能问题,避免使用过于复杂的正则表达式导致验证性能下降。

总之,@Valid和@Pattern(regexp)是Spring Boot Starter Validation中两个常见的验证注解,用于验证Java对象和字符串。它们可以帮助我们简化应用程序中的验证功能,提高代码的可读性和可维护性。

相关推荐
香菜TTT7 小时前
怎么实现MySQL的主从同步机制
数据库·mysql
MZA6667 小时前
实战:基于 XXL-JOB + 策略模式 + Nacos 配置化的 CSV 导出任务系统设计
java·spring boot·mybatis
邪修king7 小时前
Re:Linux 系统篇(二十九):动静态库Chapter2:动态库深度辨析 —— 核心本质、制作流程、双阶段查找模型与排错指南
android·java·linux·开发语言
泡海椒8 小时前
告别 iText 繁杂配置:jquick-pdf 极简 PDF 生成实战(零基础上手)
java·开发语言·pdf
JaguarJack8 小时前
PHP 8.6 只是个小版本,三十项弃用却已在为 PHP 9.0 铺路
后端·php·服务端
BingoGo8 小时前
PHP 8.6 只是个小版本,三十项弃用却已在为 PHP 9.0 铺路
后端·php
步行cgn8 小时前
Spring 注入 List 集合详解
windows·spring·list
Bs_MoneyMagnet11 小时前
基于springboot+vue的滑雪场票务与装备租赁系统的设计与实现 源码+文档
java·vue.js·spring boot·后端·spring·毕业设计·计算机毕业设计
AlienZHOU15 小时前
AI Coding 时代下,我的技术面试实践分享
前端·后端·面试
2501_9336707915 小时前
2026秋招数据分析岗备考路线:SQL、BI、项目与面试题拆解
数据库