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工具类在任意位置进行手动校验

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

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

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

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

您可能感兴趣的文章:

java Springboot对接开发微信支付详细流程
最近要做一个微信小程序,需要微信支付,所以研究了下怎么在java上集成微信支付功能,下面这篇文章主要给大家介绍了关于java Springboot对接开发微信支付的相关资料,需要的朋友可以参考下
2024-08-08
HashMap 和 Hashtable的区别
本文主要介绍HashMap 和 Hashtable的区别,这里整理了相关资料并详细介绍了HashMap 和 Hashtable的区别及其工作原理和使用方法，有需要的朋友可以看一下
2016-09-09
MyBatis中#{}和${}的区别详解
mybatis和ibatis总体来讲都差不多的。下面小编给大家探讨下mybatis中#{}和${}的区别，感兴趣的朋友一起学习吧
2016-08-08
java实现图片任意角度旋转
这篇文章主要为大家详细介绍了java实现图片任意角度旋转，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2019-04-04
Dom4j解析XML_动力节点Java学院整理
这篇文章主要介绍了Dom4j解析XML，dom4j是一个Java的XML API，类似于jdom，用来读写XML文件的，有兴趣的可以了解一下
2017-07-07
SpringBoot的WebSocket实现单聊群聊
这篇文章主要为大家详细介绍了SpringBoot的WebSocket实现单聊群聊，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-02-02
java8 stream 操作map根据key或者value排序的实现
这篇文章主要介绍了java8 stream 操作map根据key或者value排序的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-09-09
Spring Boot使用线程池处理上万条数据插入功能
这篇文章主要介绍了Spring Boot使用线程池处理上万条数据插入功能,使用步骤是先创建一个线程池的配置，让Spring Boot加载，用来定义如何创建一个ThreadPoolTaskExecutor，本文通过实例代码给大家介绍的非常详细，需要的朋友参考下吧
2022-08-08
Hadoop1.2中配置伪分布式的实例
这篇文章主要介绍了Hadoop1.2中配置伪分布式的实例,使用的系统是linux mint 15 64bit，hadoop使用的是1.2.1版本,需要的朋友可以参考下
2014-04-04
如何用java给一个文件夹打成压缩包(附代码)
项目中需要将文件夹打包成压缩包下载,所以下面这篇文章主要给大家介绍了关于如何用java给一个文件夹打成压缩包的相关资料,文中给出了详细的代码示例,需要的朋友可以参考下
2023-10-10