在 SpringBoot 中使用 Spring Validation 对参数进行校验

本文介绍: 本文将介绍在Spr in gBo o t中使用进行接口参数校验的方法。首先解决了为什么要进行接口参数校验、为什么后端还需要进行参数校验、为什么要使用参数校验框架等问题。接着详细介绍了在Spr i n gBo o t中使用进行参数校验的方法，并列出了一些常用注解。最后，本文还解决了当前端发送的请求中有些参数不需要进行校验时应该怎么办的问题。

本文将介绍在 SpringBoot 中使用 Spring Validation 进行接口参数校验的方法。首先解决了为什么要进行接口参数校验、为什么后端还需要进行参数校验、为什么要使用参数校验框架等问题。接着详细介绍了在 SpringBoot 中使用 Spring Validation 进行参数校验的方法，并列出了一些常用注解。最后，本文还解决了当前端发送的请求中有些参数不需要进行校验时应该怎么办的问题。

接口参数校验是指对于接口传入的参数进行检查和验证，以确保参数的合法性和正确性。这是确保系统的稳定性、安全性和可靠性的重要措施。

总之，接口参数校验是保证系统安全、可靠、稳定的必要措施，可以避免非法输入、恶意攻击和数据泄露等问题。

虽然前端已经对请求参数进行了校验，但是前端只是为了提高用户体验和减轻服务器的负担而进行的简单校验，并不能完全保证数据的安全性和正确性。因此，后端也需要对参数进行校验，以确保数据的合法性和正确性，避免恶意攻击和数据泄露等问题。

1.3. 我们 可以 使用 `if else` 进行参数校验，为什么要使用参数校验框架呢？

虽然使用 if else 进行参数校验可以实现基本的校验功能，但是这种方式存在以下几个问题：

因此，使用参数校验框架可以有效地解决上述问题，具有以下几个优点：

2. 为什么要使用 `Spring Validation` 权限校验框架？

这些框架都可以实现对参数的校验，提供了一套完整的校验规范和 API ，可以有效地避免非法参数和恶意攻击，提高系统的安全性和可靠性。根据不同的业务需求和技术栈，可以选择不同的框架进行参数校验。

总之，使用 pring Validation 参数校验框架可以提高代码的可读性和可维护性，减少代码冗余，提高开发效率，同时还可以有效地避免非法参数和恶意攻击，提高系统的安全性和可靠性。

3. 在 `SpringBoot` 中使用 `Spring Validation`

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

@RestController
@RequestMapping("/user")
@Validated
public class UserController {

    @PostMapping("/add")
    public User addUser(@RequestBody @Valid User user) {
        // ...
    }
}

在 addUser 方法的参数列表中使用 @Valid 注解进行参数校验，@RequestBody 注解用于将请求体中的 JSON 对象自动映射为 Java 对象。

public class User {

    @NotBlank(message = "用户名不能为空")
    private String username;

    @NotBlank(message = "密码不能为空")
    private String password;

    @Email(message = "邮箱格式不正确")
    private String email;

    // 省略 getter 和 setter 方法
}

在 User 类的属性上使用校验注解，例如 @NotBlank、@Email 等，message 属性用于指定校验失败时的错误提示信息。

当控制器方法的参数校验失败时，会抛出 MethodArgumentNotValidException 异常，此时可以通过定义全局异常处理器中的 handleMethodArgumentNotValidException 方法来处理该异常。

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Result handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        List<ObjectError> allErrors = e.getBindingResult().getAllErrors();
        StringBuilder errorMsg = new StringBuilder();
        for (ObjectError error : allErrors) {
            errorMsg.append(error.getDefaultMessage()).append("; ");
        }
        return Result.fail(errorMsg.toString());
    }

    @ExceptionHandler(Exception.class)
    public Result handleException(Exception e) {
        return Result.fail(e.getMessage());
    }
}

在 GlobalExceptionHandler 类中添加对 MethodArgumentNotValidException 异常的处理，将校验失败的错误提示信息封装到 Result 对象中返回给客户端。

