概述

encoding/xml 包含了 XML 相关处理方法。

例子

结构体转为 XML 字符串

调用 xml.Marshal() 方法完成。

package main

import (
    "encoding/xml"
    "fmt"
)

type person struct {
    Name string `xml:"name"`
    Age  int    `xml:"age"`
    addr string `xml:"addr"` // 该属性转 XML 时会被忽略
}

func main() {
    tom := person{ // 使用字面量初始化
        Name: "Tom",
        Age:  6,
        addr: "???",
    }

    tomXml, err := xml.Marshal(tom)
    if err != nil {
        panic(err)
    }
    fmt.Printf("xml.Marshal(tom) = %s\n", tomXml) // 从输出字符串中可以看到，并没有 addr 属性
}

// $ go run main.go
// 输出如下 
/**
  xml.Marshal(tom) = <person><name>Tom</name><age>6</age></person>
*/

XML 字符串转为结构体

调用 xml.Unmarshal() 方法完成。

package main

import (
    "encoding/xml"
    "fmt"
)

type person struct {
    Name string `xml:"name"`
    Age  int    `xml:"age"`
    addr string `xml:"addr"` // 该属性转 XML 时会被忽略
}

func main() {
    // 注意: XML 字符串格式一定要正确，否则会报错
    tomXml := `
<person>
    <name>Tom</name>
    <age>6</age>
    <addr>???</addr>
</person>
`
    var tom person
    err := xml.Unmarshal([]byte(tomXml), &tom)
    if err != nil {
        panic(err)
    }

    // 从输出字符串中可以看到，并没有为 addr 属性赋值
    fmt.Printf("Tom's name is %s, age is %d, addr is %s\n", tom.Name, tom.Age, tom.addr)
}

// $ go run main.go
// 输出如下 
/**
  Tom's name is Tom, age is 6, addr is
*/

输出格式化 XML 字符串

调用 xml.MarshalIndent() 方法完成。

package main

import (
    "encoding/xml"
    "fmt"
)

type person struct {
    Name  string   `xml:"name"`
    Age   int      `xml:"age"`
    Hobby []string `xml:"hobby"`
}

func main() {
    tom := person{ // 使用字面量初始化
        Name: "Tom",
        Age:  6,
        Hobby: []string{
            "reading",
            "coding",
            "movie",
        },
    }

    // 前缀符为空字符串，缩进符为 4 个空格
    formatted, err := xml.MarshalIndent(tom, "", "    ")
    if err != nil {
        panic(err)
    }

    fmt.Printf("xml.MarshalIndent(tom) = \n%s\n", formatted)
}

// $ go run main.go
// 输出如下 
/**
  xml.MarshalIndent(tom) =
  <person>
      <name>Tom</name>
      <age>6</age>
      <hobby>reading</hobby>
      <hobby>coding</hobby>
      <hobby>movie</hobby>
  </person>
*/

属性值(版本号)

通过 attr 关键字完成。

package main

import (
    "encoding/xml"
    "fmt"
)

type person struct {
    Version string `xml:"version,attr"` // attr 关键字将字段标记为属性
    Name    string `xml:"name"`
    Age     int    `xml:"age"`
}

func main() {
    tom := person{
        Version: "1.0",
        Name:    "Tom",
        Age:     6,
    }

    formatted, err := xml.MarshalIndent(tom, "", "    ")
    if err != nil {
        panic(err)
    }

    fmt.Printf("%s\n", formatted)
}

// $ go run main.go
// 输出如下 
/**
  <person version="1.0">
      <name>Tom</name>
      <age>6</age>
  </person>
*/

忽略零值

通过 omitempty 关键字完成。

package main

import (
    "encoding/xml"
    "fmt"
)

type person struct {
    Version string  `xml:"version,attr"`
    Name    string  `xml:"name"`
    Age     int     `xml:"age"`
    Money   float64 `xml:"money,omitempty"` // omitempty 关键字将字段标记为忽略零值
}

func main() {
    tomNoMoney := person{
        Version: "1.0",
        Name:    "Tom",
        Age:     6,
        Money:   0,
    }

    formatted, err := xml.MarshalIndent(tomNoMoney, "", "    ")
    if err != nil {
        panic(err)
    }

    fmt.Printf("%s\n\n", formatted) // 从输出字符串中可以看到，并没有 money 属性

    tomHasMoney := person{
        Version: "1.0",
        Name:    "Tom",
        Age:     6,
        Money:   100,
    }

    formatted, err = xml.MarshalIndent(tomHasMoney, "", "    ")
    if err != nil {
        panic(err)
    }

    fmt.Printf("%s\n", formatted) // 从输出字符串中可以看到，有 money 属性
}

// $ go run main.go
// 输出如下 
/**
  <person version="1.0">
      <name>Tom</name>
      <age>6</age>
  </person>

  <person version="1.0">
      <name>Tom</name>
      <age>6</age>
      <money>100</money>
  </person>
*/

联系我

本作品采用《CC 协议》，转载必须注明作者和本文链接