ASP.NET Core 3.0使用gRPC的具体方法

gRPC 是一个由Google开源的,跨语言的,高性能的远程过程调用(RPC)框架。 gRPC使客户端和服务端应用程序可以透明地进行通信,并简化了连接系统的构建。它使用HTTP/2作为通信协议,使用 Protocol Buffers 作为序列化协议。

它的主要优点:

现代高性能轻量级 RPC 框架。

约定优先的 API 开发,默认使用 Protocol Buffers 作为描述语言,允许与语言无关的实现。

可用于多种语言的工具,以生成强类型的服务器和客户端。

支持客户端,服务器双向流调用。

通过Protocol Buffers二进制序列化减少网络使用。

使用 HTTP/2 进行传输

这些优点使gRPC非常适合:

高性能轻量级微服务 - gRPC设计为低延迟和高吞吐量通信,非常适合需要高性能的轻量级微服务。

多语言混合开发 - gRPC工具支持所有流行的开发语言,使gRPC成为多语言开发环境的理想选择。

点对点实时通信 - gRPC对双向流调用提供出色的支持。gRPC服务可以实时推送消息而无需轮询。

网络受限环境 - 使用 Protocol Buffers二进制序列化消息,该序列化始终小于等效的JSON消息,对网络带宽需求比JSON小

不建议使用gRPC的场景:

浏览器可访问的API - 浏览器不完全支持gRPC。虽然gRPC-Web可以提供浏览器支持,但是它有局限性,引入了服务器代理

广播实时通信 - gRPC支持通过流进行实时通信,但不存在向已注册连接广播消息的概念

进程间通信 - 进程必须承载HTTP/2才能接受传入的gRPC调用,对于Windows,进程间通信管道是一种更快速的方法。

摘自

支持的语言如下:

ASP.NET Core 3.0使用gRPC的具体方法

二.gRPC on .NET Core

gRPC 现在可以非常简单的在 .NET Core 和 ASP.NET Core 中使用,在 .NET Core 上的实现的开源地址:https://github.com/grpc/grpc-dotnet ,它目前由微软官方 ASP.NET 项目的人员进行维护,良好的接入 .NET Core 生态。

.NET Core 的 gRPC 功能如下:

三.使用 ASP.NET Core 创建 gRPC 服务

通过 Visual Studio 2019 (16.3.0)提供的模板,可以快速创建 gRPC 服务。

ASP.NET Core 3.0使用gRPC的具体方法

来扒拉一下默认源码包含了什么东东。

① 配置文件 appsettings.json ,多了Kestrel 启用 HTTP/2 的配置,因为 gRPC 是基于 HTTP/2 来通信的

ASP.NET Core 3.0使用gRPC的具体方法

② PB协议文件 greet.proto 用于自动生成服务、客户端和消息(表示传递的数据)的C# Class

ASP.NET Core 3.0使用gRPC的具体方法

③ 服务类 GreeterService ,服务类集成的 Greeter.GreeterBase 来自于根据proto文件自动生成的,生成的类在 obj\Debug\netcoreapp3.0目录下

ASP.NET Core 3.0使用gRPC的具体方法

自动生成的类:

ASP.NET Core 3.0使用gRPC的具体方法

④ Startup.cs类,将 gRPC服务添加到了终结点路由中

ASP.NET Core 3.0使用gRPC的具体方法

⑤ csproj 项目文件,包含了 proto 文件引用

ASP.NET Core 3.0使用gRPC的具体方法

2.运行

第一次运行会提示是否信任证书,点击“是”

ASP.NET Core 3.0使用gRPC的具体方法

ASP.NET Core 3.0使用gRPC的具体方法

这是因为HTTP/2需要HTTPS,尽管HTTP/2协议没有明确规定需要HTTPS,但是为了安全在浏览器实现上都要求了HTTPS,所以现在的HTTP/2和HTTPS基本都是一对。

ASP.NET Core 3.0使用gRPC的具体方法

四. 创建 gRPC 客户端

1.添加一个.NET Core 控制台应用程序

2.通过nuget添加包:Grpc.Net.Client、Google.Protobuf、Grpc.Tools

ASP.NET Core 3.0使用gRPC的具体方法

3.将服务的 proto 文件复制到客户端

ASP.NET Core 3.0使用gRPC的具体方法

4.编辑客户端项目文件,添加关于proto文件的描述

<ItemGroup> <Protobuf Include="Protos\greet.proto" GrpcServices="Client" /> </ItemGroup>

注意 GrpcServices="Client" 这里是Client和服务是不一样的

5.生成客户端项目可以通过proto文件生成类

6.添加客户端调用代码

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wdsydp.html