config 模块

配置文件解析

这是一个用来解析文件的库，它的设计思路来自于 database/sql，目前支持解析的文件格式有 ini、json、xml、yaml，可以通过如下方式进行安装：

go get github.com/beego/beego/v2/core/config

如果你使用xml 或者 yaml 驱动就需要手工安装引入包

go get -u github.com/beego/beego/v2/core/config/xml

而且需要在使用的地方引入包

import _ "github.com/beego/beego/v2/core/config/xml"

远程配置

目前我们提供了对远程配置中心etcd的支持。使用它就如同使用一般的基于文件的配置那样。

如何使用

直接使用包

为了简化代码，我们在config初始化的时候，默认创建了一个名为globalInstance的实例。

该实例在没有显式初始化的情况下，默认是采用ini作为实现，它将会加载文件conf/app.conf。

在加载失败的时候，会输出一个警告信息。

于是我们可以直接使用config包。

val, err := config.String("mykey")

当然，用户也可以主动初始化。例如，当我们想用toml作为默认实现的时候，我们可以：

_ import "github.com/beego/beego/v2/core/config/toml"
err := InitGlobalInstance("toml", "some config")
// ...
val, err := config.String("mykey")
// ...

永远别忘了引入具体实现的包。

手动创建实例

首先初始化一个解析器对象

iniconf, err := NewConfig("ini", "testini.conf")
if err != nil {
	t.Fatal(err)
}

然后通过对象获取数据

iniconf.String("appname")

解析器对象支持的函数有如下：

// Configer defines how to get and set value from configuration raw data.
type Configer interface {
	// support section::key type in given key when using ini type.
	Set(key, val string) error

	// support section::key type in key string when using ini and json type; Int,Int64,Bool,Float,DIY are same.
	String(key string) (string, error)
	// get string slice
	Strings(key string) ([]string, error)
	Int(key string) (int, error)
	Int64(key string) (int64, error)
	Bool(key string) (bool, error)
	Float(key string) (float64, error)
	// support section::key type in key string when using ini and json type; Int,Int64,Bool,Float,DIY are same.
	DefaultString(key string, defaultVal string) string
	// get string slice
	DefaultStrings(key string, defaultVal []string) []string
	DefaultInt(key string, defaultVal int) int
	DefaultInt64(key string, defaultVal int64) int64
	DefaultBool(key string, defaultVal bool) bool
	DefaultFloat(key string, defaultVal float64) float64

	// DIY return the original value
	DIY(key string) (interface{}, error)

	GetSection(section string) (map[string]string, error)

	Unmarshaler(prefix string, obj interface{}, opt ...DecodeOption) error
	Sub(key string) (Configer, error)
	OnChange(key string, fn func(value string))
	SaveConfigFile(filename string) error
}

这里有一些使用的注意事项：

所有的Default*方法，在key不存在，或者查找的过程中，出现error，都会返回默认值；
DIY直接返回对应的值，而没有做任何类型的转换。当你使用这个方法的时候，你应该自己确认值的类型。只有在极少数的情况下你才应该考虑使用这个方法；
GetSection会返回section所对应的部分配置。section如何被解释，取决于具体的实现；
Unmarshaler会尝试用当且配置的值来初始化obj。需要注意的是，prefix的概念类似于section；
Sub类似与GetSection，都是尝试返回配置的一部分。所不同的是，GetSection将结果组织成map，而Sub将结果组织成Config实例；
OnChange主要用于监听配置的变化。对于大部分依赖于文件系统的实现来说，都不支持。具体而言，我们设计这个主要是为了考虑支持远程配置；
SaveConfigFile尝试将配置导出成为一个文件；
某些实现支持分段式的key。比如说a.b.c这种，但是，并不是所有的实现都支持，也不是所有的实现都采用.作为分隔符。这是一个历史遗留问题，为了保留兼容性，我们无法在这方面保持一致。

这里额外提及一下ini文件，因为这是早期v1.x里面默认的配置实现：

ini 配置文件支持 section 操作，key通过 section::key 的方式获取

例如下面这样的配置文件

  [demo]
  key1 = "asta"
  key2 = "xie"

那么可以通过 iniconf.String("demo::key2") 获取值.

如何获取环境变量

config 模块支持环境变量配置，对应配置项 Key 格式为 ${环境变量名} ，则 Value = os.Getenv(‘环境变量名’)。同时可配置默认值，当环境变量无此配置或者环境变量值为空时，则优先使用默认值。包含默认值的 Key 格式为 ${GOPATH||/home/workspace/go/} ，使用||分割环境变量和默认值。

注意获取环境变量值仅仅是在配置文件解析时处理，而不会在调用函数获取配置项时实时处理。