0

0

Rust serde-xml-rs库如何自定义XML序列化和反序列化

月夜之吻

月夜之吻

发布时间:2026-02-19 07:11:31

|

884人浏览过

|

来源于php中文网

原创

serde-xml-rs 默认不支持字段重命名或属性/文本混合,因其xml映射规则隐式:字段默认为子元素,不生成属性或区分文本内容;需用#[serde(rename = "@attr")]或#[serde(rename = "$value")]等特殊语法显式控制。

rust serde-xml-rs库如何自定义xml序列化和反序列化

为什么 serde-xml-rs 默认不支持字段重命名或属性/文本混合?

serde-xml-rs 基于 serde 的泛型机制,但它的 XML 映射规则比 JSON 更隐式:它默认把 struct 字段当子元素,不生成 XML 属性,也不区分“元素文本内容”和“子元素”。比如 #[serde(rename = "foo")] 对字段名有效,但对 XML 属性、文本节点或命名空间无效——这些需要显式标注或自定义访问器。

#[serde(rename = "...")]#[serde(rename_attributes = "...")] 控制元素名和属性名

字段重命名只影响元素名;要生成属性,必须配合 #[serde(rename = "$value")]#[serde(rename = "@attr")] 语法(注意:这是 serde-xml-rs 特有的约定,不是标准 serde)。

  • #[serde(rename = "@id")] → 生成 XML 属性 id="..."
  • #[serde(rename = "$value")] → 把字段值作为父元素的文本内容(而非子元素)
  • #[serde(rename = "$text")] 是别名,效果同 $value
  • 多个 @xxx 字段会合并为同一层的属性;多个 $value 字段会冲突,只能有一个
#[derive(Deserialize, Serialize)]
struct Person {
    #[serde(rename = "@id")]
    id: u32,
    #[serde(rename = "$value")]
    name: String,
}

序列化后是:<person id="42">Alice</person>,而不是 <person><id>42</id><name>Alice</name></person>

如何处理混合内容(属性 + 文本 + 子元素)?

XML 允许一个元素同时有属性、文本内容和子元素(例如 <tag attr="x">text<child></child></tag>),但 serde-xml-rs 原生不支持。必须拆成三个字段,并用特殊 rename 标记:

  • #[serde(rename = "@attr")] → 属性
  • #[serde(rename = "$value")] → 文本内容(仅一个)
  • 普通字段名 → 子元素(如 child: Child

注意:如果结构体里既有 $value 又有子元素字段,serde-xml-rs 能正确解析,但反序列化时若 XML 文本为空(如 <tag><child></child></tag>),$value 字段会得到空字符串而非 None —— 需手动用 Option<string></string> 并加 #[serde(default)] 处理。

SophNet
SophNet

专业的AI开发工具平台,让AI集成变得简单高效。

下载

自定义序列化/反序列化逻辑要用 serialize_withdeserialize_with

当内置映射不够用(比如日期格式、枚举转特定字符串、CDATA 包裹),需写独立函数并用属性标注。函数签名必须严格匹配:

  • 序列化函数: fn<s>(val: &T, ser: S) -> Result</s>,其中 S: Serializer
  • 反序列化函数: fn(de: D) -> Result<t d::error></t>,其中 D: Deserializer

例如把 u64 时间戳转为 ISO8601 字符串写入 XML 文本:

fn serialize_ts_as_iso8601<S>(ts: &u64, ser: S) -> Result<(), S::Error>
where
    S: serde::Serializer,
{
    let dt = chrono::NaiveDateTime::from_timestamp_opt(*ts as i64, 0).unwrap();
    ser.serialize_str(&dt.format("%Y-%m-%dT%H:%M:%SZ").to_string())
}

然后在字段上写:#[serde(serialize_with = "serialize_ts_as_iso8601")]

真实项目中最容易被忽略的是命名空间(xmlns)和 CDATA 支持——serde-xml-rs 完全不处理它们,必须手写 XML 字符串拼接或换用 quick-xml + 手动 serde 集成。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
C++系统编程内存管理_C++系统编程怎么与Rust竞争内存安全
C++系统编程内存管理_C++系统编程怎么与Rust竞争内存安全

C++系统编程中的内存管理是指 对程序运行时内存的申请、使用和释放进行精细控制的机制,涵盖了栈、堆、静态区等不同区域,开发者需要通过new/delete、智能指针或内存池等方式管理动态内存,以避免内存泄漏、野指针等问题,确保程序高效稳定运行。它核心在于开发者对低层内存有完全控制权,带来灵活性,但也伴随高责任,是C++性能优化的关键。

13

2025.12.22

Rust异步编程与Tokio运行时实战
Rust异步编程与Tokio运行时实战

本专题聚焦 Rust 语言的异步编程模型,深入讲解 async/await 机制与 Tokio 运行时的核心原理。内容包括异步任务调度、Future 执行模型、并发安全、网络 IO 编程以及高并发场景下的性能优化。通过实战示例,帮助开发者使用 Rust 构建高性能、低延迟的后端服务与网络应用。

4

2026.02.11

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

442

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

322

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

770

2023.08.02

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1929

2024.04.01

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

561

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号