深入SpringBoot:自定义PropertySourceLoader

http://www.jianshu.com/p/5206f74a4406

*********************************

前言

上一篇文章介绍了SpringBoot的EnableAutoConfiguration，并通过自定义注解来实现相同的功能。
这里再介绍一下SpringBoot的配置文件的加载机制，SpringBoot会默认加载ClassPath下的application.properties的文件，下面会介绍实现的原理，并通过自定义PropertySourceLoader来自定义配置加载。

PropertySourceLoader

SpringBoot加载配置文件的入口是ConfigFileApplicationListener，这个类实现了ApplicationListener和EnvironmentPostProcessor两个接口。
SpringApplication在初始化的时候会加载spring.factories配置的ApplicationListener接口的实现类。

private void initialize(Object[] sources) {
if (sources != null && sources.length > 0) {
this.sources.addAll(Arrays.asList(sources));
}
this.webEnvironment = deduceWebEnvironment();
setInitializers((Collection) getSpringFactoriesInstances(ApplicationContextInitializer.class));
setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));
this.mainApplicationClass = deduceMainApplicationClass();
}

ConfigFileApplicationListener包含了PropertySourcesLoader，这个类会从spring.factories加载PropertySourceLoader的实现类。

public PropertySourcesLoader(MutablePropertySources propertySources) {
Assert.notNull(propertySources, "PropertySources must not be null");
this.propertySources = propertySources;
this.loaders = SpringFactoriesLoader.loadFactories(PropertySourceLoader.class,getClass().getClassLoader());
}

PropertySourceLoader就是加载配置接口类。

public interface PropertySourceLoader {
String[] getFileExtensions();
PropertySource<?> load(String name, Resource resource, String profile)
throws IOException;
}

getFileExtensions()是返回支持的文件扩展名，比如PropertiesPropertySourceLoader支持的扩展是xml和properties。
ConfigFileApplicationListener定义了默认的文件名DEFAULT_NAMES="application"，所以SpringBoot会根据文件名加扩展名来加载文件。
load方法会读取配置文件，并返回PropertySource，SpringBoot会从PropertySource读取配置项，合并到总的配置对象中。

自定义PropertySourceLoader

所以自定义PropertySourceLoader就需要实现接口类，并配置到spring.factories中。
SpringBoot没有加载json的配置文件，这里就自定义JsonPropertySourceLoader来实现json格式配置文件的加载。完整的代码放在Github

定义JsonPropertySourceLoader，这里返回json的扩展名，通过SpringBoot内置的JsonParse，解析文件。
解析成map格式，然后根据json的层级结构，递归进去，拼接成完整的key。

public class JsonPropertySourceLoader implements PropertySourceLoader {
public String[] getFileExtensions() {
return new String[]{"json"};
}
public PropertySource<?> load(String name, Resource resource, String profile) throws IOException {
Map<String, Object> result = mapPropertySource(resource);
return new MapPropertySource(name, result);
}
private Map<String, Object> mapPropertySource(Resource resource) throws IOException {
if (resource == null) {
return null;
}
Map<String, Object> result = new HashMap<String, Object>();
JsonParser parser = JsonParserFactory.getJsonParser();
Map<String, Object> map = parser.parseMap(readFile(resource));
nestMap("", result, map);
return result;
}
private String readFile(Resource resource) throws IOException {
InputStream inputStream = resource.getInputStream();
List<Byte> byteList = new LinkedList<Byte>();
byte[] readByte = new byte[1024];
int length;
while ((length = inputStream.read(readByte)) > 0) {
for (int i = 0; i < length; i++) {
byteList.add(readByte[i]);
}
}
byte[] allBytes = new byte[byteList.size()];
int index = 0;
for (Byte soloByte : byteList) {
allBytes[index] = soloByte;
index += 1;
}
return new String(allBytes);
}
private void nestMap(String prefix, Map<String, Object> result, Map<String, Object> map) {
if (prefix.length() > 0) {
prefix += ".";
}
for (Map.Entry entrySet : map.entrySet()) {
if (entrySet.getValue() instanceof Map) {
nestMap(prefix + entrySet.getKey(), result, (Map<String, Object>) entrySet.getValue());
} else {
result.put(prefix + entrySet.getKey().toString(), entrySet.getValue());
}
}
}
}

配置文件，这里配置了customize.property.message和日志级别logging.level.root。

{
"customize": {
"property": {
"message": "hello world"
}
},
"logging": {
"level": {
"root": "ERROR"
}
}
}

配置PropertySourceLoader，在工程下新建/META-INF/spring.factories文件，并配置JsonPropertySourceLoader。

org.springframework.boot.env.PropertySourceLoader=org.wcong.test.springboot.JsonPropertySourceLoader

main入口，取出customize.property.message并打印出来。

@Configuration
@EnableAutoConfiguration
public class CustomizePropertySourceLoader {
@Value("${customize.property.message}")
private String message;
public static void main(String[] args) {
SpringApplication springApplication = new SpringApplication(CustomizePropertySourceLoader.class);
springApplication.setWebEnvironment(false);
ConfigurableApplicationContext configurableApplicationContext = springApplication.run(args);
CustomizePropertySourceLoader customizePropertySourceLoader = configurableApplicationContext.getBean(CustomizePropertySourceLoader.class);
System.out.println(customizePropertySourceLoader.message);
}
}

结语

SpringBoot通过spring.factories实现了很好的扩展功能。自定义模块相关一般是通过实现对应的接口，并配置到文件中。后面会介绍更多关于SpringBoot的内容。

文／wcong（简书作者）
原文链接：http://www.jianshu.com/p/5206f74a4406
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。