PropertySource
添加 PropertySource
<context:property-placeholder>
- PropertySourcesPlaceholderConfigurer
- PropertyPlaceholderConfigurer
- @PropertySource
- @PropertySources
Spring Boot 中的 @ConfigurationProperties
- 可以将属性绑定到结构化对象上
- ⽀持 Relaxed Binding
- ⽀持安全的类型转换
- @EnableConfigurationProperties
定制 PropertySource
主要步骤
- 实现 PropertySource
- 从 Environment 取得 PropertySources
- 将⾃⼰的 PropertySource 添加到合适的位置
切⼊位置
- EnvironmentPostProcessor
- BeanFactoryPostProcessor
@PropertySource
注解为向Spring的 Environment中添加PropertySource
提供了一种方便的声明性机制。与@Configuration
类一起使用。
使用demo
给定一个包含键/值对testbean.name=myTestBean
的文件app.properties
,下面的@Configuration
类使用@PropertySource
将app.properties
添加到Environment的propertysources
集合。
@Configuration
@PropertySource("classpath:/com/myco/app.properties")
public class AppConfig {
@Autowired
Environment env;
@Bean
public TestBean testBean() {
TestBean testBean = new TestBean();
testBean.setName(env.getProperty("testbean.name"));
return testBean;
}
}
注意,Environment对象@Autowired到配置类中,然后在填充TestBean对象时使用。根据上面的配置,对testBean.getName()的调用将返回“myTestBean”。
解析和@Value注解中的${…}占位符
为了解析出和@Value注解中的${…}占位符,以使用PropertySource中的配置,必须确保在ApplicationContext
使用的BeanFactory
中注册了适当的嵌入式值解析器(an appropriate embedded value resolver)。当在XML中使用context:property-placeholder时,会自动进行注册。
在使用@Configuration
类时,可以通过静态@Bean
方法显式注册PropertySourcesPlaceholderConfigurer
来实现这一点。但是请注意,通过静态@Bean
方法显式注册PropertySourcesPlaceholderConfigurer
通常只有在需要定制配置(如占位符语法等)时才需要。可参见@Configuration的javadocs的“使用外部化值”部分和@Bean的javadocs的“关于beanfactorypostprocessor -返回@Bean方法的说明”了解详细信息和示例。
解析@PropertySource资源位置中的${…}占位符
任何${…}占位符出现在@PropertySource
资源位置中,将根据已经在环境中注册的property sources
进行解析。例如:
@Configuration
@PropertySource("classpath:/com/${my.placeholder:default/path}/app.properties")
public class AppConfig {
@Autowired
Environment env;
@Bean
public TestBean testBean() {
TestBean testBean = new TestBean();
testBean.setName(env.getProperty("testbean.name"));
return testBean;
}
}
假设“我的。”my.placeholder”出现在已经注册的property sources中——例如,系统属性或环境变量——占位符将被解析为相应的值。如果不是,那么"default/path"将被用作默认值。默认值(由冒号“:”分隔)是可选的。如果没有指定默认值且属性无法解析,则会抛出IllegalArgumentException
异常。
关于使用@PropertySource重写属性的说明
在给定的属性键存在于多个.properties
文件中的情况下,处理的最后一个@PropertySource
注解将“胜出”并覆盖之前的同名键。
例如,给定两个属性文件a.properties
和b.properties
,考虑以下两个使用@PropertySource
注解引用它们的配置类:
@Configuration
@PropertySource("classpath:/com/myco/a.properties")
public class ConfigA { }
@Configuration
@PropertySource("classpath:/com/myco/b.properties")
public class ConfigB { }
覆盖顺序取决于这些类在应用程序上下文中注册的顺序。
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();
ctx.register(ConfigA.class);
ctx.register(ConfigB.class);
ctx.refresh();
在上面的场景中,b.properties
中的属性将覆盖a.properties
中存在的任何副本,因为ConfigB
是最后注册的。
在某些情况下,在使用@PropertySource
注解时,严格控制属性源顺序可能是不可能或不实际的。例如,如果上面的@Configuration类是通过组件扫描注册的,那么排序就很难预测。在这种情况下——如果重写很重要——建议用户回到使用编程的PropertySource API
。详细信息可参见ConfigurableEnvironment
和MutablePropertySources
的javadocs。
注意:根据Java 8约定,该注解是可重复的。但是,所有这样的@PropertySource
注解都需要在同一层声明:要么直接在配置类上声明,要么作为元注解在相同的自定义注解上声明。不建议混合使用直接注解和元注解,因为直接注解将有效地覆盖元注解。