这里以XML为例,例子取自书籍(go web 编程)
type Recurlyservers struct {
XMLName xml.Name `xml:"servers"`
Version string `xml:"version,attr"`
Svs []server `xml:"server"`
Description string `xml:",innerxml"`
}
type server struct {
XMLName xml.Name `xml:"server"`
ServerName string `xml:"serverName"`
ServerIP string `xml:"serverIP"`
}
- 如果struct中有一个叫做XMLName,且类型为xml.Name字段,那么在解析的时候就会保存这个element的名字到该字段,如上面例子中的servers。
- 如果某个struct字段的tag定义中含有XML结构中element的名称,那么解析的时候就会把相应的element值赋值给该字段,如上servername和serverip定义。
- 如果某个struct字段的tag定义了中含有
",attr"
,那么解析的时候就会将该结构所对应的element的与字段同名的属性的值赋值给该字段,如上version定义。 - 如果某个struct字段的tag定义 型如
"a>b>c"
,则解析的时候,会将xml结构a下面的b下面的c元素的值赋值给该字段。 - 如果某个struct字段的tag定义了
"-"
,那么不会为该字段解析匹配任何xml数据。 - 如果struct字段后面的tag定义了
",any"
,如果他的子元素在不满足其他的规则的时候就会匹配到这个字段。 - 如果某个XML元素包含一条或者多条注释,那么这些注释将被累加到第一个tag含有”,comments”的字段上,这个字段的类型可能是[]byte或string,如果没有这样的字段存在,那么注释将会被抛弃。
注意: 为了正确解析,go语言的xml包要求struct定义中的所有字段必须是可导出的(即首字母大写)
type Servers struct { XMLName xml.Name `xml:"servers"` Version string `xml:"version,attr"` Svs []server `xml:"server"` } type server struct { ServerName string `xml:"serverName"` ServerIP string `xml:"serverIP"` }
我们应如何设置struct 中字段的tag信息以控制最终xml文件的生成呢?
- XMLName不会被输出
- tag中含有
"-"
的字段不会输出 - tag中含有
"name,attr"
,会以name作为属性名,字段值作为值输出为这个XML元素的属性,如上version字段所描述 - tag中含有
",attr"
,会以这个struct的字段名作为属性名输出为XML元素的属性,类似上一条,只是这个name默认是字段名了。 - tag中含有
",chardata"
,输出为xml的 character data而非element。 - tag中含有
",innerxml"
,将会被原样输出,而不会进行常规的编码过程 - tag中含有
",comment"
,将被当作xml注释来输出,而不会进行常规的编码过程,字段值中不能含有”—“字符串 - tag中含有
"omitempty"
,如果该字段的值为空值那么该字段就不会被输出到XML,空值包括:false、0、nil指针或nil接口,任何长度为0的array, slice, map或者string