springboot中@Validated注解

最新推荐文章于 2025-06-06 18:45:52 发布

tang_xiao_zhuang

最新推荐文章于 2025-06-06 18:45:52 发布

阅读量875

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/Tang_IT/article/details/118424923

springboot 专栏收录该内容

9 篇文章

订阅专栏

本文介绍了SpringBoot中使用@Validated和@ConfigurationProperties进行数据校验和YAML配置信息绑定。当使用@Email等注解时，需要引入validation启动器。通过示例展示了Person实体类的配置及yaml内容，当邮箱格式错误时，系统会抛出异常。同时列举了常见的数据校验注解，如@Null、@NotBlank等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一般@Validated注解用于数据校验

注意:使用@Email等注解爆红,原因是新版本需要引入validation启动器

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

例如以下实体类Person

@Data
@AllArgsConstructor
@NoArgsConstructor
@Component
@ConfigurationProperties(prefix = "person") //yaml配置信息绑定javabean
@Validated //数据校验
public class Person {
    @Email("邮箱格式错误") //校验是否是邮箱格式
    private String email;
    private String name;
    private Integer age;
    private Boolean happy;
    private Date birthday;
    private Map<String, Object> map;
    private List<Object> list;
    private Dog dog;
}

yaml配置内容如下

person:
  email: 123456789@gmail.com
  name: xiaozhuang${random.uuid}
  age: 26
  happy: false
  birthday: 2021/07/02
  map: {k1: v1,k2: v2}
  list:
    - code
    - music
    - girl
  dog:
    name: 旺财
    age: 3

创建测试类,输出Person类的内容

@SpringBootTest
class Springboot05ConfigApplicationTests {

    @Autowired
    private Person person;

    @Test
    void contextLoads() {
        System.out.println(person);
    }
}

输出内容正常
在这里插入图片描述
修改yaml配置文件中的email,改成一个错误格式,如下所示

person:
  email: 123456789 #@gmail.com
  name: xiaozhuang${random.uuid}
  age: 26
  happy: false
  birthday: 2021/07/02
  map: {k1: v1,k2: v2}
  list:
    - code
    - music
    - girl
  dog:
    name: 旺财
    age: 3

启动测试类,错误描述如下:
在这里插入图片描述
常用注解如下:

空检查
@Null       验证对象是否为null
@NotNull    验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank   检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
@NotEmpty   检查约束元素是否为NULL或者是EMPTY.
    
Booelan检查
@AssertTrue     验证 Boolean 对象是否为 true  
@AssertFalse    验证 Boolean 对象是否为 false  
    
长度检查
@Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内  
@Length(min=, max=) string is between min and max included.

日期检查
@Past       验证 Date 和 Calendar 对象是否在当前时间之前  
@Future     验证 Date 和 Calendar 对象是否在当前时间之后  
@Pattern    验证 String 对象是否符合正则表达式的规则