@Value，@ConfigurationProperties

@Value 和 @ConfigurationProperties 都是 Spring (及 Spring Boot) 中用来注入配置属性的注解，但它们在使用方式、适用场景和功能特性上有所不同。

@Value vs. @ConfigurationProperties 关键知识点 🎯

以下是这两个注解的对比和关键知识点：

@Value

• 目的: 主要用于注入单个配置属性值到类的字段或方法参数上。
• 语法: @Value("${property.name}")
  • 可以直接引用属性名。
  • 支持 SpEL (Spring Expression Language)，可以进行更复杂的表达式求值，例如设置默认值 @Value("${property.name:defaultValue}") 或引用系统属性 @Value("${user.home}")。
• 类型转换: Spring 会尝试将字符串形式的属性值转换为目标字段的类型。
• setter 方法: 不需要 setter 方法。可以直接注入到 private 字段。
• 元数据: 不支持生成配置元数据文件 (spring-configuration-metadata.json)，这意味着在 IDE 中可能无法获得对这些属性的自动完成或提示。
• 校验: 不直接支持 JSR-303 (Bean Validation) 校验，需要自行实现或与其他机制结合。
• 层级/结构化配置: 对于层级复杂或结构化的配置，使用多个 @Value 会显得冗长和分散，不易管理。
• 宽松绑定 (Relaxed Binding): 支持程度有限，通常需要属性名精确匹配（除非通过 SpEL 进行处理）。
• 适用场景:
  • 注入少量、零散的配置项。
  • 需要使用 SpEL 进行动态计算或设置默认值。
  • 注入单个外部化配置。

@ConfigurationProperties

• 目的: 主要用于将一组相关的、具有层级结构的配置属性映射到一个强类型的 Java Bean。
• 语法: @ConfigurationProperties(prefix = "my.app.config")
  • prefix 指定了配置文件中属性的前缀。
• 类型转换: 自动进行复杂的类型转换，包括集合、嵌套对象等。
• setter 方法/构造函数绑定:
  • 默认情况下，需要为要绑定的字段提供公共的 setter 方法。
  • 支持构造函数绑定 (通过 @ConstructorBinding 或默认单参数构造函数)，这种情况下不需要 setter，且可以创建不可变配置对象 (字段声明为 final)。
• 元数据: 支持生成配置元数据 (spring-configuration-metadata.json)。当添加 spring-boot-configuration-processor 依赖后，IDE 可以为这些配置属性提供自动完成、提示和文档。
• 校验: 直接支持 JSR-303 (Bean Validation) 注解 (如 @Validated 在类上, @NotNull, @Min 等在字段上) 对绑定的属性值进行校验。
• 层级/结构化配置: 非常适合处理复杂、具有层级结构的配置，使配置在 Java 代码中更具组织性和类型安全性。
• 宽松绑定 (Relaxed Binding): 强大支持。配置文件中的属性名 (如 my-property-name 或 MY_PROPERTY_NAME) 可以灵活地映射到 Java Bean 中的驼峰命名属性 (如 myPropertyName)。
• 适用场景:
  • 管理一组相关的配置属性 (例如数据库连接池配置、某个服务客户端的配置)。
  • 需要对配置进行结构化和类型安全的管理。
  • 需要配置校验。
  • 希望 IDE 提供配置属性的自动完成和提示。

对比总结

建议：

• 当需要注入少量、独立的配置值，或者需要利用 SpEL 的灵活性时，使用 @Value。
• 当需要管理一组结构化的配置属性，并希望获得类型安全、IDE 自动完成和校验支持时，强烈推荐使用 @ConfigurationProperties。在大多数 Spring Boot 应用中，后者是更常用和推荐的方式来管理应用配置。