SpringBoot - @ConfigurationProperties注解使用详解

原创

已于 2022-02-21 11:20:50 修改 · 3.6k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot

于 2022-02-11 15:23:38 首次发布

本文详细介绍了@ConfigurationProperties注解在Spring Boot中用于配置绑定的作用，它能将配置文件中的属性与Bean对象自动绑定。文章通过三种不同的方式展示了如何在@Component、@Configuration和@Bean上使用该注解，并提供了配置对象的示例代码和配置文件内容。同时，提到了支持的数据校验和复杂数据类型的绑定，使得配置管理更加便捷。

@ConfigurationProperties注解的作用是什么？

将标注了@ConfigurationProperties注解的Spring容器中的Bean与配置文件中的属性进行一一绑定，用于更加快速、方便的读取配置文件的内容。
也就是：先将属性对象注册到Spring容器中，再进行属性的绑定。

@ConfigurationProperties注解可以搭配使用的注解有哪些？

只要能够将属性对象注册到Spring容器中的注解都可以搭配使用。
@RestController、@Service、@Repository、@Component、@Configuration、@Bean都可以和@ConfigurationProperties注解搭配使用。

@ConfigurationProperties注解如何使用？

1.需要将配置对象类注入到Spring容器中，一般使用@Component(组件类)进行注入，当然@RestController、@Service、@Repository都属于@Component，因为他们有更准确的意义，所以一般使用@Component；或者不使用组件类，而是在启动类上使用@EnableConfigurationProperties(DroolsProperties.class)，将配置对象类注入到Spring容器中；或者在定义Bean的时候将配置信息和配置对象的属性进行一一绑定。
2.需要指定前缀，用于表示该前缀下面的配置信息需要和配置对象的属性进行一一绑定；
3.只能加载全局配置文件(application.yml/.properties，application-XXX.yml/.properties)；
4.支持数据校验，如：不能为空，长度，正则等校验；
5.支持复杂的数据类型，如：list、map；

①. 使用@Component + @ConfigurationProperties(prefix = “spring.drools”)，这两个注解都标注在配置对象上。

DroolsProperties.java如下：

@Data
@Component
@ConfigurationProperties(prefix = "spring.drools")
public class DroolsProperties {
   
   

    // 规则文件和决策表的路径(多个目录使用逗号分割)
    private String path;

    // 更新缓存的轮询周期 - 单位：