.NET gRPC

NET gRPC 通常包括以下步骤,用于创建一个简单的gRPC服务及客户端。下面是一个简化的流程:

定义服务接口和消息类型

创建一个 .proto 文件来定义你的服务方法以及它们所使用的请求和响应消息类型。例如,在 helloworld.proto 文件中:

syntax = "proto3";

package helloworld;

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

message HelloRequest {
    string name = 1;
}

message HelloReply {
    string message = 1;
}

生成C#代码

使用 Google 的 Protocol Buffers 编译器(protoc)配合 C# 插件(Grpc.Tools nuget包)将 .proto 文件编译为 C# 类。

在命令行中执行:

protoc -I . --csharp_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_csharp_plugin` helloworld.proto

创建 gRPC 服务

在 ASP.NET Core 应用中添加 gRPC 服务:

using Grpc.AspNetCore;
using Helloworld; // 这是从 .proto 文件生成的命名空间

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddGrpc();

var app = builder.Build();
app.MapGrpcService();

app.Run();

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

创建 gRPC 客户端

在客户端项目中引用 Grpc.Net.Client,并使用生成的客户端类与服务进行交互

using Grpc.Net.Client;
using Helloworld;

class Program
{
    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 = "World" });

        Console.WriteLine(reply.Message);  // 输出:Hello World
    }
}

以上就是一个基本的 .NET gRPC 入门示例,展示了如何从零开始创建一个简单的 gRPC 服务及其客户端。记得在实际项目中正确配置应用以支持 gRPC,包括设置 Kestrel 服务器以启用 HTTP/2 协议等。

你可能感兴趣的:(.net)