使用 Postman 或其他工具向 /user/add 接口发送 POST 请求，请求体中需要包含 username、password 和 email 三个参数。如果参数校验失败，接口将返回错误提示信息。例如，当 username 为空时，接口将返回以下错误信息：

{
    "code": 1,
    "msg": "参数校验失败",
    "data": "用户名不能为空; "
}

4. `Spring Validation` 的常用注解

Spring Validation 提供了很多注解，用于对参数进行校验。

@NotNull(message = "用户名不能为空")
private String username;

@NotBlank(message = "用户名不能为空")
private String username;

@Size(min = 6, max = 20, message = "密码长度必须在6-20个字符之间")
private String password;

@Size(min = 1, max = 10, message = "至少选择一个爱好，最多选择10个")
private List<String> hobbies;

@Size(min = 1, max = 3, message = "至少选择一个菜，最多选择3个")
private String[] dishes;

@Min(value = 1, message = "年龄必须大于等于1岁")
@Max(value = 150, message = "年龄必须小于等于150岁")
private Integer age;

@DecimalMin(value = "0.01", message = "价格不能低于0.01元")
@DecimalMax(value = "9999.99", message = "价格不能超过9999.99元")
private BigDecimal price;

@Pattern(regexp = "^[a-zA-Z0-9]{4,20}$", message = "用户名必须由4-20个字母或数字组成")
private String username;

@Email(message = "请输入正确的邮箱地址")
private String email;

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

    @Valid
    private Address address;

    // getter 和 setter 方法省略
}

public class Address {
    @NotBlank(message = "所在城市不能为空")
    private String city;

    @NotBlank(message = "详细地址不能为空")
    private String detail;

    // getter 和 setter 方法省略
}

@RestController
@Validated
public class UserController {

    @PostMapping("/users")
    public ResponseEntity<User> createUser(@Valid @RequestBody User user) {
        // 处理请求，创建用户
        return ResponseEntity.ok(user);
    }
}

在上面的示例中，@Valid 注解用于标记 User 对象需要进行校验。在方法执行时，Spring 会自动根据 User 对象的属性上的校验注解对其进行校验，如果校验不通过，则会抛出 ConstraintViolationException 异常。

需要注意的是，为了使校验注解生效，控制器类需要添加 @Validated 注解。

前端发送的请求，有些参数不需要进行校验。比如我们更新一个用户，而我们对 JavaBean 的所有参数都进行了校验，那这个请求就被拒绝了，这种请求我们应该怎么办？

当我们在校验接口参数时，有些 JavaBean 参数不需要进行校验，可以使用 Spring Validation 提供的 @Validated 和 @Valid 注解结合分组校验来实现。

首先，在 JavaBean 参数上使用校验注解时，可以为注解指定一个分组。示例代码如下：

public class User {

    @NotBlank(message = "用户名不能为空", groups = {Create.class, Update.class})
    private String username;

    @NotBlank(message = "密码不能为空", groups = {Create.class})
    private String password;

    @NotBlank(message = "手机号不能为空", groups = {Create.class})
    private String mobile;

    // getter 和 setter 方法省略
}

在上面的示例中，@NotBlank 注解被分为了两个组：Create 和 Update，对应着创建和更新操作。这样，当我们对 User 对象进行校验时，只需要指定需要校验的组即可。示例代码如下：

@RestController
@Validated
public class UserController {

    @PostMapping("/users")
    public ResponseEntity<User> createUser(@Validated(Create.class) @RequestBody User user) {
        // 处理请求，创建用户
        return ResponseEntity.ok(user);
    }

    @PutMapping("/users/{id}")
    public ResponseEntity<User> updateUser(@PathVariable Long id, @Validated(Update.class) @RequestBody User user) {
        // 处理请求，更新用户
        return ResponseEntity.ok(user);
    }
}

在上面的示例中，@Validated 注解用于标记控制器类需要进行校验，并通过 groups 属性指定需要校验的分组。@Validated 注解可以作用在控制器类或方法上。@Validated 注解和 @Valid 注解的区别在于，@Validated 注解可以指定需要校验的分组，而 @Valid 注解不支持分组校验。