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)加载指定的配置文件。

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

 host{
   ip = 127.0.0.1
   port = 2282
 }

或则

 host.ip = 127.0.0.1
 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外的配置
例如：

 Config firstConfig = ConfigFactory.load("test1.conf");
 Config secondConfig = ConfigFactory.load("test2.conf");

 //a.withFallback(b)  a和b合并，如果有相同的key，以a为准
 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