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<GreeterService>();
app.Run();
public class GreeterService : Greeter.GreeterBase
{
public override Task<HelloReply> 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 协议等。