• 简体中文

      • Serde: Rust序列化与反序列化框架

      (Serde)[https://docs.rs/serde/latest/serde/] 是 Rust 生态系统中的核心库，提供了高效且通用的序列化和反序列化框架。其名称来源于"Serialization"和"Deserialization"的组合。

      主要特点

      • 通用性：支持多种数据格式，如JSON、YAML、TOML、MessagePack等
      • 零成本抽象：编译时生成的代码与手写代码一样高效
      • 灵活性：可自定义序列化和反序列化行为
      • 强类型：利用Rust的类型系统确保数据完整性
      • 广泛应用：成为Rust生态系统中处理数据交换的标准库

      工作原理

      Serde 的核心是其中间表示（Intermediate Representation）设计，它将序列化和反序列化过程分为两步：

      1. 序列化：将Rust数据结构转换为通用中间表示，再转换为目标格式
      2. 反序列化：将输入格式转换为通用中间表示，再转换为Rust数据结构

      这种设计允许添加新的数据格式而不需要修改使用Serde的应用程序。

      基本用法

      设置依赖

      [dependencies]
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0" # 或其他格式库如 serde_yaml、toml 等

      派生宏用法

      最常见的用法是使用派生宏为结构体自动实现序列化和反序列化特性：

      use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize, Debug)]
struct Point {
    x: i32,
    y: i32,
}

fn main() {
    let point = Point { x: 1, y: 2 };

    // 将Point转换为JSON字符串
    let serialized = serde_json::to_string(&point).unwrap();
    println!("序列化结果: {}", serialized); // 输出: {"x":1,"y":2}

    // 将JSON字符串转换回Point
    let deserialized: Point = serde_json::from_str(&serialized).unwrap();
    println!("反序列化结果: {:?}", deserialized); // 输出: Point { x: 1, y: 2 }
}

      属性自定义

      Serde 提供了丰富的属性来自定义序列化行为：

      #[derive(Serialize, Deserialize, Debug)]
struct User {
    #[serde(rename = "user_id")]
    id: u64,
    
    #[serde(default)]
    name: String,
    
    #[serde(skip_serializing_if = "Option::is_none")]
    email: Option<String>,
    
    #[serde(skip)]
    temporary_data: usize,
}

      支持的数据格式

      Serde 与多种数据格式集成，每种格式都有独立的crate：

      • serde_json: JSON格式
      • serde_yaml: YAML格式
      • toml: TOML格式
      • bincode: 二进制格式
      • postcard: 空间优化的二进制格式
      • rmp/rmp-serde: MessagePack格式
      • ciborium: CBOR格式
      • ...等其他格式

      高级用法

      手动实现特性

      对于特殊需求，可以手动实现Serialize和Deserialize特性：

      use serde::{Serialize, Serializer, Deserialize, Deserializer};

struct MyType {
    // 字段...
}

impl Serialize for MyType {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        // 自定义序列化逻辑
    }
}

impl<'de> Deserialize<'de> for MyType {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        // 自定义反序列化逻辑
    }
}

      类型映射

      可以在不同数据表示之间创建映射：

      #[derive(Serialize, Deserialize)]
#[serde(remote = "chrono::DateTime<chrono::Utc>")]
struct DateTimeRef {
    #[serde(with = "chrono::serde::ts_seconds")]
    pub inner: chrono::DateTime<chrono::Utc>,
}

      学习和资源

      Serde 是一个功能丰富的库，本文只涵盖了基础知识。要充分利用Serde，建议读者：

      1. 访问Serde官方文档了解详细API和示例
      2. 查看GitHub仓库获取源码和最新更新

      结语

      Serde 作为Rust生态系统中的基础库，为数据交换提供了强大而灵活的工具。通过掌握Serde，您可以轻松处理各种格式的数据交换需求，使应用程序更加强大和可互操作。