spring boot3参数校验基本用法

⛰️个人主页: 蒾酒

🔥系列专栏:《spring boot实战》****

🌊山高路远,行路漫漫,终有归途。


目录

前置条件

前言

导入依赖

使用介绍

配置检验规则

开启校验

使用注意

全局异常捕获返回友好提示信息

常用的校验规则注解

使用技巧


前置条件

已经初始化好一个spring boot项目且版本为3X,项目可正常启动。

作者版本为3.2.2

初始化教程:

新版idea(2023)创建spring boot3项目_2023年版的idea用maven创建springboot项目-CSDN博客https://blog.csdn.net/qq_62262918/article/details/135785412?spm=1001.2014.3001.5501

前言

在spring boot应用程序开发中对于参数校验这一块我们通常使用注解的方式来完成,本文我们介绍关于spring boot注解化参数校验的初级使用。

导入依赖

pom.xml:

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

注意:spring boot2.3以后默认spring-boot-starter-web组件不包含该依赖需要单独引入

使用介绍

配置检验规则

现在有一个用户登录请求对象

java 复制代码
import jakarta.validation.constraints.*;
import lombok.Data;


/**
 * @author mijiupro
 */
@Data
public class UserLoginDTO {
    @NotBlank(message = "账号不能为空")
    private String userAccount;// 用户账号
    @Size(min = 6, max = 18, message = "用户密码长度需在6-18位")
    private String password;// 密码
    @NotBlank(message = "验证码id不能为空")
    private String captchaId;// 验证码id
    @NotBlank(message = "验证码内容不能为空")
    private String captcha;// 验证码内容
}

我们使用@Size对字符串密码字段设置长度范围6-18位校验规则,其他字段使用@NotBlank设置非空校验。

注意事项:

此时校验并不会生效,因为我们只配置了规则,并没有开启校验。

开启校验

通常我们在控制层进行参数校验,通过对请求参数使用@Validated注解或者@Valid注解来启用校验。

java 复制代码
@RestController
@RequestMapping("/user")
@Tag(name = "用户管理", description = "用户管理")
public class UserController {
    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    @PostMapping("/login")
    @Operation(summary = "用户登录")
    public UserLoginVO login(@RequestBody @Validated UserLoginDTO userLoginDTO) {
        return userService.login(userLoginDTO);
    }

}

注意事项:

在spring boot推荐用@Validated注解,因为它能够支持 Spring 提供的校验注解,并且具有更好的集成性。

@Validated和@Valid区别:

  • @Validated注解是 Spring 框架提供的,主要用于在 Spring MVC 中对控制器的方法参数进行校验。
  • @Valid注解是 Java 标准库提供的,用于在任何地方触发参数校验,包括 Spring MVC 的控制器方法、Spring Boot 的 REST 控制器方法、Spring Data JPA 的实体类等。

使用注意

控制器方法接收到请求参数后,会进行参数校验,对于未通过校验规则的非法参数会抛出MethodArgumentNotValidException.class异常并打印出注解中传入的message提示信息参数

如图:

可以看到参数未通过返回的信息很不友好,我们需要通过全局异常捕获来处理一下返回友好的提示信息。

全局异常捕获返回友好提示信息

请确保配置了全局异常捕获:

Spring Boot3自定义异常及全局异常捕获-CSDN博客https://blog.csdn.net/qq_62262918/article/details/136110267?spm=1001.2014.3001.5501

我们只需要添加一个方法来捕获MethodArgumentNotValidException.class返回友好信息即可。

java 复制代码
    // 参数校验异常
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Result<String> handleValidationExceptions(Exception ex) {
        log.error(ex.getMessage());
        // 从异常中获取字段错误信息
        FieldError fieldError = ((MethodArgumentNotValidException) ex).getBindingResult().getFieldError();
        if (fieldError != null) {
            // 获取错误提示信息
            String errorMessage = fieldError.getDefaultMessage();
            log.error(errorMessage);
            return Result.error(errorMessage);
        } else {
            // 如果没有字段错误,返回默认错误信息
            log.error(ex.getMessage());
            return Result.error("请求参数验证失败");
        }
    }

常用的校验规则注解

  1. @NotNull:用于标记字段或方法参数不能为空。非null
  2. @NotEmpty:用于标记集合、数组、字符串不能为空。非空集合、数组、字符串
  3. @NotBlank:用于标记字符串不能为空且长度必须大于0。非null且非空字符串
  4. @Size:用于标记集合、数组、字符串长度必须在指定范围内。
  5. @Min:用于标记数字类型的最小值。
  6. @Max:用于标记数字类型的最大值。
  7. @Email:用于标记字符串必须为邮箱格式。

使用技巧

@NotNull用于一般的非空校验,@NotEmpty用于集合、数组、字符串的非空校验,@NotBlank则用于字符串的非空校验且长度必须大于0。

@NotNull注解只要求不为null,无法处理空字符,空字符串在它这里是通过的。

@NotBlank注解不仅要求不为null,还会要求去除前后空格后长度大于0,也就是它要求不能是空字符串。

相关推荐
望获linux38 分钟前
【实时Linux实战系列】Linux 内核的实时组调度(Real-Time Group Scheduling)
java·linux·服务器·前端·数据库·人工智能·深度学习
Never_Satisfied41 分钟前
在 JavaScript 中,删除数组中内容为xxx的元素
java·前端·javascript
MC丶科1 小时前
【SpringBoot常见报错与解决方案】端口被占用?Spring Boot 修改端口号的 3 种方法,第 3 种 90% 的人不知道!
java·linux·spring boot
怪兽20141 小时前
Redis常见性能问题和解决方案
java·数据库·redis·面试
zz-zjx1 小时前
JVM 内存结构与 GC 机制详解( 实战优化版)
java·jvm·tomcat
nvvas1 小时前
Android Studio JAVA开发按钮跳转功能
android·java·android studio
计算机学长felix1 小时前
基于SpringBoot的“中学信息技术课程教学网站”的设计与实现(源码+数据库+文档+PPT)_2025-10-17
数据库·spring boot·后端
CV工程师丁Sir1 小时前
Rokid设备连接全解析:蓝牙与Wi-Fi通信源码深度剖析
java
zoyation1 小时前
多线程简介和在JAVA中应用
java·开发语言
rechol2 小时前
类与对象(中)笔记整理
java·javascript·笔记