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

前言

当谈到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 {
    @Autowired
    private 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);
    }

}

总结

通过本文的学习，读者将深入了解Spring Validated的使用方法和原理，掌握在实际项目中如何有效地利用@Validated注解进行参数校验。希望本文能够为您在Spring项目开发中遇到的参数校验问题提供一些启发和帮助。如有需要进一步了解或其他问题，请随时告诉我。