SpringBoot使用validator分组校验实现方式

更新时间：2025年11月25日 14:57:06 作者：shy好好学习

本文详细介绍了在SpringBoot中使用分组校验进行数据验证的两种方法：使用@Validated注解在控制器层进行校验和使用ValidateUtil工具类在任意位置进行手动校验,通过合理使用验证组和验证方法,可以确保数据的正确性和一致性,提高应用程序的健壮性和安全性

1. 简介

在SpringBoot应用程序中,数据验证是确保应用程序健壮性和安全性的关键环节。

Spring Validator提供了强大的验证功能,而分组校验则允许我们根据不同的场景对同一个对象进行不同的验证。

本文将详细介绍如何在SpringBoot中使用validator完成分组校验,包括两种主要的实现方法。

2. 环境准备

2.1 依赖配置

首先,确保你的项目中包含了必要的依赖。在pom.xml文件中添加以下依赖:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

2.2 定义验证组

创建接口来定义不同的验证组:

public interface Create {}
public interface Update {}

3. 创建实体类

使用注解来定义带有分组的验证规则:

import javax.validation.constraints.*;

public class User {
    @NotNull(groups = {Create.class, Update.class})
    private Long id;

    @NotBlank(groups = Create.class)
    @Size(min = 4, max = 20, groups = {Create.class, Update.class})
    private String username;

    @NotBlank(groups = Create.class)
    @Size(min = 6, max = 20, groups = {Create.class, Update.class})
    private String password;

    @Min(value = 18, groups = Create.class)
    private int age;

    @Email(groups = {Create.class, Update.class})
    private String email;

    // getters and setters
}

4. 实现分组校验

4.1 方法一：使用@Validated注解

4.1.1 创建控制器

import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/users")
public class UserController {

    @PostMapping
    public String createUser(@Validated(Create.class) @RequestBody User user) {
        // 处理用户创建逻辑
        return "User created successfully";
    }

    @PutMapping
    public String updateUser(@Validated(Update.class) @RequestBody User user) {
        // 处理用户更新逻辑
        return "User updated successfully";
    }
}

4.1.2 全局异常处理

import org.springframework.http.HttpStatus;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.*;

import java.util.HashMap;
import java.util.Map;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Map<String, String> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach((error) -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        return errors;
    }
}

4.2 方法二：使用ValidateUtil

4.2.1 创建ValidateUtil

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import java.util.Set;
import java.util.stream.Collectors;

public class ValidateUtil {

    private static final Validator validator = Validation.buildDefaultValidatorFactory().getValidator();

    public static <T> void validate(T obj, Class<?>... groups) {
        Set<ConstraintViolation<T>> violations = validator.validate(obj, groups);
        if (!violations.isEmpty()) {
            throw new ValidationException(violations.stream()
                    .map(v -> v.getPropertyPath() + ": " + v.getMessage())
                    .collect(Collectors.joining(", ")));
        }
    }

    public static class ValidationException extends RuntimeException {
        public ValidationException(String message) {
            super(message);
        }
    }
}

4.2.2 在服务层使用ValidateUtil

@Service
public class UserService {

    public void createUser(User user) {
        ValidateUtil.validate(user, Create.class);
        // 继续处理用户创建逻辑
    }

    public void updateUser(User user) {
        ValidateUtil.validate(user, Update.class);
        // 继续处理用户更新逻辑
    }
}

4.2.3 处理ValidationException

在全局异常处理器中添加：

@ControllerAdvice
public class GlobalExceptionHandler {

    // ... 之前的代码 ...

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(ValidateUtil.ValidationException.class)
    public Map<String, String> handleValidationException(ValidateUtil.ValidationException ex) {
        Map<String, String> errors = new HashMap<>();
        errors.put("error", ex.getMessage());
        return errors;
    }
}

5. 比较两种校验方式

使用@Validated注解：

优点：与Spring MVC集成紧密，自动处理验证逻辑
缺点：仅限于控制器层使用

使用ValidateUtil.validate()：

优点：可以在任何层（如服务层）使用，更加灵活
缺点：需要手动调用验证方法

6. 测试

使用Postman或其他API测试工具来测试你的API：

创建用户时，所有字段都必须填写，且符合相应的规则。

更新用户时，id是必须的，但其他字段可以选填，只要填写了就必须符合规则。

7. 总结

本文介绍了在SpringBoot中实现分组校验的两种主要方法：

使用@Validated注解在控制器层进行校验
使用ValidateUtil工具类在任意位置进行手动校验

这两种方法各有优势，可以根据具体的业务需求选择使用。通过合理使用验证组和验证方法，我们可以：

确保数据的正确性和一致性
提高应用程序的健壮性和安全性
根据不同的业务场景灵活应用验证规则
在早期发现和处理潜在的问题

在实际开发中，建议根据项目的架构和需求，选择合适的验证策略。良好的验证实践不仅可以提高代码质量，还能增强用户体验，是构建可靠软件系统的关键环节。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

详解SpringBoot构建的Web项目如何在服务端校验表单输入
这篇文章主要介绍了详解SpringBoot构建的Web项目如何在服务端校验表单输入，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-10-10
Spring通过ApplicationContext主动获取bean的方法讲解
今天小编就为大家分享一篇关于Spring通过ApplicationContext主动获取bean的方法讲解，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2019-03-03
java中字符串与日期的转换实例
java中字符串与日期的转换实例，需要的朋友可以参考一下
2013-05-05
JAVA匿名内部类(Anonymous Classes)的具体使用
本文主要介绍了JAVA匿名内部类，匿名内部类在我们JAVA程序员的日常工作中经常要用到，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-08-08
springMVC+velocity实现仿Datatables局部刷新分页方法
下面小编就为大家分享一篇springMVC+velocity实现仿Datatables局部刷新分页方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-02-02
Springboot错误页面和错误信息定制操作
这篇文章主要介绍了Springboot错误页面和错误信息定制操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-10-10
基于SpringBoot+FFmpeg+ZLMediaKit实现本地视频推流
文章介绍了如何在服务器上安装和配置ZLMediaKit和FFmpeg,以及如何使用SpringBoot实现视频推流和播放功能,包括环境准备、后端实现和使用说明,涵盖了推流和播放的完整流程,需要的朋友可以参考下
2025-11-11
Java实现插入排序
这篇文章主要介绍了Java实现插入排序，把一列数组按从小到大或从大到小排序，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-08-08
springboot 配置日志打印不出来sql的解决方法
这篇文章主要介绍了springboot 配置日志打印不出来sql的解决方法，帮助大家更好的理解和使用springboot框架，感兴趣的朋友可以了解下
2020-11-11
MyBatis-Plus高效开发实战指南
MyBatis-Plus(简称 MP)是⼀个MyBatis的增强工具,在MyBatis的基础上只做增强不做改变,为简化开发,本文介绍MyBatis-Plus高效开发全攻略,感兴趣的朋友跟随小编一起看看吧
2026-03-03