GRPC在NET上的应用

GRPC是什么？

GRPC是一个开源RPC框架，于2015年3月开源，其由Google主要面向移动应用开发并基于HTTP/2协议标准而设计，基于Protobuf 3.0(Protocol Buffers)序列化协议，主流语言都支持主要是支持C#

使用场景？

实现客户端调用服务端方法并取返回值 GRPC可以实现跨语言的访问

下面跟着官网文档开始干

1）先了解下protobuf？

Protocol Buffers是Google开源的一个语言无关、平台无关的通信协议，其小巧、高效和友好的兼容性设计，使其被广泛使用。

2）VS2015下新建项目

分别建立两个项目跟一个类库分别代表着服务端客户端基础类库

3）引用dll

需要使用NuGet下载安装 *并引用* Google.Protobuf Grpc.Core Grpc.Tools 网站项目需要共同Publicl类库

4）定义服务

在Public类库新建文件夹命名为protos用来存放.proto文件,在文件夹下新建GetUser.proto文件内容如下

syntax = "proto3";
 
option java_multiple_files = true;
option java_package = "io.grpc.examples.Public";
option java_outer_classname = "GetUserProto";
option objc_class_prefix = "HLW";
 
package Public;
//定义的服务
service GetUserList {
 rpc GetList(pharm) returns (Userlist) {}
}
//服务的参数
message pharm {
  string name = 1;
}
 
//返回参数
message Userlist {
user userinfo=1;
int32 no=2;
}
 
message user{
 string name=1;
 string detail=2;
}

5）生成代码

生成代码需要使用官网提供的grpc_csharp_plugin.exe跟protoc.exe ,工具位置在 _你的项目>> packages>>Grpc.Tools.1.14.1>>tools>>windows_x64

（也可在官网demo中找到 https://github.com/grpc/grpc）

把两个exe跟刚建好的GetUser.proto放入同一个文件夹下地址栏运行cmd

执行命令如下：protoc.exe -I=. --csharp_out=. --grpc_out=. --plugin=protoc-gen-grpc=grpc_csharp_plugin.exe GetUser.proto

6）把cs文件剪切到Public类库下，目录结构如下

7）建立服务端

服务端重写定义的服务GetUserList

GrpcDemoWebServer项目->新建GetUserI.cs文件代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using Public;
using Grpc.Core;
using System.Threading.Tasks;

namespace GrpcDemoWeb.Models
{
    public class GetUserI:GetUserList.GetUserListBase
    {
        public override Task<Userlist> GetList(pharm request, ServerCallContext context)
        {
            var users = new user();
            users.Name = "姓名";
            users.Detail = "描述";
            //以下注意 不能将null值赋值给Userinfo
            return Task.FromResult(new Userlist {
                Userinfo= users,
                No=1
            });
        }

    }
}

在服务端Global.asax->Application_Start中启动服务代码如下:

            const int Port = 50051;
            Server server = new Server
            {
                //重要，每次新建服务都需要在下方注册，否则会出现错误 【Status(StatusCode=Unimplemented,Detail="")】
                Services = {
                     GetUserList.BindService(new GetUserI())
                },
                Ports = { new ServerPort("localhost", Port, ServerCredentials.Insecure) }
            };

            server.Start();
            //server.ShutdownAsync().Wait();

8）建立客户端

GRpcDemoWebClient-》新建控制器index->代码如下：

  public ActionResult Index()
        {
            //链接对应的服务端
            Channel channel = new Channel("127.0.0.1:50051", ChannelCredentials.Insecure);
            var result = new GetUserList.GetUserListClient(channel);
            //var client = new GetUser.GetUserClient(channel);

            //调用对应方法并传递参数
            var reply = result.GetList(new pharm {Name="1"});
            //var reply1 = client.GetFeature(new Point { Latitude = 111, Longitude = 222 });
            //等待计划完成
            channel.ShutdownAsync().Wait();
            //返回页面
            return Content(reply.Userinfo.Name);
        }