asp.netcore的服务注册在ASP.NETCore

导读在本文中，你将了解创建gRPC服务器。创建gRPC客户端。使用gRPCGreeter服务测试gRPC客户端服务。先决条件具有“ASP.NET和Web开发”工....

在本文中，你将了解

• 创建 gRPC 服务器。
• 创建 gRPC 客户端。
• 使用 gRPC Greeter 服务测试 gRPC 客户端服务。

先决条件

• 具有“ASP.NET 和 Web 开发”工作负载的 Visual Studio 2019 16.4 或更高版本
• .NET Core 3.1 SDK

创建 gRPC 服务

• 启动 Visual Studio 并选择“创建新项目”。 或者，从 Visual Studio“文件”菜单中选择“新建” > “项目” 。

• 在“创建新项目”对话框中，选择“gRPC 服务”，然后选择“下一步” ：
• 将项目命名为 GrpcGreeter。 将项目命名为“GrpcGreeter”非常重要，这样在复制和粘贴代码时命名空间就会匹配。
• 选择“创建”。
• 在“创建新 gRPC 服务”对话框中：选择“gRPC 服务”模板。选择“创建”。

运行服务

• 按 Ctrl F5 以在不使用调试程序的情况下运行。如果尚未将项目配置为使用 SSL，Visual Studio 显示以下对话：

• 如果信任 IIS Express SSL 证书，请选择“是”。将显示以下对话框：

• 如果你同意信任开发证书，请选择“是”。
• Visual Studio 启动 IIS Express 并运行应用。 地址栏显示 Localhost:port#，而不是显示 example.com。 这是因为 localhost 是本地计算机的标准主机名。 Localhost 仅为来自本地计算机的 Web 请求提供服务。 Visual Studio 创建 Web 项目时，Web 服务器使用的是随机端口。

日志显示该服务正在侦听 HTTPS://localhost:5001。

控制台

info: Microsoft.Hosting.Lifetime[0] Now listening on: https://localhost:5001info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl C to shut down.info: Microsoft.Hosting.Lifetime[0] Hosting environment: Development

备注

gRPC 模板配置为使用传输层安全性 (TLS)。 gRPC 客户端需要使用 HTTPS 调用服务器。

macOS 不支持 ASP.NET Core gRPC 及 TLS。 在 macOS 上成功运行 gRPC 服务需要其他配置。 有关详细信息，请参阅无法在 macOS 上启用 ASP.NET Core gRPC 应用。

检查项目文件

GrpcGreeter 项目文件：

• greet.proto：Protos/greet.proto 文件定义 Greeter gRPC，且用于生成 gRPC 服务器资产。 有关详细信息，请参阅 gRPC 介绍。
• Services 文件夹：包含 Greeter 服务的实现。
• appSettings.json：包含配置数据，如 Kestrel 使用的协议。
• Program.cs:包含 gRPC 服务的入口点。
• Startup.cs：包含配置应用行为的代码。

在 .NET 控制台应用中创建 gRPC 客户端

• 打开 Visual Studio 的第二个实例并选择“创建新项目”。
• 在“创建新项目”对话框中，选择“控制台应用(.NET Core)”，然后选择“下一步” 。
• 在“项目名称”文本框中，输入“GrpcGreeterClient”，然后选择“创建” 。

添加所需的包

gRPC 客户端项目需要以下包：

• Grpc.Net.Client，其中包含 .NET Core 客户端。
• Google.Protobuf 包含适用于 C# 的 Protobuf 消息。
• Grpc.Tools 包含适用于 Protobuf 文件的 C# 工具支持。 运行时不需要工具包，因此依赖项标记为 PrivateAssets="All"。

通过包管理器控制台 (PMC) 或管理 NuGet 包来安装包。

用于安装包的 PMC 选项

• 从 Visual Studio 中，依次选择“工具”>“NuGet 包管理器”>“包管理器控制台”
• 从“包管理器控制台”窗口中，运行 cd GrpcGreeterClient 以将目录更改为包含 GrpcGreeterClient.csproj 文件的文件夹。
• 运行以下命令：PowerShell复制Install-Package Grpc.Net.Client Install-Package Google.Protobuf Install-Package Grpc.Tools

管理 NuGet 包选项以安装包

• 在“解决方案资源管理器”>“管理 NuGet 包”中，右键单击该项目 。
• 选择“浏览”选项卡。
• 在搜索框中输入 Grpc.Net.Client。
• 从“浏览”选项卡中选择“Grpc.Net.Client”包，然后选择“安装” 。
• 为 Google.Protobuf 和 Grpc.Tools 重复这些步骤。

