避免

• 如果使用广泛可用的标准对字节流进行序列化或反序列化，请避免使用此框架，而是使用相应的标准来处理字节流

该项目包含三个craits

[email protected] - byteserde_derive/Cargo.toml

• 包含生成[email protected]特质的derive宏

  • #[derive(ByteSerializeStack)] - 生成ByteSerializeStack特质

  • #[derive(ByteSerializeHeap)] - 生成ByteSerializeHeap特质

  • #[derive(ByteDeserializeSlice)] - 生成ByteDeserializeSlice特质

  • #[derive(ByteSerializedSizeOf)] - 生成ByteSerializedSizeOf特质 - 该特质提供了一个关联方法byte_size()，它返回一个字节大小的结构体内存大小（无对齐）。然而，它不支持堆分配的类型，例如Vector、String或它们的派生类型。

  • #[derive(ByteSerializedLenOf)] - 生成ByteSerializedLenOf特质 - 该特质提供了一个实例方法byte_len(&self)，它返回特定实例的字节大小（无对齐）。它专门用于处理ByteSerializedSizeOf特质不支持的情况。

• 更多示例请参阅此处
• 注意：Union和Unit结构不支持，但将来可能会改变。

[email protected] - byteserde/Cargo.toml

• 亮点

  • ByteSerializerStack<CAP> - 提供超快的序列化器，将数据序列到预分配的栈上byte array [u8; CAP]，因此得名。这个实用程序在达到预分配字节数组的边界时，序列化将失败。它提供重置功能，将内部计数器移至开始处，允许您多次回收缓冲区。

    • 适用于实现ByteSerializeStack trait的struct。

  • ByteSerializerHeap - 提供足够快的序列化器，通过将数据序列到byte vector Vec<u8>，因此得名。这个实用程序以一些性能为代价，避免了在预先不知道最大的struct大小时需要担心。

    • 适用于实现ByteSerializeHeap trait的struct。

  • ByteDeserializerSlice - 接受byte stream &[u8]，无论堆还是栈分配，将其转换为struct。

    • 适用于实现ByteDeserializeSlice<T> trait的struct。