springboot项目使用validated参数校验框架

ops/2024/9/24 11:10:19/

前言

一、validated是什么？

二、使用步骤

1.引入maven依赖

2.使用实现

总结

前言

当谈到Spring的参数校验功能时，@Validated注解无疑是一个重要的利器。它为我们提供了一种简单而又强大的方式来验证请求参数的合法性，保证了系统的稳定性和安全性。本文将介绍Spring Validated的基本用法以及在实际项目中的应用。

提示：以下是本篇文章正文内容，下面案例可供参考

一、validated是什么？

@Validated注解的作用和使用方法

可以用于Controller类或方法上，开启对请求参数的校验功能。
通过在方法参数上使用其他校验注解（如@NotNull、@NotBlank、@Min、@Max等），对请求参数进行校验和验证，确保参数的合法性。
可配合使用Spring Validation API或其他支持JSR-303规范的验证框架（如Hibernate Validator），发挥@Validated注解的最大效用。

@Validated注解的实际应用示例

编写一个用户注册接口，结合@Pattern注解对用户名和密码进行格式校验。
处理校验失败时的异常情况，并返回友好的错误信息给接口调用方。

@Validated注解的注意事项和最佳实践

讨论@Validated注解在复杂校验场景下的使用技巧。
如何在全局配置文件中声明验证器或配置验证规则，使得@Validated注解更加灵活地适应各种项目需求。

二、使用步骤

1.引入maven依赖

代码如下（示例）：

<!--        Validation合法性校验(参数)  参数校验框架的依赖--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId></dependency>

2.使用实现

代码如下参数长度在 5 - 16位（示例）：

/*** @Description: 用户相关的控制层* @Author: windStop* @Date: 2024/5/26 16:18*/
@RestController
@RequestMapping("/user")
@Validated  //启用参数校验功能
public class UserController {@Autowiredprivate UserService userService;/*** 用于注册新用户  在注册用户的时候需要先判断用户名是否存在，因为用户名不可以重复* 这里我不打算使用给用户名添加唯一字段* @param username 用户名* @param password 密码* @return 是否注册成功*/@PostMapping("/register")public Result register(@Pattern(regexp = "^\\S{5,16}") String username, @Pattern(regexp = "^\\S{5,16}")String password){//1.判断用户是否存在if (userService.findByUsername(username)){return Result.error("用户名已存在无法注册");}//2.不存在进行注册boolean flag = userService.register(username,password);return Result.success(flag);}}