使用 Go 的 xml 包编组 DIDL-Lite

聖光之護

发布时间：2025-09-04 22:51:01

970人浏览过

来源于php中文网

原创

使用 go 的 xml 包编组 didl-lite

本文档旨在指导开发者如何使用 Go 语言的 encoding/xml 包将数据编组为 DIDL-Lite XML 格式。通过示例代码，详细介绍了如何定义带有命名空间前缀、配置多个命名空间以及为属性设置命名空间的 Go 数据类型，从而实现 XML 编组。

使用 Go 的 encoding/xml 包编组 XML 数据

Go 语言的 encoding/xml 包提供了解析和生成 XML 文档的功能。在处理复杂 XML 结构，例如 DIDL-Lite 时，理解如何正确使用命名空间和属性至关重要。本教程将引导你完成使用 Go 将数据编组为特定 DIDL-Lite XML 格式的过程。

定义 Go 数据类型

首先，需要定义与 XML 结构相对应的 Go 数据类型。在 DIDL-Lite 的例子中，我们需要定义 DIDLLite 和 Object 结构体。关键在于使用 xml 标签来指定 XML 元素的名称、命名空间和属性。

package main

import (
    "encoding/xml"
    "fmt"
)

type DIDLLite struct {
    XMLName xml.Name `xml:"urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/ DIDL-Lite"`
    DC      string   `xml:"xmlns:dc,attr"`
    UPNP    string   `xml:"xmlns:upnp,attr"`
    XSI     string   `xml:"xmlns:xsi,attr"`
    XLOC    string   `xml:"xsi:schemaLocation,attr"`
    Objects []Object `xml:"item"`
}

type Object struct {
    ID         string `xml:"id,attr"`
    Parent     string `xml:"parentID,attr"`
    Restricted string `xml:"restricted,attr"`
}

解释:

XMLName xml.Name: 定义了 XML 根元素的名称和命名空间。Space 字段设置为根元素的命名空间 URI，Local 字段设置为元素名称。
DC string \xml:"xmlns:dc,attr"``: 定义了命名空间前缀 dc 及其对应的 URI。xml:"xmlns:dc,attr" 表示这是一个属性，属性名称为 xmlns:dc。 attr 关键字指示 encoding/xml 包将其作为 XML 属性处理。
UPNP string \xml:"xmlns:upnp,attr"``: 类似于 DC，定义了命名空间前缀 upnp 及其 URI。
XSI string \xml:"xmlns:xsi,attr"``: 定义了命名空间前缀 xsi 及其 URI。
XLOC string \xml:"xsi:schemaLocation,attr"``: 定义了带有命名空间前缀的属性 xsi:schemaLocation。这允许你指定 XML Schema 的位置。
Objects []Object \xml:"item"``: 定义了 Object 类型的切片，对应于 XML 中的 <item> 元素。
Object 结构体: 定义了 item 元素的属性，如 id、parentID 和 restricted。

编组数据

现在，我们可以创建 DIDLLite 结构体的实例，并使用 xml.MarshalIndent 函数将其编组为 XML 数据。

Face++旷视

Face⁺⁺ AI开放平台

下载

func main() {
    d := DIDLLite{
        XMLName: xml.Name{
            Space: "urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/",
            Local: "DIDL-Lite",
        },
        DC:   "http://purl.org/dc/elements/1.1/",
        UPNP: "urn:schemas-upnp-org:metadata-1-0/upnp/",
        XSI:  "http://www.w3.org/2001/XMLSchema-instance",
        XLOC: `
   urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/
    http://www.upnp.org/schemas/av/didl-lite-v2-20060531.xsd
   urn:schemas-upnp-org:metadata-1-0/upnp/
    http://www.upnp.org/schemas/av/upnp-v2-20061231.xsd`,
        Objects: []Object{{ID: "18", Parent: "13", Restricted: "0"}},
    }
    b, err := xml.MarshalIndent(d, "", "    ")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(b))
}

解释:

xml.MarshalIndent(d, "", " "): 将 DIDLLite 结构体 d 编组为 XML 数据。 MarshalIndent 函数允许你指定前缀和缩进，以使 XML 输出更具可读性。第一个参数是要编组的数据，第二个参数是每行开头的字符串（这里为空字符串），第三个参数是用于缩进的字符串（这里是四个空格）。
错误处理: 检查编组过程中是否发生错误。

完整示例代码

package main

import (
    "encoding/xml"
    "fmt"
)

type DIDLLite struct {
    XMLName xml.Name `xml:"urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/ DIDL-Lite"`
    DC      string   `xml:"xmlns:dc,attr"`
    UPNP    string   `xml:"xmlns:upnp,attr"`
    XSI     string   `xml:"xmlns:xsi,attr"`
    XLOC    string   `xml:"xsi:schemaLocation,attr"`
    Objects []Object `xml:"item"`
}

type Object struct {
    ID         string `xml:"id,attr"`
    Parent     string `xml:"parentID,attr"`
    Restricted string `xml:"restricted,attr"`
}

func main() {
    d := DIDLLite{
        XMLName: xml.Name{
            Space: "urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/",
            Local: "DIDL-Lite",
        },
        DC:   "http://purl.org/dc/elements/1.1/",
        UPNP: "urn:schemas-upnp-org:metadata-1-0/upnp/",
        XSI:  "http://www.w3.org/2001/XMLSchema-instance",
        XLOC: `
   urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/
    http://www.upnp.org/schemas/av/didl-lite-v2-20060531.xsd
   urn:schemas-upnp-org:metadata-1-0/upnp/
    http://www.upnp.org/schemas/av/upnp-v2-20061231.xsd`,
        Objects: []Object{{ID: "18", Parent: "13", Restricted: "0"}},
    }
    b, err := xml.MarshalIndent(d, "", "    ")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(b))
}

输出:

<DIDL-Lite xmlns="urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:upnp="urn:schemas-upnp-org:metadata-1-0/upnp/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
   urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/
    http://www.upnp.org/schemas/av/didl-lite-v2-20060531.xsd
   urn:schemas-upnp-org:metadata-1-0/upnp/
    http://www.upnp.org/schemas/av/upnp-v2-20061231.xsd">
    <item id="18" parentID="13" restricted="0"></item>
</DIDL-Lite>