Prost Rust：方法、示例、安装

什么是 Prost 以及为什么需要它？

\n\n

Prost 是一个强大且高性能的 Rust 编程语言库，用于处理 Protocol Buffers (protobuf)。Protocol Buffers 是 Google 开发的一种结构化数据序列化机制，与 JSON 或 XML 相比，它更紧凑、速度更快。

\n\n

Prost 解决了几个关键问题：

代码生成： 自动从 .proto 文件生成 Rust 结构体，使开发者免于重复性工作。
序列化和反序列化： 将数据从 protobuf 二进制格式转换为 Rust 结构体，反之亦然。
高性能： 使用零拷贝（zero-copy）和高效的内存管理，使其成为 Rust 中处理 protobuf 最快的解决方案之一。
安全性： 完全用 Rust 编写，保证了内存和线程安全。

\n\n

该库在微服务架构、服务间数据交换系统、配置存储以及任何需要高效序列化的场景中特别有用。

\n\n

安装

\n\n

Prost 通过 Cargo 包管理器安装。要开始使用，请将以下依赖项添加到您的 Cargo.toml 中：

\n\n

[dependencies]\nprost = "0.12"\nprost-build = "0.12"\ntonic = "0.11"  # 可选，用于 gRPC\nbytes = "1.5"   # 用于处理缓冲区\n\n[build-dependencies]\nprost-build = "0.12"

\n\n

您还需要安装 protobuf 编译器（protoc）。在 Ubuntu/Debian 上：

sudo apt install protobuf-compiler

\n\n

在 macOS 上：

brew install protobuf

\n\n

在 Windows 上，从 protobuf 官方仓库下载二进制文件并添加到 PATH。

\n\n

快速入门

\n\n

创建文件 person.proto：

\n\n

syntax = "proto3";\n\nmessage Person {\n    string name = 1;\n    int32 age = 2;\n    repeated string phone_numbers = 3;\n}

\n\n

在项目根目录创建 build.rs：

\n\n

fn main() -> Result<(), Box<dyn std::error::Error>> {\n    prost_build::compile_protos(&["src/person.proto"], &["src/"])?;\n    Ok(())\n}

\n\n

现在在 main.rs 中：

\n\n

use prost::Message;\n\n// 生成的代码将在 person 模块中\npub mod person {\n    include!(concat!(env!("OUT_DIR"), "/person.rs"));\n}\n\nfn main() {\n    // 创建一个对象\n    let person = person::Person {\n        name: "阿列克谢".to_string(),\n        age: 30,\n        phone_numbers: vec!["+7-999-123-45-67".to_string()],\n    };\n\n    // 序列化为字节\n    let mut buf = Vec::new();\n    person.encode(&mut buf).unwrap();\n    println!("已序列化 {} 字节", buf.len());\n\n    // 反序列化回来\n    let decoded = person::Person::decode(&buf[..]).unwrap();\n    println!("姓名: {}, 年龄: {}", decoded.name, decoded.age);\n}

\n\n

主要方法和函数

\n\n

1. `Message::encode`

功能： 将消息序列化为 protobuf 二进制格式并写入缓冲区。

参数：

&self — 消息的引用
buf: &mut impl BufMut — 用于写入的缓冲区（通常是 Vec<u8>）

示例：

let mut buf = Vec::new();\nmy_message.encode(&mut buf).unwrap();

\n\n

2. `Message::decode`

功能： 将字节反序列化回 Rust 结构体。

参数：

buf: impl Buf — 字节源（切片、Vec、Bytes）

示例：


                
    
  图书馆中也有
  
                
                  
                 node-cron：JavaScript 任务调度器
      
                
                  
                 Combine for Swift：完整指南与示例
      
                
                  
                 Hangfire for C# (.NET): 完整指南及示例
      
                
                  
                 C++ HTTP客户端：顶级网络编程库
      
                
                  
                 ts-morph 用于 TypeScript：完整指南及示例