一、介绍

底层HTTP/2协议标准协议层Protobuf序列化协议

gRPC也是基于以下理念:定义一个服务,指定其能够被远程调用的方法(包含参数和返回类型)。在服务端实现这个接口,并运行一个 gRPC服务器来处理客户端调用。在客户端拥有一个存根能够像服务端一样的方法。

特点:

  • 跨语言,多种语言的类库实现;
  • 基于HTTP/2之上的二进制协议;
  • Protobuf序列化机制,比JSON体积小,网络传输快;
  • 一个连接上可以多路复用,并发处理多个请求和响应;
  • 服务定义文件和自动代码生成(.proto 文件和 Protobuf 编译工具);
  • 适合高性能轻量的微服务,一般对外的接口用Restful API,内部服务的调用用gRPC。gRPC是一个分布式服务框架,和以前的WebService,WCF类似;
  • gRPC还提供了很多扩展点,用于对框架进行功能定制和扩展,例如,通过开放负载均衡接口可以无缝的与第三方组件进行集成对接(Zookeeper、域名解析服务、SLB 服务等)。

临时加更干货分享

大家能看到这里,已是对我们的支持了。分享一组2023年2月录制的C#零基础教程。我们喜欢做这样的分享,它足够的基础,对新手友好。如果需要的话,就来免费领取吧!

资料免费自取:

由于内容过多不便呈现,需要视频教程和配套源码的小伙伴,点击下方卡片!

也可点击下方卡片:点击后自动复制威芯号,并跳转到威芯。搜索威芯号添加,内容已做打包,备注知乎

即可免费领取,注意查收!

二、创建gRPC服务端

2.1、创建gRPC服务端项目

打开VS2022,新建项目,在输入框中输入gRPC关键字,选中gRPC项目模板,然后点击下一步,如下图所示:

输入项目名称“Quber.Grpc.Service”,然后点击下一步,如下图所示:

选中.NET 6,最后点击创建按钮,如下图所示:

默认项目文件结构,如下图所示:

2.2、文件说明

Protocols
Protos


Services

Services

上述图中的Greeter.GreeterBase来自greet.proto文件生成的类文件,具体位置如下图所示:

注册服务

Program.cs

2.3、创建自定义服务

接下来我们就以获取用户信息为例创建一个名称为user.proto的协议文件进行讲解。

创建user.proto协议文件

新建user.proto协议文件,如下图所示:

该协议文件的内容如下所示:

添加user.proto协议文件的关联配置

ItemGroup
\obj\Debug\net6.0\Protos

实现定义的服务

UserService.cs
User.UserBase
UserService

我们需要将新建的UserService服务在启动文件中进行注册,如下所示:

启动服务

到此,gRPC服务端就新建配置完成了,此时我们就可以启动该项目让其运行起来,如下图所示:

http://localhost:5201https://localhost:7288

三、创建gRPC客户端

3.1、创建gRPC客户端项目

Quber.Grpc.Client

3.2、复制proto协议文件

Quber.Grpc.Service

3.3、编辑客户端配置

ItemGroup
obj\Debug\net6.0\Protos

3.4、gRPC服务的https调用

在gRPC服务端项目中,给我们提供了2个地址的调用,一个是https的https://localhost:7288,另一个是http的http://localhost:5201,此处我们演示调用https。

UserTest.cs

然后我们在启动文件中进行调用并运行该客户端项目,如下图所示:

到此,调用gRPC服务端提供的https地址就成功了。

3.5、gRPC服务的http调用

相比https的调用,我们只需要在调用前加上如下代码即可:

UserTest.cs

运行效果如下:

3.6、依赖注入方式调用gRPC

UserTestIoc.cs
Program.cs

最后我们运行客户端,效果如下所示:

四、WebApi中使用gRPC

通常情况下,我们会使用WebApi对外提供数据接口服务,如果我们想在WebApi中使用gRPC该怎么做呢?

4.1、新建http://ASP.NET Core Web 应用

Quber.Grpc.Web

4.2、添加Grpc.AspNetCore包

Grpc.AspNetCore

4.3、添加Proto文件

Quber.Grpc.Service

需要注意的是:复制过来后,需要在Web项目的配置中添加如下节点配置,如果已经有了请忽略:

Quber.Grpc.Webobj\Debug\net6.0\Protos

4.4、添加Services服务

Quber.Grpc.Service

4.5、注册gRPC服务

在启动文件中,我们需要注册gRPC服务和UserService服务,如下图所示:

到此,在Web项目中添加gRPC就完成了。

4.6、验证服务

Quber.Grpc.Web
Quber.Grpc.ClientQuber.Grpc.Client

这样,我们就成功的使用Web项目对外提供WebApi数据接口服务,同时又对内提供了gRPC服务。