其他

.NET8中gRPC的使用方法详解

悠悠楠杉

2025-06-08

0 评论

2 阅读

正在检测是否收录...

06/08

一、项目设置与工具安装

首先，确保您的机器上已安装 .NET 8 SDK 和必要的 NuGet 包管理器。接下来，创建一个新的 .NET 8 控制台应用程序作为 gRPC 服务端项目，并添加 gRPC 服务框架支持：

bash dotnet new console -n GrpcServer -o GrpcServer cd GrpcServer dotnet add package Grpc --version=2.41.0-preview1 # 根据最新稳定版调整版本号 dotnet add package Google.Protobuf --version=3.20.0-beta01 # 根据最新稳定版调整版本号

二、定义服务原型（.proto 文件）

在项目中创建一个 .proto 文件来定义 gRPC 服务。例如，创建一个 helloworld.proto 文件：

```protobuf
syntax = "proto3";
option csharp_namespace = "GrpcServer.Services";
package helloworld;

// 服务定义
service Greeter {
// 单个请求的 RPC 方法
rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// 请求消息定义
message HelloRequest {
string name = 1;
}
// 响应消息定义
message HelloReply {
string message = 1;
}
使用 `protoc` 工具和 C# 插件生成 C# 代码：bash
protoc -I=. --csharpout=. --grpcout=. --plugin=protoc-gen-grpc=which grpc_csharp_plugin helloworld.proto
```

三、实现服务端逻辑

在 C# 项目中实现定义的服务：
```csharp
using Grpc.Core;
using GrpcServer.Services; // 从 proto 文件生成的服务接口和消息类所在的命名空间
using System.Threading.Tasks;
using static GrpcServer.Services.Greeter; // 使用生成的 Greeter 实现类和服务定义静态类简化代码编写过程。
public class GreeterService : GreeterBase { // 实现 Greeter 服务接口的基类 GreeterBase 中已经包含了必要的抽象方法定义。 // 实现 SayHello 方法 public override Task SayHello(HelloRequest request, ServerCallContext context) { return Task.FromResult(new HelloReply { Message = $"Hello, {request.Name}!" }); } } // 将服务注册到 gRPC 服务器 void StartServer() { var server = new Server { Services = { Greeter.BindService(new GreeterService()) }, Ports = { new ServerPort("localhost", 50051, ServerCredentials.Insecure) } }; server.Start(); Console.WriteLine("Server listening on port 50051..."); } // 在 Main 方法中启动服务器 static void Main(string[] args) { StartServer().Wait(); } } } // 注意：确保添加必要的 using 指令以引用 System.Threading.Tasks 和其他必要的命名空间。