Java基础学习总结（66）——配置管理库typesafe.config教程

Typesafe的Config库，纯Java写成、零外部依赖、代码精简、功能灵活、API友好。支持Java properties、JSON、JSON超集格式HOCON以及环境变量。它也是Akka的配置管理库.

Overview

• 纯java实现，无任何依赖
• 充分的测试
• 支持: Java properties, JSON, and a human-friendly JSON superset
• 可以合并各种格式的配置文件
• 可以通过文件、urls、classpath加载配置
• 支持多层嵌套的配置方式
• 识别Java system properties, 如java -Dmyapp.foo.bar=10
• 可以转换长短，大小等单位。如配置文件中timeout=10s,则可以转换成任意的毫秒或者
• 类型转换，比如yes可以转换为boolean类型的true
• JSON superset features:
  • comments
  • includes
  • substitutions ("foo" : ${bar}, "foo" : Hello ${who})
  • properties-like notation (a.b=c)
  • less noisy, more lenient syntax
  • substitute environment variables (logdir=${HOME}/logs)

目前config只支持配置文件，如果想从数据库获取配置文件，需要自己diy。 config库很擅长合并配置。

Example

默认加载classpath下的application.conf,application.json和application.properties文件。通过ConfigFactory.load()加载。

# these are our own config values defined by the appsimple-app {    answer=42}# Here we override some values used by a librarysimple-lib.foo="This value comes from simple-app's application.conf"simple-lib.whatever = "This value comes from simple-app's application.conf"

public class SimpleLibContext {    private Config config;    //指定配置文件    public SimpleLibContext(Config config) {        this.config = config;        config.checkValid(ConfigFactory.defaultReference(), "simple-lib");    }    // 默认加载classpath下的application.*    public SimpleLibContext() {        this(ConfigFactory.load());    }    //打印    public void printSetting(String path) {        System.out.println("The setting '" + path + "' is: " + config.getString(path));    }    public static void main(String[] args) {        SimpleLibContext s = new SimpleLibContext();        s.printSetting("simple-app.answer");    }}

ConfigFactory.load()会加载配置文件，默认加载classpath下的application.conf,application.json和application.properties文件。当然也可以调用ConfigFactory.load(confFileName)加载指定的配置文件。

配置内容即可以是层级关系，也可以用”.”号分隔写成一行:

[java] view plain copy

 

1. host{  
2.   ip = 127.0.0.1  
3.   port = 2282  
4. }  

或则

[java] view plain copy

 

1. host.ip = 127.0.0.1  
2. host.port = 2282  

即json格式和properties格式。（貌似*.json只能是json格式，*.properties只能是properties格式，而*.conf可以是两者混合,而且配置文件只能是以上三种后缀名）

如果多个config 文件有冲突时，解决方案有:
1. a.withFallback(b) //a和b合并，如果有相同的key，以a为准 
2. a.withOnlyPath(String path) //只取a里的path下的配置
3. a.withoutPath(String path) //只取a里出path外的配置
例如：

[java] view plain copy

 

1. Config firstConfig = ConfigFactory.load("test1.conf");  
2. Config secondConfig = ConfigFactory.load("test2.conf");  
3.   
4. //a.withFallback(b)  a和b合并，如果有相同的key，以a为准  
5. Config finalConfig = firstConfig.withOnlyPath("host").withFallback(secondConfig);  

finalConfig中的配置是test1.conf中的host节点的所有配置与test2.conf所有节点的配置合集。

Reference

http://stackoverflow.com/questions/18668883/using-typesafes-config-to-manage-my-database-connection
https://github.com/typesafehub/config/tree/master/examples
https://github.com/typesafehub/config