gRPC by .NET Core 3.x：概念语法编译

Posted 2021-04-01 DotNet

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了gRPC by .NET Core 3.x：概念语法编译相关的知识，希望对你有一定的参考价值。

（给DotNet加星标，提升.Net技能）

转自：预备铲屎官

cnblogs.com/muchengqingxin/p/13209800.html

什么是grpc？

grpc来自大名鼎鼎的谷歌，孵化于CNCF基金会（docker、k8s同样出自这个基金会）。

它是一款高性能、开源、通用的rpc框架，你可以通过它来定义rpc的请求和响应。它基于http/2，全双工通信、低延迟、高效率、支持流、可轻松的插入身份认证、负载均衡、监控日志等等等等。。。关键是它还可以跨语言操作。

只要server端或client端是它支持的语言编写，都可以跨语言操作。官方支持的开发语言：

什么是rpc？

rpc，全称Remote Procedure Call，通过它，你可以像调用本地方法一样调用远程服务。

前端可以调用后端方法，后端也可以调用前端方法。其实这个概念并不陌生，上一篇关于web实时应用的文章也提到了这个概念，并实现了前后端互调的操作。

在正式开始使用grpc之前，我们还需要掌握protocol buffer的概念。

为什么用protocol buffer？

因为grpc采用合约优先的API开发模式，默认采用protocol buffer作为接口设计语言，我们可以在proto文件里定义消息和服务。当然，作为默认选项，它自然是有优势的，主要是这些：

1、语法简单，容易上手。

2、可生成所有（官方称）主流开发语言的代码。

3、二进制格式，效率高的同时也很适合大数据传输。

了解完基础以后，先上一个小demo参考一下：

syntax = "proto3";
import "aaa.proto";
option csharp_namespace = "gRPCApiDemo.Protos";
package Demo;
service Math{
    rpc Add (AddRequest) returns (AddRespones);
}
message AddRequest{
    int32 a=1;
    int32 b=2;
}
message AddRespones{
    int32 a=1;
    repeated int32 b=2;
　　reserved 3,4 to 10;
　　reserved "phone";
}

解读一下：

syntax：声明当前使用的语法
import：引入其他proto
option csharp_namespace：打包以后类的命名空间，优先级高
package：打包以后类的命名空间，优先级低
service：声明服务

rpc Add (AddRequest) returns (AddRespones)：声明一个rpc调用，接收AddRequest消息，返回AddRespones消息。
message：声明消息
int32：数据类型，常用的还有int64、float、string、bool等，有兴趣的可以去查一下。
a=1：如果把a看作字段名，那么1相当于字段名的别名。
repeated：可重复字段。如果给b多个值，那么b差不多相当于一个int类型的数组，先后顺序会被保留。
reserved：保留字段，声明以后的字段名和别名都不允许再使用了。需要注意字段名和别名不能一起声明。