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

简介

gRPC 是由 Google 开发的一种高性能、开源的远程过程调用(RPC)框架。它使用 Protocol Buffers 作为数据交换格式，可以在多种语言之间进行通信。在 .NET Core 3.0 中，我们可以通过 gRPC 快速建立一个高效的微服务。

快速入门

创建 gRPC 服务

我们可以使用 Visual Studio 2019 或者 .NET Core CLI 创建一个 gRPC 服务。

使用 Visual Studio 2019：

1. 新建项目
2. 选择“ASP.NET Core Web 应用程序”
3. 选择“gRPC Service”模板
4. 点击“创建”

使用 .NET Core CLI：

dotnet new grpc

定义服务

定义服务的步骤包括创建协议缓冲区文件、定义服务契约和类型以及实现服务逻辑。

在 Visual Studio 中，可以使用 Visual Studio 的添加新项功能来创建协议缓冲区文件。

使用 .NET Core CLI：

1. 创建一个叫做“Protos”的文件夹

mkdir Protos

1. 在“Protos”文件夹中创建一个名为“greeter.proto”的文件

touch Protos/greeter.proto

1. 使用 Protocol Buffers 定义您的服务协议（greeter.proto）：

syntax = "proto3";

option csharp_namespace = "GrpcGreeterDemo";

package greeter;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply);
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

定义的协议文件中，定义了一个叫 Greeter 的服务，它有一个叫 SayHello 的方法，接收一个 HelloRequest 的参数，并返回一个 HelloReply。

实现服务

实现服务的步骤包括在 ASP.NET Core 应用程序中注册服务和实现服务的类。

在 Visual Studio 中，可以打开“Startup.cs”文件并注册服务：

public void ConfigureServices(IServiceCollection services)
{
    services.AddGrpc();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapGrpcService<GreeterService>();
    });
}

这里，我们通过调用 AddGrpc 方法向应用程序中添加 gRPC 服务，并在 Configure 方法中将 gRPC 服务映射到应用程序中。

接下来，我们需要实现服务的类。

public class GreeterService : Greeter.GreeterBase
{
    public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
    {
        return Task.FromResult(new HelloReply
        {
            Message = "Hello " + request.Name
        });
    }
}

这里我们创建了一个继承自 Greeter 类的服务类，覆盖了其 SayHello 方法。

客户端请求

我们可以用任何支持 gRPC 的客户端去向服务发送请求。可以通过 Visual Studio 或 .NET Core CLI 创建一个控制台应用程序来充当客户端。

使用 .NET Core CLI 创建客户端应用程序：

dotnet new console -n GreeterClient

然后在 Program.cs 文件中：

static async Task Main(string[] args)
{
    var channel = GrpcChannel.ForAddress("https://localhost:5001");
    var client = new Greeter.GreeterClient(channel);
    var reply = await client.SayHelloAsync(
                      new HelloRequest { Name = "GreeterClient" });
    Console.WriteLine("Greeter client received: " + reply.Message);
    Console.ReadKey();
}

这里我们使用 gRPC 通道（gRPC Channel）到服务发起调用，并显示响应消息。

基于熟悉的 WCF 服务合同模型来实现 gRPC 服务和客户端

在 .NET Core 3.0 之前，WCF 是一种常用的 .NET 远程调用框架，而 gRPC 则为跨语言的 RPC 设计。使用 .NET Core 3.0，我们现在可以在代码库中同时使用 WCF 和 gRPC。

我们可以通过以下步骤将 WCF 服务转换为 gRPC：

1. 创建 .proto 文件并定义 gRPC 服务协议
2. 使用 proto 文件生成 C# 文件
3. 实现服务类并将其公开为 gRPC 服务
4. 在应用程序中使用 gRPC 配置设置来添加 gRPC 服务

在 Visual Studio 中，可以使用 Visual Studio 的“添加服务引用”功能将 WCF 服务引用到您的 gRPC 服务项目中。WCF 服务的服务契约将自动转换为 proto 文件。

现在，我们可以通过以下步骤创建一个相对完整的范例：

1. 创建 WCF 服务，并从中引用服务契约
2. 使用 Visual Studio 将服务契约转换为 proto 文件
3. 创建 gRPC 服务，并从转换后的 proto 文件生成 C# 文件，并将生成的代码添加到服务项目中
4. 创建公共业务逻辑并在 WCF 服务及其实现和 gRPC 服务中共享
5. 实现新的 gRPC 服务端点，以便将我们的新 gRPC 服务添加到现有 WCF + REST 服务中。

最后，我们可以编写一个客户端应用程序，以使用新的 gRPC 服务。

以上是使用 ASP.NET Core 3.0 进行 gRPC 开发的基础教程和范例，如有需要可自行深入探索。