Google ProtoBuf在C#中的簡單應用

簡介

什麼是 Google Protocol Buffer？ 假如您在網上搜索，應該會獲得相似這樣的文字介紹：

Google Protocol Buffer( 簡稱 Protobuf) 是 Google 公司內部的混合語言數據標準，目前已經正在使用的有超過 48,162 種報文格式定義和超過 12,183 個 .proto 文件。他們用於 RPC 系統和持續數據存儲系統。

Protocol Buffers 是一種輕便高效的結構化數據存儲格式，能夠用於結構化數據串行化，或者說序列化。它很適合作數據存儲或 RPC 數據交換格式。可用於通信協議、數據存儲等領域的語言無關、平臺無關、可擴展的序列化結構數據格式。目前提供了 C++、Java、Python 三種語言的 API。

說一千道一萬，Google Protocol Buffer是一個序列化數據結構好幫手，  相對於XML、二進制序列化方式，Protobuf效率較高，支持數據量較大，protobuf序列化後的大小是json的1/10，xml格式的1/20，是二進制序列化的1/10 (具體本人未測試過，數據由此篇文章獲得：protobuf效率)

C#中怎麼使用？

1、準備工做

1. Visual Studio 2019(其餘版本亦可）
2. Nuget安裝：Google.Protobuf和Google.Protobuf.Tools
3. 準備.proto文件

2、關於proto文件

使用ProtoBuf，主要有兩個操做：序列化和反序列化。這兩個操做都須要協議描述文件，也就是.proto文件。若是要使用protobuf存儲自定義的數據，就要本身編寫proto文件，若是要讀取其餘的ProtoBuf序列化文件，就要先知道要讀取的ProtoBuf序列化文件的協議，也就是要得到對應的.proto文件，這是一個必須條件，沒有對應的proto文件,就沒法正確打開ProtoBuf序列化文件。

3、步驟

一、安裝Google.Protobuf和Google.Protobuf.Tools的Nuget包

安裝Nuget包

二、在Google.Protobuf.Tools下找到編譯工具protoc.exe，個人電腦中路徑是：C:\Users\admin.nuget\packages\google.protobuf.tools\3.10.1\tools\windows_x64，在此目錄之上，還有不少版本，看您程序具體版本及tools版本而定。

三、準備好協議描述文件xx.proto，須要注意的是，proto文件之間能夠互相引用，要正常使用，必須把全部相關的proto文件都準備好。下面是我本身寫的一個測試文件test.proto：

syntax = "proto3";
option cc_enable_arenas = true;

package Test;

message TestContact {
	int32 ID = 1;
	string Address = 2;
	string Name = 3;
}

四、生成解碼器

1. 創建兩個文件夾，一個名爲src,另外一個爲gen
2. 把準備好的proto文件所有放到src中，如個人test.proto
3. 運行命令:.\protoc.exe –proto_path=src –csharp_out=gen test.proto
4. 把全部的proto文件都生成一遍
5. 在gen文件夾中，會發現有等量的.cs文件，這就是對應的解碼器，咱們要把他們放進本身的工程中。

個人代碼目錄結構test.proto生成解碼器protoC#部分代碼

五、打開安裝了Google.Protobuf和Google.Protobuf.Tools的Nuget包的C#工程，把剛剛生成的解碼器導入工程中。

我把tools工具和proto文件及proto cs文件一塊兒放入工程的代碼結構

六、具體使用代碼

using Google.Protobuf;
using System;
using System.IO;
using Test;

namespace protoctest
{
    class Program
    {
        static void Main(string[] args)
        {
            TestContact t = new TestContact();
            t.ID = 1;
            t.Name = "xiao ming";
            t.Address = "Cheng Du";
            Console.WriteLine($"序列化以前：{t}");

            //序列化操做
            byte[] data = new byte[t.CalculateSize()];
            using (CodedOutputStream cos = new CodedOutputStream(data))
            {
                t.WriteTo(cos);
                //data = cos.to.ToArray();
            }

            //反序列化操做
            TestContact t1 = TestContact.Parser.ParseFrom(data);
            Console.WriteLine($"反序列化獲得：{t1}");

            Console.ReadKey();
        }
    }
}

七、運行效果以下

運行效果

4、代碼

代碼已上傳CSDN:C#使用Google ProtoBuf例子

參考文章以下：

1. Google Protocol Buffers
2. Yowko’s Notes
3. Angle_Cal

 

發佈者：沙漠盡頭的狼，轉轉請註明出處：https://lsq6.com/index.php/2019/11/11/google-protobuf-forcharp/