配置文件格式 XML 快速上手

1.语法

XML 文档结构是一种树结构，它从“根部”开始，然后扩展到“枝叶”。XML 文档必须有一个唯一的根结点，根结点包含所有其它结点。所有结点均可拥有文本内容和属性（名称/值的对）。XML 结点也叫做 XML 元素。

编写 XML 文档时，还需要注意以下几点：
（1）所有 XML 元素都须有关闭标签；
（2）XML 标签对大小写敏感；
（3）XML 的属性值须加引号；
（4）XML 中的特殊字符可以使用实体引用来表示。在 XML 中，有 5 个预定义的实体引用：

（5）在 XML 中编写注释的语法与 HTML 的语法很相似：

<!-- This is a comment --> 

（6）XML 元素必须遵循以下命名规则：

• 名称可以含字母、数字以及其他的字符
• 名称不能以数字或者标点符号开始
• 名称不能以字符串 xml（或者 XML、Xml）开始
• 名称不能包含空格
• 名称不能使用保留的字词

2.实例

下面以 XML 表示一个简单的后台服务配置：

<?xml version="1.0" encoding="UTF-8"?>
<server name="UserProfileServer">
	<maxconns>1000</maxconns>
	<queuecap>10000</queuecap>
	<queuetimeout>300</queuetimeout>
	<loginfo>
		<loglevel>ERROR</loglevel>
		<logsize>10M</logsize>
		<lognum>10</lognum>
		<logpath>/usr/local/app/log</logpath>
	</loginfo>
</server>

第一行是 XML 声明，它定义 XML 的版本（1.0）和所使用的编码（UTF-8）。紧接着 server 为根结点，name 为根结点的一个属性，表示服务名称，其他子结点的文本内容表示服务的具体配置项。

3.解析

使用 XML 存储服务配置信息，我们如何解析呢？下面以 Go 为例，来解析上面的 XML 格式的服务配置。

第一步，将上面的 XML 配置信息粘贴到 XML to Go struct 快速获取 Go struct 的定义。

type Server struct {
	Name         string   `xml:"name,attr"`		//标签属性
	Maxconns     string   `xml:"maxconns"`
	Queuecap     string   `xml:"queuecap"`
	Queuetimeout string   `xml:"queuetimeout"`
	Loginfo      struct {
		Loglevel string `xml:"loglevel"`
		Logsize  string `xml:"logsize"`
		Lognum   string `xml:"lognum"`
		Logpath  string `xml:"logpath"`
	} `xml:"loginfo"`
} 

第二步，借助 Go 自带的 encoding/xml 包完成 XML 文档解析。

package main

import(
        "encoding/xml"
        "io/ioutil"
        "fmt"
        "os"    
)

func main() {
  file, err := os.Open("server.xml")
  if err != nil {
    fmt.Printf("error:%v\n", err)
    return
  }
  defer file.Close()

  data, err := ioutil.ReadAll(file)
  if err != nil {
    fmt.Printf("error: %v", err)
    return
  }
  v := Server{}
  err = xml.Unmarshal(data, &v) 
  if err != nil {
    fmt.Printf("error:%v\n", err)
    return
  }
  fmt.Printf("%+v\n", v)
}

运行输出：

{Name:UserProfileServer Maxconns:1000 Queuecap:10000 Queuetimeout:300 Loginfo:{Loglevel:ERROR Logsize:10M Lognum:10 Logpath:/usr/local/app/log}}

参考文献

XML 简介 - XML：可扩展标记语言 | MDN
Go Package xml
XML to Go struct Online Tool