《Dotnet9》系列-Google ProtoBuf在C#中的简单应用

程序员文章站 2022-08-28 13:49:46

时间如流水，只能流去不流回！点赞再看，养成习惯，这是您给我创作的动力！本文 Dotnet9 https://dotnet9.com 已收录，站长乐于分享dotnet相关技术，比如Winform、WPF、ASP.NET Core等，亦有C++桌面相关的Qt Quick和Qt Widgets等，只分 ......

时间如流水，只能流去不流回！

点赞再看，养成习惯，这是您给我创作的动力！

本文 dotnet9 https://dotnet9.com 已收录，站长乐于分享dotnet相关技术，比如winform、wpf、asp.net core等，亦有c++桌面相关的qt quick和qt widgets等，只分享自己熟悉的、自己会的。

简介

什么是 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 (具体本人未测试过，数据由此篇文章得到：)

c#中怎么使用？

一、准备工作

visual studio 2019(其他版本亦可）
nuget安装：google.protobuf和google.protobuf.tools
准备.proto文件

二、关于proto文件

使用protobuf，主要有两个操作：序列化和反序列化。这两个操作都需要协议描述文件，也就是.proto文件。如果要使用protobuf存储自定义的数据，就要自己编写proto文件，如果要读取其他的protobuf序列化文件，就要先知道要读取的protobuf序列化文件的协议，也就是要获得对应的.proto文件，这是一个必须条件，没有对应的proto文件,就无法正确打开protobuf序列化文件。

三、步骤

1、安装google.protobuf和google.protobuf.tools的nuget包

2、在google.protobuf.tools下找到编译工具protoc.exe，我的电脑中路径是：c:\users\admin.nuget\packages\google.protobuf.tools\3.10.1\tools\windows_x64，在此目录之上，还有很多版本，看您程序具体版本及tools版本而定。

3、准备好协议描述文件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;
}

4、生成解码器

建立两个文件夹，一个名为src,另一个为gen
把准备好的proto文件全部放到src中，如我的test.proto
运行命令:.\protoc.exe –proto_path=src –csharp_out=gen test.proto
把所有的proto文件都生成一遍
在gen文件夹中，会发现有等量的.cs文件，这就是对应的解码器，我们要把他们放进自己的工程中。

5、打开安装了google.protobuf和google.protobuf.tools的nuget包的c#工程，把刚刚生成的解码器导入工程中。

我把tools工具和proto文件及proto cs文件一起放入工程的代码结构

6、具体使用代码

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();
        }
    }
}

7、运行效果如下