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对象和字符串。它们可以帮助我们简化应用程序中的验证功能,提高代码的可读性和可维护性。

相关推荐
不会就选b8 小时前
MySQL之视图
数据库·mysql
copyer_xyf8 小时前
Python 异常处理
前端·后端·python
>no problem<8 小时前
基于cola5.0的基础设施层的多数据库切换方案思路
数据库·spring boot·mybatisplus·cola5.0·数据库迁移适配
OceanBase数据库官方博客8 小时前
OceanBase 赋能央国企:从发电到用电的全链路业务承载
数据库·oceanbase
llz_1129 小时前
web-第三次课后作业
前端·后端·web
心之伊始9 小时前
Java 后端接入大模型:从 Token、并发到推理成本的完整估算方法
java·spring boot·性能优化·大模型·llm
瀚高PG实验室9 小时前
pgsql-ogr-fdw
数据库·postgresql·瀚高数据库·highgo
IvorySQL9 小时前
PostgreSQL 技术日报 (6月5日)|PG19 Beta1 上线,PGConf.PL 2026开启征稿
数据库·postgresql·区块链
BlackTurn10 小时前
技术经理投标
java
YG亲测源码屋10 小时前
java配置环境变量、jdk环境变量配置、java环境变量设置方法
java·开发语言