添加 greet.proto

• 在 gRPC 客户端项目中创建 Protos 文件夹。
• 从 gRPC Greeter 服务将 Protos\greet.proto 文件复制到 gRPC 客户端项目中的 Protos 文件夹 。
• 将 greet.proto 文件中的命名空间更新为项目的命名空间：复制option csharp_namespace = "GrpcGreeterClient";
• 编辑 GrpcGreeterClient.csproj 项目文件：右键单击项目，并选择“编辑项目文件”。
• 添加具有引用 greet.proto 文件的 <Protobuf> 元素的项组

XML

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

创建 Greeter 客户端

构建客户端项目，以在 GrpcGreeter 命名空间中创建类型。 GrpcGreeter 类型是由生成进程自动生成的。

使用以下代码更新 gRPC 客户端的 Program.cs 文件：

C#

using System;using System.Net.Http;using System.Threading.Tasks;using Grpc.Net.Client;namespace GrpcGreeterClient{ class Program { static async Task Main(string[] args) { // The port number(5001) must match the port of the gRPC server. using var channel = GrpcChannel.ForAddress("https://localhost:5001"); var client = new Greeter.GreeterClient(channel); var reply = await client.SayHelloAsync( new HelloRequest { Name = "GreeterClient" }); Console.WriteLine("Greeting: " reply.Message); Console.WriteLine("Press any key to exit..."); Console.ReadKey(); } }

Program.cs 包含 gRPC 客户端的入口点和逻辑。

通过以下方式创建 Greeter 客户端：

• 实例化 GrpcChannel，使其包含用于创建到 gRPC 服务的连接的信息。
• 使用 GrpcChannel 构造 Greeter 客户端：

C#

static async Task Main(string[] args){ // The port number(5001) must match the port of the gRPC server. using var channel = GrpcChannel.ForAddress("https://localhost:5001"); var client = new Greeter.GreeterClient(channel); var reply = await client.SayHelloAsync( new HelloRequest { Name = "GreeterClient" }); Console.WriteLine("Greeting: " reply.Message); Console.WriteLine("Press any key to exit..."); Console.ReadKey();}

Greeter 客户端会调用异步 SayHello 方法。 随即显示 SayHello 调用的结果：

C#

static async Task Main(string[] args){ // The port number(5001) must match the port of the gRPC server. using var channel = GrpcChannel.ForAddress("https://localhost:5001"); var client = new Greeter.GreeterClient(channel); var reply = await client.SayHelloAsync( new HelloRequest { Name = "GreeterClient" }); Console.WriteLine("Greeting: " reply.Message); Console.WriteLine("Press any key to exit..."); Console.ReadKey();

使用 gRPC Greeter 服务测试 gRPC 客户端

• 在 Greeter 服务中，按 Ctrl F5 在不使用调试程序的情况下启动服务器。
• 在 GrpcGreeterClient 项目中，按 Ctrl F5 在不使用调试程序的情况下启动客户端。

gRPC 服务在写入命令提示符的日志中记录成功调用的详细信息：

控制台

info: Microsoft.Hosting.Lifetime[0] Now listening on: https://localhost:5001info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl C to shut down.info: Microsoft.Hosting.Lifetime[0] Hosting environment: Developmentinfo: Microsoft.Hosting.Lifetime[0] Content root path: C:\GH\aspnet\docs\4\Docs\aspnetcore\tutorials\grpc\grpc-start\sample\GrpcGreeterinfo: Microsoft.AspNetCore.Hosting.Diagnostics[1] Request starting HTTP/2 POST https://localhost:5001/Greet.Greeter/SayHello application/grpcinfo: Microsoft.AspNetCore.Routing.EndpointMiddleware[0] Executing endpoint gRPC - /Greet.Greeter/SayHelloinfo: Microsoft.AspNetCore.Routing.EndpointMiddleware[1] Executed endpoint gRPC - /Greet.Greeter/SayHelloinfo: Microsoft.AspNetCore.Hosting.Diagnostics[2] Request finished in 78.32260000000001ms 200 application/grpc

备注

本文中的代码需要 ASP.NET Core HTTPS 开发证书来保护 gRPC 服务。 如果 .NET gRPC 客户端失败并显示消息 The remote certificate is invalid according to the validation procedure. 或 The SSL connection could not be established.，则开发证书不受信任。 要解决此问题，请参阅使用不受信任/无效的证书调用 gRPC 服务。