深入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
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。