当前位置：首页 > news >正文

serde_with深度解析：掌握DisplayFromStr和DurationSeconds转换器

news 2026/6/10 10:18:34

serde_with深度解析：掌握DisplayFromStr和DurationSeconds转换器

【免费下载链接】serde_withThis crate provides custom de/serialization helpers to use in combination with serde's `with`-annotation and with the improved `serde_as`-annotation.项目地址: https://gitcode.com/gh_mirrors/se/serde_with

serde_with是一个强大的Rust crate，它提供了自定义的序列化和反序列化辅助工具，可与serde的with注解以及改进的serde_as注解结合使用。本文将详细介绍两个实用的转换器：DisplayFromStr和DurationSeconds，帮助开发者轻松处理复杂的序列化场景。

什么是serde_as注解？

serde_as是serde_with提供的一种改进型注解，相比serde原生的with注解，它提供了更大的灵活性和更强的功能。serde_as注解必须放在#[derive]之前，允许开发者为结构体字段指定自定义的序列化和反序列化方式。

使用serde_as的基本语法如下：

#[serde_as] #[derive(Serialize, Deserialize)] struct MyStruct { #[serde_as(as = "DisplayFromStr")] field: MyType, }

DisplayFromStr转换器：字符串与类型的无缝转换

DisplayFromStr的工作原理

DisplayFromStr转换器利用类型的Displaytrait将其序列化为字符串，同时使用FromStrtrait从字符串反序列化回该类型。这使得任何实现了Display和FromStrtrait的类型都可以轻松地与字符串进行相互转换。

DisplayFromStr的常见应用场景

基本类型转换：将整数、浮点数等基本类型序列化为字符串

#[serde_as] #[derive(Serialize, Deserialize)] struct Data { #[serde_as(as = "DisplayFromStr")] id: u32, #[serde_as(as = "DisplayFromStr")] value: f64, }

集合类型转换：与集合类型结合使用，实现整个集合的字符串转换

#[serde_as] #[derive(Serialize, Deserialize)] struct CollectionData { #[serde_as(as = "Vec<DisplayFromStr>")] numbers: Vec<u32>, #[serde_as(as = "BTreeSet<DisplayFromStr>")] unique_ids: BTreeSet<u64>, }

复杂类型处理：处理自定义类型，如IP地址、范围等

#[serde_as] #[derive(Serialize, Deserialize)] struct RangeData { #[serde_as(as = "ops::Range<DisplayFromStr>")] range: Range<u32>, #[serde_as(as = "ops::RangeInclusive<DisplayFromStr>")] inclusive_range: RangeInclusive<u32>, }

映射类型转换：在HashMap或BTreeMap中使用

#[serde_as] #[derive(Serialize, Deserialize)] struct MapData { #[serde_as(as = "HashMap<DisplayFromStr, DisplayFromStr>")] values: HashMap<u8, u32>, }

DurationSeconds转换器：时间间隔的序列化处理

DurationSeconds的功能介绍

DurationSeconds转换器用于将Duration类型序列化为秒数，支持多种精度和格式。它提供了严格模式（Strict）和灵活模式（Flexible）两种处理方式，以及多种数值类型选择。

DurationSeconds的主要变体

DurationSeconds：基本秒数转换，支持整数和浮点数

#[serde_as] #[derive(Serialize, Deserialize)] struct Timer { #[serde_as(as = "DurationSeconds<u64>")] interval: Duration, #[serde_as(as = "DurationSeconds<f64>")] precise_interval: Duration, }

DurationSecondsWithFrac：支持亚秒级精度的转换

#[serde_as] #[derive(Serialize, Deserialize)] struct PreciseTimer { #[serde_as(as = "DurationSecondsWithFrac<f64>")] precise_interval: Duration, }

字符串格式支持：将Duration序列化为字符串类型

#[serde_as] #[derive(Serialize, Deserialize)] struct StringTimer { #[serde_as(as = "DurationSeconds<String>")] interval_str: Duration, }

灵活模式处理：允许从不同类型反序列化

#[serde_as] #[derive(Serialize, Deserialize)] struct FlexibleTimer { #[serde_as(as = "DurationSeconds<u64, Flexible>")] flexible_interval: Duration, }

DurationSeconds的实际应用示例

#[serde_as] #[derive(Serialize, Deserialize)] struct Task { name: String, #[serde_as(as = "DurationSeconds<u64>")] timeout: Duration, #[serde_as(as = "DurationSecondsWithFrac<f64, Flexible>")] execution_time: Duration, #[serde_as(as = "Vec<DurationSeconds>")] retry_delays: Vec<Duration>, }

DisplayFromStr和DurationSeconds的高级组合使用

这两个转换器可以结合使用，处理更复杂的数据结构：

#[serde_as] #[derive(Serialize, Deserialize)] struct ComplexData { #[serde_as(as = "Map<DisplayFromStr, DurationSeconds<u64>>")] timeouts: HashMap<String, Duration>, #[serde_as(as = "SetLastValueWins<DisplayFromStr>")] unique_ids: BTreeSet<u32>, #[serde_as(as = "PickFirst<(_, DisplayFromStr)>")] priority: u8, }