编辑“︁Spring属性源（PropertySource）”︁（章节）

= Spring属性源（PropertySource） =

'''Spring属性源'''（PropertySource）是Spring框架中用于管理应用程序配置属性的核心抽象，它提供了一种统一的方式来访问不同来源（如.properties文件、环境变量、系统属性等）的配置数据。通过属性源机制，开发者可以灵活地组织、覆盖和扩展应用程序的配置。

== 核心概念 ==

=== 属性源定义 ===
在Spring中，<code>PropertySource</code>是一个抽象类（位于<code>org.springframework.core.env</code>包），其子类表示具体的属性来源。每个属性源包含一组键值对，例如：
* <code>application.properties</code>文件中的配置
* 操作系统环境变量
* JVM系统属性（<code>-D</code>参数）

=== 属性源层级 ===
Spring会按照以下优先级顺序（从高到低）解析属性：
# JVM系统属性（<code>-D</code>）
# 环境变量
# 配置文件（如<code>application.properties</code>）

可通过以下Mermaid图表示层级关系：
<mermaid>
graph TD
    A[JVM System Properties] -->|最高优先级| B[Environment Variables]
    B --> C[Application Properties]
</mermaid>

== 代码示例 ==

=== 基础用法 ===
以下示例展示如何通过<code>@Value</code>注解注入属性：

<syntaxhighlight lang="java">
@Configuration
public class AppConfig {
    @Value("${app.name}") // 从属性源读取值
    private String appName;

    @Bean
    public void printConfig() {
        System.out.println("Application Name: " + appName);
    }
}
</syntaxhighlight>

对应的<code>application.properties</code>：
<syntaxhighlight lang="properties">
app.name=MySpringApp
</syntaxhighlight>

'''输出结果'''：
<pre>
Application Name: MySpringApp
</pre>

=== 自定义属性源 ===
实现自定义属性源需要继承<code>PropertySource</code>：

<syntaxhighlight lang="java">
public class CustomPropertySource extends PropertySource<String> {
    private Map<String, String> properties = new HashMap<>();

    public CustomPropertySource() {
        super("customPropertySource");
        properties.put("custom.key", "value123");
    }

    @Override
    public Object getProperty(String name) {
        return properties.get(name);
    }
}
</syntaxhighlight>

注册自定义属性源：
<syntaxhighlight lang="java">
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        ConfigurableApplicationContext context = SpringApplication.run(Application.class, args);
        
        ConfigurableEnvironment env = context.getEnvironment();
        env.getPropertySources().addFirst(new CustomPropertySource());
        
        System.out.println("Custom property: " + env.getProperty("custom.key"));
    }
}
</syntaxhighlight>

'''输出结果'''：
<pre>
Custom property: value123
</pre>

== 高级特性 ==

=== 属性覆盖规则 ===
当多个属性源包含相同键时，Spring会按照以下规则处理：
<math>
\text{最终值} = \begin{cases}
\text{优先级高的属性源值} & \text{如果存在} \\
\text{否则继续查找低优先级源}
\end{cases}
</math>

=== 动态属性更新 ===
通过<code>@RefreshScope</code>（Spring Cloud Config）可实现动态属性更新：
<syntaxhighlight lang="java">
@RefreshScope
@RestController
public class ConfigController {
    @Value("${dynamic.property}")
    private String dynamicProp;
}
</syntaxhighlight>

== 实际应用场景 ==

=== 多环境配置 ===
典型的多环境配置方案：
1. <code>application-dev.properties</code>（开发环境）
2. <code>application-prod.properties</code>（生产环境）

通过激活不同的Spring Profile加载对应配置：
<syntaxhighlight lang="bash">
java -jar app.jar --spring.profiles.active=prod
</syntaxhighlight>

=== 敏感信息管理 ===
将密码等敏感信息存储在环境变量中而非配置文件中：
<syntaxhighlight lang="properties">
db.password=${DB_PASSWORD}
</syntaxhighlight>

== 最佳实践 ==
* 优先使用<code>application-{profile}.properties</code>而非条件注解
* 敏感数据应通过环境变量或密钥管理服务注入
* 避免在属性源中使用硬编码路径（如<code>c:\path\to\file</code>）

== 参见 ==
* [[Spring Environment抽象]]
* [[Spring Boot外部化配置]]
* [[Spring Profiles机制]]

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring高级特性]]