toml放弃了括号或缩进的底层原理，采用了显示键名链的方式。
为了方便，可以指定小节名(小节名也是可以链式声明的)

在互联网上传输 TOML 文件时，恰当的 MIME 类型是 application/toml

注释

使用#来表示注释开始，至当前行尾结束

  1. # I am a comment. Hear me roar. Roar .

字符串

TOML中有4中字符串表示方法：基本、多行-基本、字面量、多行-字面量

基本字符串

由双引号包裹，所有Unicode字符均可出现，除了双引号、反斜线、控制字符(U+0000 to U+001F)需要转义

  1. str = "I'm a string. \"You can quote me \"."

多行-基本字符串

由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留

  1. str1 = """
  2. Roses ard red
  3. Violets are blue"""

字面量字符串

由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容

  1. winpath = 'C:\Users\nodejs\templates'

多行-字面量字符串

与多行-字面量字符串

  1. str1 = '''
  2. Roses ard red
  3. Violets are blue'''

数值与bool值

  1. int1 = +99
  2. flt3 = -0.01
  3. bool1 = true

日期时间

  1. date1 = 1979-05-27T07:32:00Z

数组

数组使用方括号包裹。空格会被忽略，包括换行符。元素使用括号分隔

  1. arr1 = [ 1, 2, 3 ]
  2. arr2 = [ "red", "yellow", "green" ]
  3. arr3 = [ [ 1, 2 ], [3, 4, 5] ]

表格

表格称为哈希表或字典，用来存储键值对。表格名由方括号包裹，且自成一行

  1. [dog]
  2. onekey = onevalue
  4. [dog.tater]
  5. type = "pug"

示例:使用toml配置文件链接数据库

toml配置文件的内容

  1. [dbservers.test]
  2. host = "127.0.0.1"
  3. port = 5432
  4. dbname = "test"
  5. user = "loginuser"
  6. password = "123456"
  8. [dbservers.dborm]
  9. host = "127.0.0.1"
  10. port = 5432
  11. dbname = "test"
  12. user = "loginuser"
  13. password = "123456"
  15. [dbservers.dbsqlx]
  16. host = "127.0.0.1"
  17. port = 5432
  18. dbname = "test"
  19. user = "loginuser"
  20. password = "123456"
  22. [redisservers.redis]
  23. addr = "127.0.0.1:6379"
  24. password = ""
  25. db = 10

举个例子 dbservers.test。对于dbservers这个是下面配置信息中代表Config结构体中的DBServers部分。而.后面代表的则是map中的key。

config数据库的配置信息

首先toml对应的是一个Config的结构体、以下是结构体的代码

  1. type Config struct {
  2.    DBServers    map[string]DBServer    `toml:"dbservers"`
  3.    RedisServers map[string]RedisServer `toml:"redisservers"`
  4. }
  7. // DBServer 表示DB服务器配置
  8. type DBServer struct {
  9.     Host     string `toml:"host"`
  10.     Port     int    `toml:"port"`
  11.     DBName   string `toml:"dbname"`
  12.     User     string `toml:"user"`
  13.     Password string `toml:"password"`
  14. }
  16. // RedisServer 表示 redis 服务器配置
  17. type RedisServer struct {
  18.     Addr     string `toml:"addr"`
  19.     Password string `toml:"password"`
  20.     DB       int    `toml:"db"`
  21. }

配置解析文件

可以利用github.com/bbangert/toml包对toml文件进行解析

  1. // New 解析toml配置
  2. func New(tomlFile string) (*Config, error) {
  3.    c := &Config{}
  4.    if _, err := toml.DecodeFile(tomlFile, c); err != nil {
  5.       return c, err
  6.    }
  7.    return c, nil
  8. }