解读@ConfigurationProperties和@value的区别

本文主要是介绍解读@ConfigurationProperties和@value的区别，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《解读@ConfigurationProperties和@value的区别》：本文主要介绍@ConfigurationProperties和@value的区别及说明,具有很好的参考价值,希望对大家...

1. 功能对比

特性	@ConfigurationProperties	@Value
作用范围	批量绑定配置文件中的一组相关属性到 Bean 的字段。	注入单个属性值到字段或参数。
松散绑定	支持松散绑定（如 myProp、my-prop、MY_PROP）。	不支持，属性名必须严格匹配。
类型安全	基于类型安全的配置绑定（字段类型自动转换）。	需要手动处理类型转换，如 @Value("${port}") int port。
SpEL 表达式	不支持 SpEL 表达式。	支持 SpEL 表达式（如 @Value("#{systemProperties['user']}")）。
默认值	通过字段初始化设置默认值（如 private String name = "default";）。	可在占位符中指定默认值（如 @Value("${name:default}")）。
验证支持	支持 jsR-30www.chinasem.cn3 验证（如 @NotNull、@Size）。	不支持验证注解。
复杂对象绑定	支持嵌套对象、集合、Map 等复杂结构的绑定。	仅支持简单类型（需手动拆分复杂结构）。

2. 使用场景对比

@ConfigurationProperties

适用场景：

需要将 一组相关的配置属性 绑定到一个对象（如数据库配置、第三方服务配置）。
需要类型安全、自动转换和松散绑定。
需要支持嵌套对象或集合类型（如 List、Map）。

示例一：

  // 配置类定义
  @Component
  @ConfigurationProperties(prefix = "app.datasource")
  public class DataSourceConfig {
      private String url;
      private String username;
http://www.chinasem.cn      private int maxPoolSize;
      // GeChina编程tters and Setters
  }
  
// 业务类调用
@Service
public class DataSourceSeChina编程rvice {
    @Autowired
    private DataSourceConfig dataConfig; // 直接注入配置对象

    public void connect() {
        System.out.println("Connecting to: " + dataConfig.getUrl() + ":" + dataConfig.getUsername());
    }
}

对应 application.properties

 # application.properties
 app.datasource.url=jdbc:mysql://localhost:3306/db
 app.datasource.username=power
 app.datasource.max-pool-size=10

对应 application.yml：

app:
  datasource:
    url: jdbc:mysql://localhost:3306/db
    username: power
   maxPoolSize: 10

示例二：

通过 @EnableConfigurationProperties 显式启用‌

‌步骤‌：

在配置类或主启动类上使用 @EnableConfigurationProperties 注解，手动注册配置类14。
通过构造函数或 @Autowired 注入配置对象。

‌代码示例‌：

/ 配置类定义（无需 @Component）
@ConfigurationProperties(prefix = "app.mail")
public class MailConfig {
    private String host;
    private int port;
    // getter/setter
}

// 主启动类显式启用
@SpringBootApplication
@EnableConfigurationProperties(MailConfig.class)
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

// 业务类调用（构造器注入）
@Service
public class MailService {
    private final MailConfig mailConfig;

    public MailService(MailConfig mailConfig) {
        this.mailConfig = mailConfig;
    }
}

@Value

适用场景：

注入 单个简单值（如开关标志、端口号）。
需要动态计算值（使用 SpEL 表达式）。
临时调试或快速原型开发。

示例：

@Component
public class MyService {
    @Value("${app.feature.enabled:false}")
    private boolean featureEnabled;

    @Value("#{systemProperties['user.timezone']}")
    private String timezone;
}

3. 核心区别详解

(1) 类型安全与松散绑定

@ConfigurationProperties：

自动将配置文件中的属性转换为字段类型（如 String → int、List）。
支持松散绑定（属性名不严格匹配），例如 myProp、my-prop、MY_PROP 都会匹配到字段 myProp。

@Value：

需要手动处理类型转换（如 @Value("${port}") int port）。
属性名必须严格匹配，否则注入失败。

(2) 复杂对象支持

@ConfigurationProperties：

支持嵌套对象和集合：

app:
  servers:
    - name: server1
      ip: 192.168.1.1
    - name: server2
      ip: 192.168.1.2

@ConfigurationProperties(prefix = "app编程China编程")
public class AppConfig {
    private List<Server> servers;
    // Getters and Setters
}

@Value：

需要手动拆分复杂结构：

@Value("${app.servers[0].name}")
private String server1Name;

(3) 验证与默认值

@ConfigurationProperties：

结合 @Validated 实现字段验证：

@ConfigurationProperties(prefix = "app")
@Validated
public class AppConfig {
    @NotNull
    private String name;
    @Min(1)
    private int maxConnections;
}

@Value：

直接在占位符中设置默认值：

@Value("${app.name:DefaultApp}")
private String appName;

4. 如何选择？

场景	推荐注解
需要绑定一组相关配置	@ConfigurationProperties
需要注入单个简单值	@Value
需要支持松散绑定或复杂结构	@ConfigurationProperties
需要使用 SpEL 动态计算值	@Value
需要类型安全与 JSR-303 验证	@ConfigurationProperties