类 PropertySourcesPlaceholderConfigurer
- java.lang.Object
- org.springframework.core.io.support.PropertiesLoaderSupport
- org.springframework.beans.factory.config.PropertyResourceConfigurer
- org.springframework.beans.factory.config.PlaceholderConfigurerSupport
- org.springframework.context.support.PropertySourcesPlaceholderConfigurer
- 所有已实现的接口:
Aware,BeanFactoryAware,BeanNameAware,BeanFactoryPostProcessor,EnvironmentAware,Ordered,PriorityOrdered
public class PropertySourcesPlaceholderConfigurer extends PlaceholderConfigurerSupport implements EnvironmentAware
Specialization ofPlaceholderConfigurerSupportthat resolves ${...} placeholders within bean definition property values and@Valueannotations against the current SpringEnvironmentand its set ofPropertySources.This class is designed as a general replacement for
PropertyPlaceholderConfigurer. It is used by default to support theproperty-placeholderelement in working against the spring-context-3.1 or higher XSD; whereas, spring-context versions <= 3.0 default toPropertyPlaceholderConfigurerto ensure backward compatibility. See the spring-context XSD documentation for complete details.Any local properties (e.g. those added via
PropertiesLoaderSupport.setProperties(java.util.Properties),PropertiesLoaderSupport.setLocations(org.springframework.core.io.Resource...)et al.) are added as aPropertySource. Search precedence of local properties is based on the value of thelocalOverrideproperty, which is by defaultfalsemeaning that local properties are to be searched last, after all environment property sources.See
ConfigurableEnvironmentand related javadocs for details on manipulating environment property sources.- 从以下版本开始:
- 3.1
- 作者:
- Chris Beams, Juergen Hoeller
- 另请参阅:
ConfigurableEnvironment,PlaceholderConfigurerSupport,PropertyPlaceholderConfigurer
字段概要
字段 修饰符和类型 字段 说明 static StringENVIRONMENT_PROPERTIES_PROPERTY_SOURCE_NAME"environmentProperties" is the name given to thePropertySourcethat wraps the environment supplied to this configurer.static StringLOCAL_PROPERTIES_PROPERTY_SOURCE_NAME"localProperties" is the name given to thePropertySourcefor the set of merged properties supplied to this configurer.从类继承的字段 org.springframework.beans.factory.config.PlaceholderConfigurerSupport
DEFAULT_PLACEHOLDER_PREFIX, DEFAULT_PLACEHOLDER_SUFFIX, DEFAULT_VALUE_SEPARATOR, ignoreUnresolvablePlaceholders, nullValue, placeholderPrefix, placeholderSuffix, trimValues, valueSeparator
从类继承的字段 org.springframework.core.io.support.PropertiesLoaderSupport
localOverride, localProperties, logger
从接口继承的字段 org.springframework.core.Ordered
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE
构造器概要
构造器 构造器 说明 PropertySourcesPlaceholderConfigurer()
方法概要
所有方法 实例方法 具体方法 已过时的方法 修饰符和类型 方法 说明 PropertySourcesgetAppliedPropertySources()Return the property sources that were actually applied duringpost-processing.voidpostProcessBeanFactory(ConfigurableListableBeanFactory beanFactory)Processing occurs by replacing ${...} placeholders in bean definitions by resolving each against this configurer's set ofPropertySources, which includes: all environment property sources, if anEnvironmentis presentmerged local properties, if anyhavebeenspecified any property sources set by callingsetPropertySources(org.springframework.core.env.PropertySources)protected voidprocessProperties(ConfigurableListableBeanFactory beanFactory, Properties props)protected voidprocessProperties(ConfigurableListableBeanFactory beanFactoryToProcess, ConfigurablePropertyResolver propertyResolver)Visit each bean definition in the given bean factory and attempt to replace ${...} property placeholders with values from the given properties.voidsetEnvironment(Environment environment)PropertySourcesfrom the givenEnvironmentwill be searched when replacing ${...} placeholders.voidsetPropertySources(PropertySources propertySources)Customize the set ofPropertySourcesto be used by this configurer.从类继承的方法 org.springframework.beans.factory.config.PlaceholderConfigurerSupport
doProcessProperties, setBeanFactory, setBeanName, setIgnoreUnresolvablePlaceholders, setNullValue, setPlaceholderPrefix, setPlaceholderSuffix, setTrimValues, setValueSeparator
从类继承的方法 org.springframework.beans.factory.config.PropertyResourceConfigurer
convertProperties, convertProperty, convertPropertyValue, getOrder, setOrder
从类继承的方法 org.springframework.core.io.support.PropertiesLoaderSupport
loadProperties, mergeProperties, setFileEncoding, setIgnoreResourceNotFound, setLocalOverride, setLocation, setLocations, setProperties, setPropertiesArray, setPropertiesPersister
字段详细资料
LOCAL_PROPERTIES_PROPERTY_SOURCE_NAME
public static final String LOCAL_PROPERTIES_PROPERTY_SOURCE_NAME
"localProperties" is the name given to thePropertySourcefor the set of merged properties supplied to this configurer.- 另请参阅:
- 常量字段值
ENVIRONMENT_PROPERTIES_PROPERTY_SOURCE_NAME
public static final String ENVIRONMENT_PROPERTIES_PROPERTY_SOURCE_NAME
"environmentProperties" is the name given to thePropertySourcethat wraps the environment supplied to this configurer.- 另请参阅:
- 常量字段值
构造器详细资料
PropertySourcesPlaceholderConfigurer
public PropertySourcesPlaceholderConfigurer()
方法详细资料
setPropertySources
public void setPropertySources(PropertySources propertySources)
Customize the set ofPropertySourcesto be used by this configurer.Setting this property indicates that environment property sources and local properties should be ignored.
setEnvironment
public void setEnvironment(Environment environment)
PropertySourcesfrom the givenEnvironmentwill be searched when replacing ${...} placeholders.
postProcessBeanFactory
public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException
Processing occurs by replacing ${...} placeholders in bean definitions by resolving each against this configurer's set ofPropertySources, which includes:- all environment property sources, if an
Environmentis present - merged local properties, if anyhavebeenspecified
- any property sources set by calling
setPropertySources(org.springframework.core.env.PropertySources)
If
setPropertySources(org.springframework.core.env.PropertySources)is called, environment and local properties will be ignored. This method is designed to give the user fine-grained control over property sources, and once set, the configurer makes no assumptions about adding additional sources.- 指定者:
postProcessBeanFactory在接口中BeanFactoryPostProcessor- 覆盖:
postProcessBeanFactory在类中PropertyResourceConfigurer- 参数:
beanFactory- the bean factory used by the application context- 抛出:
BeansException- in case of errors
- all environment property sources, if an
processProperties
protected void processProperties(ConfigurableListableBeanFactory beanFactoryToProcess, ConfigurablePropertyResolver propertyResolver) throws BeansException
Visit each bean definition in the given bean factory and attempt to replace ${...} property placeholders with values from the given properties.
processProperties
@Deprecated protected void processProperties(ConfigurableListableBeanFactory beanFactory, Properties props)
Implemented for compatibility withPlaceholderConfigurerSupport.- 指定者:
processProperties在类中PropertyResourceConfigurer- 参数:
beanFactory- the BeanFactory used by the application contextprops- the Properties to apply- 抛出:
UnsupportedOperationException- in this implementation
getAppliedPropertySources
public PropertySources getAppliedPropertySources() throws IllegalStateException
Return the property sources that were actually applied duringpost-processing.- 返回:
- the property sources that were applied
- 抛出:
IllegalStateException- if the property sources have not yet been applied- 从以下版本开始:
- 4.0