初识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
初识ProtoBuf(3.18.1)_第1张图片

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

初识ProtoBuf(3.18.1)_第2张图片

四、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());

你可能感兴趣的:(protobuf,java,python)