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 app
simple-app {
    answer=42
}

# Here we override some values used by a library
simple-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. //a.withFallback(b)  a和b合并，如果有相同的key，以a为准
4. 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