初识ProtoBuf（3.18.1）

一、ProtoBuf介绍

Protocol Buffers（又名 protobuf）是谷歌的语言无关、平台无关、可扩展的结构化数据序列化机制。他是Google 的数据交换格式，可用于网络通讯和数据存储。

Protobuf通过定义数据的结构，然后使用protoc工具生成的源代码（包括C#、java、C++、Python等），方便实现在各种语言中数据流的读取。

官方提供了如何使用 protobuf 的开发人员的教程：
https://developers.google.com/protocol-buffers/docs/tutorials

示例：https://github.com/protocolbuffers/protobuf/blob/master/examples

Protocol Buffers 的完整文档可通过以下网址获得：
https://developers.google.com/protocol-buffers/

二、protoc编译器

协议编译器是用 C++ 编写的，我们可以直接下载编译后的exe。

github上网址:https://github.com/protocolbuffers/protobuf

编译完成版本：https://github.com/protocolbuffers/protobuf/releases

protoc 64为下载地址：protoc-3.18.1-win64.zip
完整版下载地址：protobuf-all-3.18.1.zip

解压后bin目录下：protoc.exe可以根据定义的结构体，直接生成各语言的代码。

// 输出c#代码
protoc --csharp_out=./ telegram.proto   // 输出java代码
protoc --java_out=./ telegram.proto

三、.proto文件

protobuf 需要定义一个数据结构的描述文件，用来说明数据的内容。

如下，是官网的一个例子：

syntax = "proto3"; // proto3 必须加此注解message SearchRequest {string query = 1;int32 page_number = 2;int32 result_per_page = 3;enum Corpus {UNIVERSAL = 0;WEB = 1;IMAGES = 2;LOCAL = 3;NEWS = 4;PRODUCTS = 5;VIDEO = 6;}Corpus corpus = 4;
}

上面是定义的一个message。包含：
String 类型的 query，编号是 1
int 类型的 page_number，编号是 2
枚举类型的 corpus

四、C#、java使用

简单使用如下：

C#例子

 // 定义对象，复制Telegram data = new Telegram ();data.UserCode = 76157;data.Status = RunStaus.Loaded;// 计算大小int size = data.CalculateSize();Console.WriteLine(size);// 输出对象到文件FileStream fso = new FileStream("test.data", FileMode.Create);data.WriteTo(fso );fsfso Close();// 读取文件生成对象FileStream fsi = new FileStream("test.data", FileMode.Open);Telegram data2 = new Telegram ();data2.MergeFrom(fsi );fsi .Close();

Java例子

 Telegram data= Telegram.newBuilder().setUserCode(1).setStatus(RunStaus.Loaded);// 输出对象到为Byte数组for(byte byte : data.toByteArray()){System.out.println(byte);}// 转化Byte数组为对象Telegram data2= null;try {data2= Telegram.parseFrom(data.toByteArray());} catch (InvalidProtocolBufferException e) {e.printStackTrace();}System.out.println(data2.toString());