深入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的内容。
原文链接:http://www.jianshu.com/p/5206f74a4406
著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”。