概述
Spring PropertiesLoaderSupport是一个抽象基类，它抽象了从不同渠道加载属性的通用逻辑，以及这些属性应用优先级上的一些考虑。它所提供的这些功能主要供实现子类使用。Spring框架中，PropertiesLoaderSupport的实现子类有PropertiesFactoryBean,PropertyResourceConfigurer等。
首先，它将属性分成两类：本地属性(也叫缺省属性)和外来属性。这里本地属性指的是直接以Properties对象形式设置进来的属性。外来属性指的是通过外部资源形式设置进来需要加载的那些属性。
然后，对于本地属性和外来属性之间的的使用优先级，PropertiesLoaderSupport通过属性localOverride来标识。如果localOverride为false,表示外部属性优先级高，这也是缺省设置。如果localOverride为true,表示本地属性优先级高。
另外，PropertiesLoaderSupport还有一个属性fileEncoding用来表示从属性文件加载属性时使用的字符集。
PropertiesLoaderSupport 所在包 : org.springframework.core.io.support 。
源代码解析
属性定义
// 本地属性，通过设置Properties对象直接设置进来的属性
@Nullable
protected Properties[] localProperties; // 本地属性和外来属性之间的优先级，或者叫做覆盖关系
// false 表示 外来属性优先级高于本地属性 (缺省值)
// true 表示 本地属性优先级高于外来属性
protected boolean localOverride = false; // 外来属性对应资源，通过设置外部资源位置设置进来需要加载的属性
@Nullable
private Resource[] locations; // 读取外来属性时遇到不存在的资源路径应该怎么办 ?
// false : 输出一个日志，然后继续执行其他逻辑 (缺省值)
// true : 抛出异常
private boolean ignoreResourceNotFound = false; // 加载外来属性资源文件时使用的字符集
@Nullable
private String fileEncoding; // 外来属性加载工具
private PropertiesPersister propertiesPersister = new DefaultPropertiesPersister();
对于上述属性，PropertiesLoaderSupport都提供了相应的set方法。
主要功能方法
mergeProperties
合并本地属性和外来属性然后返回一个Properties对象，这里面考虑了属性 localOverride 的应用。
/**
* Return a merged Properties instance containing both the
* loaded properties and properties set on this FactoryBean.
*
*/
protected Properties mergeProperties() throws IOException {
Properties result = new Properties(); if (this.localOverride) {
// Load properties from file upfront, to let local properties override.
// localOverride == true, 先加载外来属性到结果对象
loadProperties(result);
} if (this.localProperties != null) {
// 将本地属性合并到结果对象
for (Properties localProp : this.localProperties) {
CollectionUtils.mergePropertiesIntoMap(localProp, result);
}
} if (!this.localOverride) {
// Load properties from file afterwards, to let those properties override.
// localOverride == false, 后加载外来属性到结果对象
loadProperties(result);
} return result;
}
loadProperties
外部属性的加载方法。
/**
* Load properties into the given instance.
* @param props the Properties instance to load into
* @throws IOException in case of I/O errors
* @see #setLocations
*/
protected void loadProperties(Properties props) throws IOException {
if (this.locations != null) {
// 读取每一个属性文件资源
for (Resource location : this.locations) {
if (logger.isTraceEnabled()) {
logger.trace("Loading properties file from " + location);
}
try {
// 使用指定的字符集fileEncoding从外部资源路径location读取属性到props,使用的属性读取工具
// 是 propertiesPersister
PropertiesLoaderUtils.fillProperties(
props, new EncodedResource(location, this.fileEncoding), this.propertiesPersister);
}
catch (FileNotFoundException | UnknownHostException ex) {
// 出现异常时，如果ignoreResourceNotFound==true,则仅仅记录日志，继续读取下一个
// 资源文件，否则直接抛出该异常
if (this.ignoreResourceNotFound) {
if (logger.isDebugEnabled()) {
logger.debug("Properties resource not found: " + ex.getMessage());
}
}
else {
throw ex;
}
}
}
}
}
总结
从上面分析可以看出，PropertiesLoaderSupport所实现的功能并不多，主要是设置要使用的本地属性和外部属性文件资源路径，最终通过mergeProperties方法将这些属性合并成一个Properties对象，本地属性和外部属性之间的优先级关系由属性localOverride决定。
————————————————
版权声明：本文为CSDN博主「安迪源文」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/andy_zhang2007/article/details/86749301