2.2 配置

2.2.1 配置介绍

配置完整性定义是:环境变量、编译注入配置、命令行配置、文本配置、远端配置,这五类数据共同构成了一份完整配置,形成一份完整配置。Jupiter会对五种类型配置进行整合,最终得到应用使用的配置。

2.2.2 文本配置

读取单行配置信息

参考读取单行配置示例2.2 配置 - 图1 (opens new window)

  1. [people]
  2. name = "jupiter"
  1. peopleName := conf.GetString("people.name")
  2. xlog.Info("people info", xlog.String("name", peopleName), xlog.String("type", "onelineByFile"))

我们只需要简单两行,就可以读取到配置里的数据,运行go run main.go --config=config.toml,可以看到运行结果。

读取结构体配置信息

参考读取结构体配置示例2.2 配置 - 图2 (opens new window)

  1. [people]
  2. name = "jupiter"
  1. type People struct {
  2. Name string
  3. }
  4. p := People{}
  5. err := conf.UnmarshalKey("people", &p)
  6. if err != nil {
  7. panic(err.Error())
  8. }
  9. xlog.Info("people info", xlog.String("name", p.Name), xlog.String("type", "structByFile"))

读取结构体配置,使用conf.UnmarshalKey方法,第一个参数传入配置里需要解析的Key,第二个参数传入需要解析的结构体对象,运行go run main.go --config=config.toml,可以看到运行结果。

监听文件读取单行配置信息

参考监听文件读取单行配置示例2.2 配置 - 图3 (opens new window)

监听文件读取单行配置信息

  1. [people]
  2. name = "jupiter"
  1. for {
  2. time.Sleep(10 * time.Second)
  3. peopleName := conf.GetString("people.name")
  4. xlog.Info("people info", xlog.String("name", peopleName), xlog.String("type", "onelineByFileWatch"))
  5. }

使用监听文件功能,需要使用指令--watch=true进行开启。获取单行配置的方法,不需要做任何改动,就能够直接使用动态配置功能。,运行go run main.go --config=config.toml --watch=true,可以看到运行结果。

监听文件读取结构体配置信息

参考监听文件读取结构体配置示例2.2 配置 - 图4 (opens new window)

  1. [people]
  2. name = "jupiter"
  1. type People struct {
  2. Name string
  3. }
  4. p := People{}
  5. // 设置监听的结构体
  6. conf.OnChange(func(config *conf.Configuration) {
  7. err := config.UnmarshalKey("people", &p)
  8. if err != nil {
  9. panic(err.Error())
  10. }
  11. })
  12. for {
  13. time.Sleep(10 * time.Second)
  14. xlog.Info("people info", xlog.String("name", p.Name), xlog.String("type", "structByFileWatch"))
  15. }

使用监听文件功能,需要使用指令--watch=true进行开启。获取结构体配置的方法,需要在前面增加一个conf.OnChange方法,监听配置变动后,改变结构体(这个地方没上锁,生产环境请上锁)。运行go run main.go --config=config.toml --watch=true,可以看到运行结果。

2.2.3 远端配置

远端配置和文本配置使用方式一致,只需要改变下命令行参数,将原有的--config=config.toml换成远端配置地址--config=http://remoteConfigAddr 具体用法参考以下example