ASP.NET Core 3.0 使用gRPC
一.简介
gRPC 是一个由Google开源的,跨语言的,高性能的远程过程调用(RPC)框架。 gRPC使客户端和服务端应用程序可以透明地进行通信,并简化了连接系统的构建。它使用HTTP/2作为通信协议,使用 Protocol Buffers 作为序列化协议。
它的主要优点:
- 现代高性能轻量级 RPC 框架。
- 约定优先的 API 开发,默认使用 Protocol Buffers 作为描述语言,允许与语言无关的实现。
- 可用于多种语言的工具,以生成强类型的服务器和客户端。
- 支持客户端,服务器双向流调用。
- 通过Protocol Buffers二进制序列化减少网络使用。
- 使用 HTTP/2 进行传输
摘自微软官方文档
支持的语言如下:
二.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 功能如下:
- Grpc.AspNetCore 一个用于在ASP.NET Core承载gRPC服务的框架,将 gRPC和ASP.NET Core 功能集成在一起,如:日志、依赖注入、身份认证和授权。
- Grpc.Net.Client 基于HttpClient (HttpClient现已支持HTTP/2)的 gRPC客户端
- Grpc.Net.ClientFactory 与gRPC客户端集成的
HttpClientFactory
,允许对gRPC客户端进行集中配置,并使用DI注入到应用程序中
三.使用 ASP.NET Core 创建 gRPC 服务
- 通过 Visual Studio 2019 (16.3.0)提供的模板,可以快速创建 gRPC 服务。
来扒拉一下默认源码包含了什么东东。
① 配置文件
appsettings.json
,多了Kestrel 启用 HTTP/2 的配置,因为 gRPC 是基于 HTTP/2 来通信的② PB协议文件
greet.proto
用于自动生成服务、客户端和消息(表示传递的数据)的C# Class③ 服务类
GreeterService
,服务类集成的Greeter.GreeterBase
来自于根据proto文件自动生成的,生成的类在obj\Debug\netcoreapp3.0
目录下自动生成的类:
④
Startup.cs
类,将 gRPC服务添加到了终结点路由中⑤ csproj 项目文件,包含了 proto 文件引用
2.运行
第一次运行会提示是否信任证书,点击“是”
这是因为HTTP/2需要HTTPS,尽管HTTP/2协议没有明确规定需要HTTPS,但是为了安全在浏览器实现上都要求了HTTPS,所以现在的HTTP/2和HTTPS基本都是一对。
四. 创建 gRPC 客户端
1.添加一个.NET Core 控制台应用程序
2.通过nuget添加包:Grpc.Net.Client、Google.Protobuf、Grpc.Tools
3.将服务的 proto 文件复制到客户端
4.编辑客户端项目文件,添加关于proto文件的描述
<ItemGroup> <Protobuf Include="Protos\greet.proto" GrpcServices="Client" /> </ItemGroup>
注意
GrpcServices="Client"
这里是Client和服务是不一样的5.生成客户端项目可以通过proto文件生成类
6.添加客户端调用代码
static async Task