goframe 框架解析 xml 数据主要依赖 gutil 包中的 xmltomap() 函数,该函数能将 xml 字符串直接转换为 go 的 map[string]interface{} 结构。若需将 xml 反序列化为自定义结构体,可先转为 map 再使用 gconv.struct() 进行转换,或者利用 gxml 包手动遍历节点赋值。序列化方面,可使用 gutil.maptoxml() 将 map 转回 xml,或通过 encoding/xml 标准库处理结构体。

如何将 XML 字符串解析为 Map 结构?
使用 gutil.XmlToMap() 函数可以直接将 XML 字符串解析为嵌套的 Map。该函数会自动处理 XML 标签到键名的映射,并保留属性信息。对于简单的 XML 文档,这是最快捷的方式,无需定义任何结构体即可获取数据。

package main
import (
"fmt"
"github.com/gogf/gf/v2/util/gutil"
)
func main() {
xmlStr := `<?xml version="1.0" encoding="UTF-8"?><user><id>123</id><name>John</name><active>true</active></user>`
result, err := gutil.XmlToMap(xmlStr)
if err != nil {
fmt.Println("Error:", err)
return
}
fmt.Printf("%+v\n", result)
}
预期输出:
如何将 XML 反序列化为自定义结构体?
虽然 GoFrame 没有直接的 XmlToStruct() 函数,但可以通过组合 gutil.XmlToMap() 和 gconv.Struct() 实现。首先将 XML 转为 Map,然后利用 gconv 包的类型转换能力将 Map 填充到结构体中。这种方法利用了 GoFrame 强大的类型转换机制,自动处理基本类型的转换。

package main
import (
"fmt"
"github.com/gogf/gf/v2/util/gconv"
"github.com/gogf/gf/v2/util/gutil"
)
type User struct {
ID int `json:"id" xml:"id"`
Name string `json:"name" xml:"name"`
Active bool `json:"active" xml:"active"`
}
func main() {
xmlStr := `<?xml version="1.0" encoding="UTF-8"?><user><id>456</id><name>Jane</name><active>false</active></user>`
// Step 1: Parse XML to Map
m, err := gutil.XmlToMap(xmlStr)
if err != nil {
fmt.Println("Parse Error:", err)
return
}
// Step 2: Convert Map to Struct
var user User
// Note: XmlToMap returns map[root]map[key]value
// We need to extract the inner map if root is 'user'
if userData, ok := m["user"].(map[string]interface{}); ok {
err = gconv.Struct(userData, &user)
if err != nil {
fmt.Println("Convert Error:", err)
return
}
}
fmt.Printf("User: %+v\n", user)
}
预期输出:
User: {ID:456 Name:Jane Active:false}
如何处理 XML 中的属性与子元素混合的情况?
当 XML 包含属性(如 )时,gutil.XmlToMap() 会将属性存储在名为 @attributes 的子 Map 中,而子元素则作为普通键值对存在。这种设计保持了结构的扁平化与层级清晰,开发者在访问属性时需额外一层索引。例如,上述结构中,item 节点下的 @attributes 键将包含 id 的值。











