如何优雅构建自定义 Spring Boot 验证器，让你的代码更加丝滑！-51CTO.COM

介绍

作为一名开发人员，你应该知道确保应用程序中流动的数据的准确性和完整性是多么重要。Spring Boot提供了强大的验证功能，但有时我们需要额外的验证，创建适合特定需求的自定义验证器。

接下来，我们来介绍下如何完整的创建一个自定义验证器。

步骤1：准备Spring Boot应用程序

首先，确保你已经设置了一个Spring Boot项目。可以选择使用Maven或Gradle作为构建工具。在项目的配置文件（pom.xml或build.gradle）中包含必要的依赖项，如spring-boot-starter-web和
spring-boot-starter-validation。

步骤2：创建模型类

创建一个模型类来表示要验证的数据。例如，创建一个简单的User类，包含一个用户名和电子邮件字段：

public class User {
    private String username;
    private String email;

    // getters and setters
}

步骤3：创建自定义验证器

接下来，通过实现org.springframework.validation.Validator接口来创建一个自定义验证器类。该接口定义了supports()和validate()两个方法。

supports()方法检查验证器是否支持给定的类。在我们的例子中，我们想要验证User类，所以如果提供的类是User类或其子类之一，则该方法应返回true。

validate()方法执行实际的验证逻辑，我们可以访问正在验证的对象，执行检查，并使用
org.springframework.validation.Errors对象添加验证错误。

以下是User类的自定义验证器示例：

import org.springframework.validation.Errors;
import org.springframework.validation.ValidationUtils;
import org.springframework.validation.Validator;

public class UserValidator implements Validator {

    @Override
    public boolean supports(Class<?> clazz) {
        return User.class.equals(clazz);
    }

    @Override
    public void validate(Object target, Errors errors) {
        User user = (User) target;

        ValidationUtils.rejectIfEmptyOrWhitespace(errors, "username", "NotEmpty");
        ValidationUtils.rejectIfEmptyOrWhitespace(errors, "email", "NotEmpty");

        // Add additional validation logic
        // Example:
        // if (user.getUsername().length() < 5) {
        //     errors.rejectValue("username", "Size.userForm.username");
        // }
    }
}

步骤4：注册自定义验证器

为了让Spring Boot知道自定义验证器，我们需要进行注册。打开应用程序的配置类（通常使用@Configuration注解），并添加一个@Bean方法来实例化自定义验证器。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.validation.Validator;
import org.springframework.validation.beanvalidation.LocalValidatorFactoryBean;

@Configuration
public class AppConfig {

    @Bean
    public Validator validator() {
        return new UserValidator();
    }

    // 其他配置类和方法...
}

步骤5：使用自定义验证器

要将自定义验证器应用于所需的端点，需要使用@Valid注解相应的方法参数，来触发该对象的验证过程。例如，有一个用于创建新用户的RESTful端点：

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

    @PostMapping
    public ResponseEntity<String> createUser(@Valid @RequestBody User user) {
        // 处理用户创建逻辑

        return ResponseEntity.ok("User created successfully");
    }
}

在这个例子中，对user参数使用@Valid注解表示应该使用注册的自定义验证器进行验证。

步骤6：提供错误消息

为了给自定义验证约束提供有意义的错误消息，需要在项目的src/main/resources目录中创建一个messages.properties文件。该文件用于不同的验证约束定义自定义错误消息。打开messages.properties文件并添加以下条目：

# 自定义错误消息
NotEmpty.user.username=Username cannot be empty
NotEmpty.user.email=Email cannot be empty
Size.userForm.username=Username must be at least 5 characters long

在上面的示例中，我们为NotEmpty和Size约束定义了错误消息。

步骤7：测试自定义验证器

现在，我们可以通过触发验证过程来测试自定义验证器。如果发生任何验证错误，它们将自动添加到BindingResult对象中。例如，假设有一个用于创建新用户的请求：

POST /users
Content-Type: application/json

{
  "username": "",
  "email": "test@example.com"
}

当发送这个请求时，验证过程将被触发，如果用户名字段为空，将会向BindingResult中添加一个验证错误。

为了处理验证错误，我们可以修改UserController中的createUser方法，如下所示：

@PostMapping
public ResponseEntity<String> createUser(@Valid @RequestBody User user, BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
        // 处理验证错误
        List<ObjectError> errors = bindingResult.getAllErrors();
        // 按需处理并返回错误消息
        // 示例: return ResponseEntity.badRequest().body(errors.toString());
    }

    // 如果验证通过，继续处理用户创建逻辑

    return ResponseEntity.ok("User created successfully");
}

在这个例子中，如果存在验证错误，可以使用bindingResult.getAllErrors()从BindingResult对象中检索错误。然后，根据应用程序的需求处理和处理这些错误。

这样，我们已经成功地在Spring Boot应用程序中创建并使用了自定义验证器。自定义验证器允许我们为特定字段或对象定义自己的验证逻辑和错误消息，从而控制验证过程。