首页 经验

Protocol Buffers(通常简写为 Protobuf)是由 Google 开发的一种语言无关、平台无关、可扩展的序列化结构数据的机制

时间: 2024-10-20 08:55:27

(部分内容来自网络,其真实性存疑,为了避免对您造成误导,请谨慎甄别。)


Protocol Buffers(通常简写为 Protobuf)是由 Google 开发的一种语言无关、平台无关、可扩展的序列化结构数据的机制。它用于在不同的系统间高效地交换信息,尤其在远程过程调用(RPC)和数据存储中非常流行。Protobuf 的主要优点包括高效的字段序列化、跨语言支持以及明确的接口定义。


1. Protobuf 的特点


- 高效性:Protobuf 使用二进制格式存储数据,相较于 JSON 和 XML 等文本格式,数据更加紧凑和高效。

- 跨语言支持:支持多种编程语言,包括 C++, Java, Python, Go, Ruby, C#, 等等。

- 版本控制:支持字段的增删改,能够很好地处理向后和向前兼容性。

- 自动生成代码:可以从 .proto 文件自动生成相应的类和序列化/反序列化方法,减少手动编码。


2. 安装 Protobuf


要使用 Protobuf,您需要安装 Protocol Buffers 编译器(protoc)和相应的语言插件。以下是在不同系统上安装 Protobuf 的步骤:


Ubuntu


sh

sudo apt-get install -y protobuf-compiler

sudo apt-get install -y libprotobuf-dev


macOS


使用 Homebrew 安装:


sh

brew install protobuf


Windows


对于 Windows,您可以从 [Protobuf Releases](https://github.com/protocolbuffers/protobuf/releases) 页面下载预编译的二进制文件。


3. 定义 .proto 文件


Protobuf 使用 .proto 文件定义数据结构。以下是一个简单的示例:


protobuf

syntax = "proto3";


package tutorial;


// 定义一个消息

message Person {

    string name = 1; // 字段名 = 字段编号

    int32 id = 2;

    string email = 3;


    // 嵌套消息

    message PhoneNumber {

        string number = 1;

        PhoneType type = 2;

    }


    enum PhoneType {

        MOBILE = 0;

        HOME = 1;

        WORK = 2;

    }


    repeated PhoneNumber phones = 4; // 可重复字段

}


4. 编译 .proto 文件


您可以使用 protoc 编译器将 .proto 文件编译为目标语言的代码。例如,编译上述 person.proto 文件:


sh

protoc --python_out=. person.proto


这将生成一个 Python 文件 person_pb2.py,其中包含定义的 Person 类型。


5. 使用 Protobuf


以下是如何在 Python 中使用 Protobuf 的示例:


python

import person_pb2  # 导入生成的 Python 模块


# 创建一个 Person 实例

person = person_pb2.Person()

person.name = "Alice"

person.id = 12345

person.email = "alice@example.com"


# 添加电话号码

phone = person.phones.add()

phone.number = "555-4321"

phone.type = person_pb2.Person.PhoneType.HOME


# 序列化数据

serialized_data = person.SerializeToString()


# 反序列化数据

new_person = person_pb2.Person()

new_person.ParseFromString(serialized_data)


print(new_person)


6. 支持的编程语言


Protobuf 支持多种编程语言,包括但不限于:


- C++

- Java

- Python

- Go

- C#

- Ruby

- Dart

- JavaScript


对于每种编程语言,您可以使用各自的插件生成相应的代码。


7. 版本控制与兼容性


Protobuf 支持向后和向前兼容,例如,您可以在不破坏现有数据结构的情况下添加新字段或删除不再需要的字段。使用 optionalrepeated 字段可以有效地管理版本之间的兼容性。


结论


Protocol Buffers 是一种高效、灵活、通用的序列化机制,广泛应用于微服务架构、RPC 和持久化存储等应用场景。无论是对性能的要求,还是需要跨语言支持,Protobuf 都是一个很好的选择。如需深入了解,您可以访问 [Protocol Buffers 官方文档](https://developers.google.com/protocol-buffers)。


上一个 tortoisegit 文章列表 下一个 python ---- %r %s格式输出的区别

最新

工具

© 2019-至今 适观科技

沪ICP备17002269号