spring-boot-starter-validation校验框架

介绍

Spring Boot Starter Validation是一个Spring Boot模块，用于简化应用程序中的验证功能。它包含以下依赖：

• Hibernate Validator：Hibernate Validator是JavaBean Validation（JSR 380）规范的参考实现，提供了一组用于验证Java对象的约束和注解。
• javax.validation API：javax.validation API是JavaBean Validation的API，定义了可用于验证的约束和注解集。
• Spring Validation：Spring Validation是一个模块，用于将JavaBean Validation与Spring Framework集成，包括对方法参数和返回值的验证支持。

注解全解

使用Spring Boot Starter Validation，您可以轻松地将验证功能添加到应用程序中。以下是一些常见的验证注解：

• @Null：被注释的元素必须为null。
• @NotNull：被注释的元素必须不为null。
• @AssertTrue：被注释的元素必须为true。
• @AssertFalse：被注释的元素必须为false。
• @Min(value)：被注释的元素必须是一个数字，其值必须大于或等于指定的最小值。
• @Max(value)：被注释的元素必须是一个数字，其值必须小于或等于指定的最大值。
• @Size(min, max)：被注释的元素必须是一个字符串、集合、数组或映射，其大小必须在指定的最小和最大值之间。
• @Pattern(regexp)：被注释的元素必须是一个字符串，并且必须与指定的正则表达式匹配。
• @Valid：被注释的元素必须是一个有效的对象，其所有约束都必须通过验证。

以下是一个使用Spring Boot Starter Validation的示例：

首先，在Spring Boot应用程序中添加以下依赖：

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

接下来，创建一个包含验证注解的JavaBean：

public class Person {
    @NotNull
    @Size(min = 2, max = 50)
    private String name;

    @Min(18)
    @Max(100)
    private int age;

    // getters and setters
}

然后，在控制器中使用@Valid注解来验证JavaBean：

@RestController
public class PersonController {
    @PostMapping("/persons")
    public ResponseEntity createPerson(@Valid @RequestBody Person person) {
        // Do something with the person object
        return ResponseEntity.ok().build();
    }
}

最后，当调用createPerson方法时，Spring Boot将自动验证Person对象，如果验证失败，将返回一个400错误响应。

@Valid和@Pattern(regexp)是Spring Boot Starter Validation中两个常见的验证注解，用于验证Java对象和字符串。

@Valid

---

@Valid是一个用于在控制器方法参数上启用验证的注解。当在控制器方法参数上使用@Valid注解时，Spring Boot将自动验证该参数的所有约束，如果验证失败，则返回一个400错误响应。

例如，在下面的示例中，Person对象包含@NotNull和@Size注解，用于验证name属性。在PersonController中，使用@Valid注解来验证Person对象：

public class Person {
    @NotNull
    @Size(min = 2, max = 50)
    private String name;

    // getters and setters
}

@RestController
public class PersonController {
    @PostMapping("/persons")
    public ResponseEntity createPerson(@Valid @RequestBody Person person) {
        // Do something with the person object
        return ResponseEntity.ok().build();
    }
}

当调用createPerson方法时，Spring Boot将自动验证Person对象的name属性，如果name为null或长度不在2到50之间，则返回一个400错误响应。

@Pattern(regexp)

---

@Pattern(regexp)是一个用于验证字符串是否匹配指定正则表达式的注解。在使用@Pattern(regexp)注解时，需要提供一个regexp属性，用于指定正则表达式。

例如，在下面的示例中，使用@Pattern(regexp)注解来验证email属性是否符合电子邮件地址的格式：

public class Person {
    @Pattern(regexp = "^[\\w!#$%&'*+/=?`{|}~^-]+(?:\\.[\\w!#$%&'*+/=?`{|}~^-]+)*@(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,6}$")
    private String email;

    // getters and setters
}

当验证Person对象时，Spring Boot将自动验证email属性是否符合指定的正则表达式。如果不符合，则返回一个400错误响应。

需要注意的是，在使用@Pattern(regexp)注解时，正则表达式可能会很复杂，因此需要仔细测试和验证。同时，也需要注意正则表达式的性能问题，避免使用过于复杂的正则表达式导致验证性能下降。

总之，@Valid和@Pattern(regexp)是Spring Boot Starter Validation中两个常见的验证注解，用于验证Java对象和字符串。它们可以帮助我们简化应用程序中的验证功能，提高代码的可读性和可维护性。