初识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文件的。所
本文来自网络收集,不代表计算机技术网立场,如涉及侵权请联系管理员删除。
ctvol管理联系方式QQ:251552304
本文章地址:https://www.ctvol.com/cdevelopment/903716.html