.NET Core中gRPC的使用示例

gRPC 是一种高性能的远程过程调用（RPC）框架，基于 HTTP/2 和 Protobuf 进行通信，广泛应用于微服务架构中。相较于传统的 REST API，gRPC 具有更高的性能、支持双向流通信，并提供强类型的接口定义。

在 .NET Core 中，gRPC 由官方提供支持，并可以轻松集成到 ASP.NET Core 应用中。本文将介绍如何在 .NET Core 中创建和使用 gRPC 服务，包括服务端和客户端的实现。

创建 gRPC 服务

在 .NET Core 中，首先需要创建一个 gRPC 服务项目。在终端或 Visual Studio 中执行以下命令来创建 gRPC 服务：

dotnet new grpc -n GrpcDemo
cd GrpcDemo
dotnet run

也可以直接通过Visual Studio来创建gRPC服务：

.NET Core中gRPC的使用示例

此时，项目会生成一个默认的 gRPC 服务，其中 Protos 目录下包含 greet.proto 文件。这个 .proto 文件定义了 gRPC 服务的接口：

syntax = "proto3";

option csharp_namespace = "GrpcDemo";

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

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

这个服务定义了 SayHello 方法，接受 HelloRequest，返回 HelloReply。在构建项目时，.NET 会根据 .proto 文件自动生成 C# 代码，供服务端和客户端使用。

在 Services 目录下的 GreeterService.cs 文件中，实现 gRPC 方法逻辑：

public class GreeterService : Greeter.GreeterBase
{
    private readonly ILogger<GreeterService> _logger;
    public GreeterService(ILogger<GreeterService> logger)
    {
        _logger = logger;
    }

    public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
    {
        return Task.FromResult(new HelloReply
        {
            Message = $"Hello, {request.Name}"
        });
    }
}

然后，在 Program.cs 中配置 gRPC 服务：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddGrpc();

var app = builder.Build();

app.MapGrpcService<GreeterService>();

app.MapGet("/", () => "gRPC service is running.");

app.Run();

启动项目后，gRPC 服务器将运行在默认端口 https://localhost:5001 上。

创建 gRPC 客户端

客户端可以是任何 .NET Core 应用，如控制台应用程序。在终端执行以下命令创建一个新项目：

dotnet new console -n GrpcClient
cd GrpcClient
dotnet add package Grpc.Net.Client
dotnet add package Google.Protobuf
dotnet add package Grpc.Tools

然后，在 GrpcClient.csproj 中添加对 .proto 文件的引用，以便生成相应的客户端代码：

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

在 Program.cs 中，初始化 gRPC 客户端并调用远程方法：

using System;
using System.Threading.Tasks;
using Grpc.Net.Client;
using GrpcDemo;

class Program
{
    static async Task Main(string[] args)
    {
        using var channel = GrpcChannel.ForAddress("https://localhost:5001");
        var client = new Greeter.GreeterClient(channel);

        var reply = await client.SayHelloAsync(new HelloRequest { Name = "Alice" });

        Console.WriteLine(reply.Message);
    }
}

运行客户端后，控制台将输出 Hello, Alice，表示 gRPC 远程调用成功。

总结

在 .NET Core 中，gRPC 提供了一种高效、强类型的远程调用方式，适用于微服务架构。使用 gRPC 需要定义 .proto 文件，并在服务器端实现方法，在客户端调用远程方法。相较于传统的 REST API，gRPC 具有更高的性能，并支持流式数据通信，在高吞吐量场景下具有明显优势。