【Spring Boot 注解】@ConfigurationProperties

文章目录

@ConfigurationProperties注解

一、简介

@ConfigurationProperties 是 Spring Boot 提供的一个强大注解,用于将外部配置(如 application.properties 或 application.yml 文件中的属性)绑定到 Java 对象上。

二、依赖引入

xml 复制代码
<dependencies>
    <!-- Spring Boot 配置绑定支持 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-configuration-processor</artifactId>
        <optional>true</optional> <!-- Optional 是为了不影响运行时的依赖 -->
    </dependency>
</dependencies>

说明

  • spring-boot-configuration-processor:该依赖用于生成配置元数据,它会帮助你的 IDE 提供自动补全、文档提示等功能,方便配置类的开发。
  • optional=true:这表示这个依赖不会影响项目的运行,它只是编译时依赖,生成配置元数据。

三、基本用法

java 复制代码
@ConfigurationProperties(prefix = "database")
public class DatabaseProperties {
    private Connection connection;
    private Pool pool;
    
    // 嵌套类
    public static class Connection {
        private String url;
        private String username;
        private String password;
        // getters and setters
    }
    
    public static class Pool {
        private int maxActive;
        private int maxIdle;
        // getters and setters
    }
	// 数组
	private List<String> servers;
    // getters and setters
}

对应的 application.properties:

xml 复制代码
database:
  connection:
    url: jdbc:mysql://localhost/test
    username: root
    password: secret
  pool:
    max-active: 10
    max-idle: 5
    
my:
  servers:
    - 192.168.1.1
    - 192.168.1.2
    - 192.168.1.3

四、主要特性

  • 前缀绑定:通过 prefix 属性指定配置前缀
  • 类型安全:自动将属性值转换为目标类型
  • 嵌套属性支持:支持复杂对象的嵌套配置
  • 集合支持:支持 List、Map 等集合类型
  • 验证支持:可与 JSR-303 验证注解结合使用

五、激活方式

1.与 @Configuration 一起使用

适用于配置类场景,常和 @Bean 配合手动注册:

java 复制代码
@Configuration
public class MyConfig {

    @Bean
    @ConfigurationProperties(prefix = "app")
    public AppProperties appProperties() {
        return new AppProperties();
    }
}

2.通过 @EnableConfigurationProperties 启用

适用于第三方配置类或不想在类上加 @Component 的情况:

java 复制代码
@Configuration
@EnableConfigurationProperties(AppProperties.class)
public class MyConfig {
}

此时 AppProperties 类只需要加 @ConfigurationProperties:

java 复制代码
@ConfigurationProperties(prefix = "app")
public class AppProperties {
    private String name;
    // getters/setters...
}

常用于你不控制源代码的类(比如第三方 jar 包中的配置类)或为了更清晰地分离配置绑定与组件扫描。

3.作为常规 Spring Bean 注册(配合 @Component)

java 复制代码
@Component
@ConfigurationProperties(prefix = "app")
public class AppProperties {
    private String name;
}

使用 @Component,Spring 会自动将其注册为 Bean,前提是类被包扫描路径覆盖到。

六,优点

1.解耦配置:不需要在代码中硬编码配置,能够从外部配置文件(如 application.yml 或 application.properties)中获取配置。

2.自动绑定:Spring Boot 会根据配置文件中的属性名自动绑定到对应的字段。

3.类型安全:相比使用 @Value 注解,@ConfigurationProperties 提供了更强的类型安全,尤其是当配置项较多时,使用起来更加方便。

七、与 @Value 对比

特性 @ConfigurationProperties @Value
松散绑定 ✅ 支持(如 kebab-casecamelCase ❌ 不支持
复杂类型 ✅ 支持(嵌套对象、集合等) ⚠️ 有限支持(基本类型、简单集合)
验证 ✅ 支持(结合 @Validated ❌ 不支持
SpEL 表达式 ❌ 不支持 ✅ 支持(如 #{systemProperties['prop']}
适合场景 多个相关属性(统一管理配置类) 单个简单属性(分散注入)
相关推荐
java水泥工5 分钟前
网上摄影工作室|基于SpringBoot和Vue的网上摄影工作室(源码+数据库+文档)
数据库·vue.js·spring boot
绝无仅有6 分钟前
面试复盘:哔哩哔哩、蔚来、字节跳动、小红书面试与总结
后端·面试·github
绝无仅有12 分钟前
面试经历分享:从特斯拉到联影医疗的历程
后端·面试·github
IT_陈寒13 分钟前
JavaScript性能优化:这7个V8引擎技巧让我的应用速度提升了50%
前端·人工智能·后端
计算机毕业设计小帅6 小时前
【2026计算机毕业设计】基于Springboot的Android校园周边美食汇系统
android·spring boot·课程设计
Tony Bai6 小时前
【Go开发者的数据库设计之道】07 诊断篇:SQL 性能诊断与问题排查
开发语言·数据库·后端·sql·golang
花花鱼7 小时前
spring boot项目使用tomcat发布,也可以使用Undertow(理论)
spring boot·后端·tomcat
你的人类朋友9 小时前
快速搭建redis环境并使用redis客户端进行连接测试
前端·redis·后端
这里是杨杨吖9 小时前
SpringBoot+Vue医院预约挂号系统 附带详细运行指导视频
vue.js·spring boot·医院·预约挂号
2351610 小时前
【MySQL】数据库事务深度解析:从四大特性到隔离级别的实现逻辑
java·数据库·后端·mysql·java-ee