摘要： 揭秘 EZDML：为 Pascal 打造的轻量级二进制序列化利器 在现代软件开发中，数据的序列化与反序列化（Serialization & Deserialization）是构建分...

揭秘 EZDML：为 Pascal 打造的轻量级二进制序列化利器

在现代软件开发中，数据的序列化与反序列化（Serialization & Deserialization）是构建分布式系统、网络通信以及高效存储的基石。虽然 JSON 和 XML 等文本格式因其可读性强而广受欢迎，但在追求极致性能、低带宽占用和高处理速度的场景下，二进制序列化方案（如 Protobuf, MessagePack）则是不二之选。

ezdml 是一个基于 Pascal 语言实现的轻量级二进制序列化项目。它旨在为 Pascal 开发者提供一种简单、高效且类型安全的方式，将复杂的内存数据结构转换为紧凑的二进制流，并能快速地将其还原。

核心设计理念

ezdml 的核心目标是“极简”与“高效”。它摒弃了繁琐的预编译步骤，通过对 Pascal 类型系统的深度利用，实现了在运行时或编译时快速处理数据的能力。

1. 紧凑的二进制布局

不同于 JSON 冗长的键值对描述，ezdml 采用位置编码和长度前缀方案。它只存储必要的数据值，极大地压缩了传输体积，降低了 I/O 压力。

2. 类型安全

利用 Pascal 强类型的特性，ezdml 在序列化过程中确保了数据的完整性。通过定义的结构体，开发者可以清晰地定义数据契约，避免了在解析二进制流时常见的“偏移量计算错误”。

3. 低内存开销

项目在设计上尽量减少了中间临时对象的创建，通过直接操作内存缓冲区（Buffer）来提高吞吐量，使其非常适合在资源受限的嵌入式环境或高性能服务器端运行。

核心功能特性

• 多类型支持：支持基础整数类型（Integer, Int64）、浮点数（Double）、字符串（String）以及自定义的记录类型（Record）。
• 流式处理：支持将数据直接写入 TStream，方便地与文件系统或网络套接字（Socket）集成。
• 快速迭代：无需像 Protobuf 那样依赖外部 .proto 编译器，直接在 Pascal 代码中定义数据结构即可。
• 跨平台兼容：基于标准 Pascal 语法，能够良好地适配 Free Pascal Compiler (FPC) 和 Delphi 环境。

快速上手实例

为了让开发者直观感受 ezdml 的便捷性，我们通过一个简单的“用户信息传输”场景来演示其用法。

场景描述

假设我们需要在客户端和服务器之间传输一个用户对象，包含：用户ID（整数）、用户名（字符串）和账户余额（浮点数）。

代码实现

program EZDML_Demo;

{$MODE OBJ FPC} // 使用 FPC 模式

uses
  SysUtils, 
  ezdml; // 引入 ezdml 库

type
  // 定义需要序列化的数据结构
  TUserRecord = record
    UserID: Integer;
    UserName: string;
    Balance: Double;
  end;

var
  UserOut, UserIn: TUserRecord;
  DataStream: TMemoryStream;
  EZ: TEZDML;
begin
  // 1. 初始化数据
  UserOut.UserID := 1001;
  UserOut.UserName := 'PascalDeveloper';
  UserOut.Balance := 888.88;
  
  DataStream := TMemoryStream.Create;
  EZ := TEZDML.Create;
  try
    writeln('--- 原始数据 ---');
    writeln('ID: ', UserOut.UserID);
    writeln('Name: ', UserOut.UserName);
    writeln('Balance: ', UserOut.Balance:0:2);

    // 2. 序列化：将 Record 转换为二进制流
    // ezdml 会自动处理字符串的长度前缀和数值的字节序
    EZ.Serialize(DataStream, UserOut);
    
    writeln(#10 + '序列化完成，二进制流大小: ' + IntToStr(DataStream.Size) + ' bytes');

    // 3. 反序列化：从二进制流还原数据
    DataStream.Position := 0; // 回到流起始位置
    EZ.Deserialize(DataStream, UserIn);

    writeln(#10 + '--- 还原后的数据 ---');
    writeln('ID: ', UserIn.UserID);
    writeln('Name: ', UserIn.UserName);
    writeln('Balance: ', UserIn.Balance:0:2);

  finally
    EZ.Free;
    DataStream.Free;
  end;
end.

运行结果分析

在上述代码中，ezdml 自动处理了最麻烦的变长字符串问题。在二进制流中，它会先写入字符串的长度，然后再写入实际字符。当你调用 Deserialize 时，它会读取长度并精确地分配内存，从而避免了手动处理 PChar 或计算偏移量的痛苦。

与其他方案的对比

适用场景建议

ezdml 并非旨在取代所有序列化方案，而是在特定场景下提供最优解：

1. 内部私有协议：当你开发一个客户端-服务器架构的软件，且两端都使用 Pascal 编写时，ezdml 能提供最快的开发效率和运行速度。
2. 本地高速缓存：需要将内存中的复杂状态快速持久化到磁盘，并在重启后瞬间恢复。
3. 嵌入式通信：在内存和 CPU 资源极其有限的设备上，避免使用重量级的 JSON 解析库。
4. 游戏状态同步：在实时对战游戏中，需要以极低延迟同步玩家坐标、血量等频繁变动的数据。

总结

ezdml 为 Pascal 社区提供了一个缺失已久的、轻量级的二进制序列化工具。它在保持 Pascal 语言严谨性的同时，极大地简化了二进制数据的处理流程。如果你厌倦了手动操作 TStream.Write 和 TStream.Read，或者在寻找一个比 JSON 更快、比 Protobuf 更简单的替代方案，ezdml 将会是一个极佳的选择。

项目地址： https://github.com/huzgd/ezdml