commons-configuration2提供的變量佔位符(Variable Interpolation)功能

通常我們用apach的configuration2庫來管理配置文件(org.apache.commons:commons-configuration2),在commons-configuration2管理的配置文件中，配置變量的值可以引用變量。
比如以下的配置文件中使用的${env:FACELOG_HOME}就指代環境變量FACELOG_HOME,${sys:user.home}指代java的user.home屬性：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
	<override>
		<!-- 從系統 home 位置讀取 -->
		<properties
			fileName="${sys:user.home}/${const:net.gdface.facelog.GlobalConfig.HOME_FOLDER}/${const:net.gdface.facelog.GlobalConfig.USER_PROPERTIES}"
			config-name="userConfig"
			config-forceCreate="true"
			config-optional="true" />
		<!-- 如果定義了 FACELOG_HOME 環境變量,從變量指定的位置讀取配置 -->
		<properties
			fileName="${env:FACELOG_HOME}/${const:net.gdface.facelog.GlobalConfig.USER_PROPERTIES}"
			config-name="envConfig"
			config-optional="true" />
		<xml fileName="defaultConfig.xml" config-name="default config" />
	</override>
</configuration>

在commons-configuration2中上面這種引用動態變量的方式叫變量插值(Variable Interpolation).

毫無疑問，使用變量插值可以系統配置參數提供非常的靈活性和便利性。那麼這種變量插值的解析能力是不是可以單獨拿出來使用呢？
今天經過研究commons-configuration2的源碼，基本搞清楚了原理，找到了提供變量插值能力的類org.apache.commons.configuration2.interpol.ConfigurationInterpolator。通過這個類的interpolate(Object)方法就負責對字符串中的變量進行解析，示例代碼如下：

package net.gdface.facedb;

import org.apache.commons.configuration2.interpol.ConfigurationInterpolator;
import org.apache.commons.configuration2.interpol.InterpolatorSpecification;
import org.junit.BeforeClass;
import org.junit.Test;

public class Configuration2Test {

	@BeforeClass
	public static void setUpBeforeClass() throws Exception {
	}

	@Test
	public void test() {
		
		InterpolatorSpecification spec =
				new InterpolatorSpecification.Builder()
				.withPrefixLookups(ConfigurationInterpolator.getDefaultPrefixLookups())
				.withDefaultLookups(ConfigurationInterpolator.getDefaultPrefixLookups().values())
				.create();
		// 創建ConfigurationInterpolator實例
		ConfigurationInterpolator interpolator = ConfigurationInterpolator.fromSpecification(spec);
		// 解析包含佔位符的字符串
		System.out.printf("${sys:user.home}=%s\n",interpolator.interpolate("${sys:user.home}/WWW"));
		System.out.printf("${env.REDIS_HOME}=%s\n",interpolator.interpolate("${env:REDIS_HOME}"));
		System.out.printf("${env.HOMEPATH}=%s\n",interpolator.interpolate("${env:HOMEPATH}"));
	}

}

測試輸出:

${sys:user.home}=C:\Users\guyadong/WWW
${env.REDIS_HOME}=J:\Redis-x64-2.8.2402
${env.HOMEPATH}=\Users\guyadong

不要忘記引入依賴庫(maven)

			<!-- https://mvnrepository.com/artifact/org.apache.commons/commons-configuration2 -->
			<dependency>
				<groupId>org.apache.commons</groupId>
				<artifactId>commons-configuration2</artifactId>
				<version>2.1.1</version>
			</dependency>

參考資料

http://commons.apache.org/proper/commons-configuration/userguide/howto_basicfeatures.html#Variable_Interpolation