在现代Web开发中，数据的有效性验证是确保系统稳定性和用户体验的关键。Spring Boot作为轻量级的框架，提供了强大的参数校验功能，让开发者能够轻松实现这一需求。本文将深入探讨Spring Boot的参数校验机制，带你领略其魅力所在。

一、Spring Boot参数校验基础

Spring Boot的参数校验功能主要依赖于spring-boot-starter-validation依赖。这个starter不仅简化了验证过程，还整合了验证相关的所有依赖，包括jakarta.validation-api和hibernate-validator。引入这个依赖后，你就可以在项目中使用各种验证注解来确保数据的有效性。

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

二、常用验证注解

在Spring Boot中，有许多常用的验证注解，它们可以帮助你轻松实现数据的有效性验证。以下是一些常见的注解及其用法：

1. @NotNull：确保字段不为null。

   public class User {
       @NotNull(message = "用户名不能为空")
       private String username;
   }
   

2. @NotBlank：确保字段不为null且不为空字符串。

   public class User {
       @NotBlank(message = "用户名不能为空")
       private String username;
   }
   

3. @NotEmpty：确保集合、数组等不为空。

   public class User {
       @NotEmpty(message = "邮箱不能为空")
       private List<String> emails;
   }
   

4. @Size：验证字符串、集合、数组等的大小是否符合要求。

   public class User {
       @Size(min = 5, max = 20, message = "用户名长度必须在5到20个字符之间")
       private String username;
   }
   

5. @Pattern：用于正则表达式验证。

   public class User {
       @Pattern(regexp = "^[a-zA-Z]{6,}$", message = "用户名必须是至少6个字母")
       private String username;
   }
   

6. @Min 和 @Max：验证数值是否在指定的最小值或最大值之间。

   public class Product {
       @Min(value = 1, message = "价格必须大于等于1")
       @Max(value = 1000, message = "价格必须小于等于1000")
       private double price;
   }
   

7. @Email：验证字段是否为有效的电子邮件地址。

   public class User {
       @Email(message = "请输入有效的邮箱地址")
       private String email;
   }
   

8. @Future 和 @Past：验证日期是否在未来或过去。

   public class Event {
       @Future(message = "事件日期必须是未来的日期")
       private Date eventDate;
   }
   

三、使用步骤

使用这些注解非常简单，只需在Java Bean的字段上添加相应的注解即可。在Controller中，你可以使用@Valid或@Validated注解来触发验证。

@PostMapping("/register")
public Result register(@Valid @RequestBody User user) {
    // 注册逻辑
}

处理验证错误时，你可以使用BindingResult来捕获验证结果，或者让Spring自动处理验证错误，返回400错误。

四、分组校验

除了基本的验证注解外，Spring Boot还支持分组校验。你可以为验证规则定义不同的分组，然后在调用时指定需要验证的分组，控制哪些验证规则应该被触发。

public interface Add {
}

public interface Update {
}

public class Article {
    @NotNull(groups = Update.class)
    private Integer id;

    @NotEmpty(groups = Add.class, message = "文章标题不能为空！")
    @Pattern(regexp = "^\S{1,30}$", message = "文章标题是1到30个字符！")
    private String title;

    @NotEmpty(groups = Add.class, message = "文章内容不能为空！")
    private String content;
}

在控制器中这样使用：

@PutMapping("/article/{id}")
public Result update(@PathVariable Long id, @RequestBody @Validated(Article.Update.class) Article article) {
    boolean updateResult = articleService.update(article);
    if (updateResult) {
        return Result.success();
    } else {
        return Result.error("该文章标题已经存在！");
    }
}

@PostMapping("/article")
public Result add(@RequestBody @Validated(Article.Add.class) Article article) {
    boolean addResult = articleService.add(article);
    if (addResult) {
        return Result.success();
    } else {
        return Result.error("文章添加失败！");
    }
}

五、@valid和@Validated的区别和使用场景

@Valid注解用于触发对象级别的验证，适用于不需要控制验证范围的场景。而@Validated注解是Spring Framework提供的注解，主要用于支持分组验证，适用于更复杂的验证场景。

使用场景：

• 使用@Valid：当你想对方法参数或字段进行简单的验证时。
• 使用@Validated：当你需要根据不同的验证分组来控制验证的范围，或者你希望对不同的验证场景进行不同的校验时。

通过以上介绍，相信你对Spring Boot的参数校验有了更深入的了解。掌握这些知识，将帮助你在开发过程中轻松实现数据有效性验证，提升系统的稳定性和用户体验。