Csharp/C#教程：C#语言使用gRPC、protobuf(Google Protocol Buffers)实现文件传输功能分享

　　初识gRPC还是一位做JAVA的同事在项目中用到了它，为了C#的客户端程序和java的服务器程序进行通信和数据交换，当时还是对方编译成C#，我直接调用。

　　后来，自己下来做了C#版本gRPC编写，搜了很多资料，但许多都是从入门开始？调用说“SayHi!”这种官方标准的入门示例，然后遇到各种问题……

　　关于gRPC和Protobuf介绍，就不介绍了，网络上一搜一大把，随便一抓都是标准的官方，所以直接从使用说起。

　　gPRC源代码：https://github.com/grpc/grpc；

　　protobuf的代码仓库：

github仓库地址：https://github.com/google/protobuf；

Google下载protobuff下载地址：https://developers.google.com/protocol-buffers/docs/downloads。

1、新建解决方案

　　分别在VS中新建解决方案：GrpcTest；再在解决方案中新建三个项目：GrpcClient、GrpcServer、GrpcService，对应的分别是客户端（wpf窗体程序）、服务端（控制台程序）、gRPC服务者（控制台程序）。在GrpcClient和GrpcServer项目中添加对GrpcService的引用。

　　在VS中对3个项目添加工具包引用：右键点击“解决方案gRPCDemo”，点击“管理解决方案的NuGet程序包”，在浏览中分别搜索”Grpc”、”Grpc.Tools”、”Google.Protobuf”，然后点击右面项目，全选，再点击安装（也可以用视图->窗口->程序包管理器控制台中的”Install-PackageGrpc”进行这一步，这里不提供这种方法，有兴趣自己百度）。

2、proto文件的语法

　　对于使用gRPC的通信框架，需要使用到对应的通信文件。在gRPC中，使用到的是proto格式的文件，对应的自然有其相应的语法。本文不详细阐述该文件的语法，感兴趣可以去官网看标准的语法，这儿有一个链接，中文翻译比较全的https://www.codercto.com/a/45372.html。需要对其文章内的1.3进行补充下：

required：一个格式良好的消息一定要含有1个这种字段。表示该值是必须要设置的。 optional：消息格式中该字段可以有0个或1个值（不超过1个）。 repeated：在一个格式良好的消息中，这种字段可以重复任意多次（包括0次）。重复的值的顺序会被保留。表示该值可以重复，相当于java中的List。

　　本示例项目实现文件传输，因此在项目GrpcService中添加一个FileTransfer.proto文件，文件内容如下：

syntax="proto3"; packageGrpcService; serviceFileTransfer{ rpcFileDownload(FileRequest)returns(streamFileReply); rpcFileUpload(streamFileReply)returns(streamFileReturn); } //请求下载文件时，所需下载文件的文件名称集合 messageFileRequest{ repeatedstringFileNames=1;//文件名集合 //repeated重复字段类似链表；optional可有可无的字段；required必要设置字段 stringMark=2;//携带的包 } //下载和上传文件时的应答数据 messageFileReply{ stringFileName=1;//文件名 int32Block=2;//标记---第几个数据 bytesContent=3;//数据 stringMark=4;//携带的包 } //数据上传时的返回值 messageFileReturn{ stringFileName=1;//文件名 stringMark=2;//携带的包 }

3、编译proto文件为C#代码

　　proto文件仅仅只是定义了相关的数据，如果需要在代码中使用该格式，就需要将它编译成C#代码文件。

　　　　PS：网上可以找到的编译，需要下载相关的代码，见博文。其他的也较为繁琐，所以按照自己理解的来写了。注意，我的项目是放在D盘根目录下的。

　　首先打开cmd窗口，然后在窗口中输入：D:GrpcTestpackagesGrpc.Tools.2.32.0toolswindows_x86protoc.exe-ID:GrpcTestGrpcService–csharp_outD:GrpcTestGrpcServiceD:GrpcTestGrpcServiceFileTransfer.proto–grpc_outD:GrpcTestGrpcService–plugin=protoc-gen-grpc=D:GrpcTestpackagesGrpc.Tools.2.32.0toolswindows_x86grpc_csharp_plugin.exe

　　输入上文后，按enter键，回车编译。

　　命令解读：

上述就是C#学习教程：C#语言使用gRPC、protobuf(Google Protocol Buffers)实现文件传输功能分享的全部内容，如果对大家有所用处且需要了解更多关于C#学习教程，希望大家多多关注—计算机技术网(www.ctvol.com)! D:GrpcTestpackagesGrpc.Tools.2.32.0toolswindows_x86protoc.exe：调用的编译程序路径，注意版本不同路径稍有不一样。 -ID:GrpcTestGrpcService：-I指定一个或者多个目录，用来搜索.proto文件的。所