什么是grpc？实例详解

本是古典何须时尚 2022-12-15 11:17 295阅读 0赞

# grpc是干嘛的？ #

grpc的定义网上都有非常官方的说明，这里从它的用法角度描述这个概念。

有了 gRPC， 我们可以一次性的在一个 .proto 文件中定义服务并使用任何支持它的语言去实现客户端和服务器，反过来，它们可以在各种环境中，从Google的服务器到你自己的平板电脑—— gRPC 帮你解决了不同语言间通信的复杂性以及环境的不同。使用 protocol buffers 还能获得其他好处，包括高效的序列号，简单的 IDL 以及容易进行的接口更新。\{来源：grpc官方文档\}

# grpc实例用法 #

grpc使用主要有如下步骤

1.  通过Protocol Buffer来定义接口和数据类型
2.  通过Protocol Buffer编译器编译proto文件为对应平台的代码文件
3.  编写gRPC server端代码
4.  编写gRPC client端代码

## 建立proto并且编译 ##

syntax = "proto3";		//指定语法proto2或proto3 本文采用proto3
     
    //package gRpcDemo;		//指定命名空间
    option csharp_namespace = "gRpcDemo";
     
    //定义rpc服务
    service gRpcQueryService
    {
    	rpc Search(QureyCond) returns (QueryResult);
    }
    //定义查询条件消息体
    message QureyCond
    {
    	int32 id=1;		//通过id查询		
    }
    //定义查询结果实体对象
    message QueryResult
    {
    	int32 id=1;		
    	string name=2;		
    	int32 age=3;	
    }

这里还需要再nuget中安装相关的grpc包 ，包括如下所示

![20201016140404334.png][]

然后使用命令对其进行编译

-I：设定源路径
    --csharp_out:：第一个参数设定编译文件的路径，第二个参数设定需要编译的proto文件；如果使用其它语言请使用对应语言的option
    --grpc_out：设定输出路径
    --plugin：设定编译需要的插件

使用的编译工具再刚刚装好的Grpc.Tools包下(grpc.tools\\2.25.0-pre1\\tools\\windows\_x64  下找到protoc.exe和grpc\_csharp\_plugin.exe ，然后一般这些安装好的依赖包都在C盘用户目录下的.nuget文件夹下)，随后编辑命令

## server端服务 ##

using Grpc.Core;
    using gRpcDemo;
    using System;
    using System.Threading.Tasks;
    
    namespace gRpcService
    {
        class Program
        {
            const int Port = 8050;
            static void Main(string[] args)
            {
                //开启服务器端口，并且将远程调用绑定服务接口
                Server server = new Server
                {
                    Services = { gRpcQueryService.BindService(new GRPCImpl()) },
                    Ports = { new ServerPort("localhost", Port, ServerCredentials.Insecure) }
                };   
                server.Start();
                Console.WriteLine("gRpc server listening on port" + Port);
                Console.ReadKey();
    
                server.ShutdownAsync().Wait();
    
            }
    
        }
        class GRPCImpl : gRpcQueryService.gRpcQueryServiceBase
        {
            public override Task<QueryResult> Search(QureyCond request,ServerCallContext context)
            {
                return Task.FromResult(Search(request));
            }
            private QueryResult Search(QureyCond cond)
            {
                QueryResult result = new QueryResult();
                result.Id = cond.Id;
                result.Name = "zhangsan";
                result.Age = 15;
                return result;
            }
        }
    }

## client端 ##

using System;
    using Grpc.Core;
    using gRpcDemo;
    
    namespace gRpcClient
    {
        class Program
        {
            static void Main(string[] args)
            {
                Channel channel = new Channel("localhost:8050", ChannelCredentials.Insecure);
                var client = new gRpcQueryService.gRpcQueryServiceClient(channel);
                var result = client.Search(new QureyCond { Id = 3 });
                Console.WriteLine("结果：id={0} name={1} age={2}", result.Id, result.Name, result.Age);
    
                channel.ShutdownAsync().Wait();
    
                Console.WriteLine("任意键退出...");
                Console.ReadKey();
            }
        }
    }

最终实现

![20201016142627911.png][]

参考

[https://www.cnblogs.com/stulzq/p/11590088.html][https_www.cnblogs.com_stulzq_p_11590088.html]

[https://blog.csdn.net/uiuan00/article/details/102831031][https_blog.csdn.net_uiuan00_article_details_102831031]

[https://blog.csdn.net/weixin\_41563161/article/details/106347789][https_blog.csdn.net_weixin_41563161_article_details_106347789]

[20201016140404334.png]: /images/20221123/1cdcfa5c4fec498cac3a723dc0cefc1b.png
[20201016142627911.png]: /images/20221123/f99408632bc34b0089073887eed11eb0.png
[https_www.cnblogs.com_stulzq_p_11590088.html]: https://www.cnblogs.com/stulzq/p/11590088.html
[https_blog.csdn.net_uiuan00_article_details_102831031]: https://blog.csdn.net/uiuan00/article/details/102831031
[https_blog.csdn.net_weixin_41563161_article_details_106347789]: https://blog.csdn.net/weixin_41563161/article/details/106347789