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 = "晓晨" }); Console.WriteLine("Greeter 服务返回数据: " + reply.Message); Console.ReadKey(); }
7.先启动服务,然后运行客户端
这里可以看到,客户端成功调用了服务,收到了返回的消息。
五.自己动手写一个服务
前面我们使用的 Greeter 服务是由模板自动给我们创建的,现在我们来自己动手写一个服务。
1.定义 proto 文件 LuCat.proto,并在csproj项目文件中添加描述
syntax = "proto3"; option csharp_namespace = "AspNetCoregRpcService"; import "google/protobuf/empty.proto"; package LuCat; //定义包名 //定义服务 service LuCat{ //定义吸猫方法 rpc SuckingCat(google.protobuf.Empty) returns(SuckingCatResult); } message SuckingCatResult{ string message=1; }
2.实现服务 LuCatService.cs
public class LuCatService:LuCat.LuCatBase { private static readonly List<string> Cats=new List<string>(){"英短银渐层","英短金渐层","美短","蓝猫","狸花猫","橘猫"}; private static readonly Random Rand=new Random(DateTime.Now.Millisecond); public override Task<SuckingCatResult> SuckingCat(Empty request, ServerCallContext context) { return Task.FromResult(new SuckingCatResult() { Message = $"您吸了一只{Cats[Rand.Next(0, Cats.Count)]}" }); } }
3.在 Startup终结点路由中注册
endpoints.MapGrpcService<LuCatService>();
4.添加客户端调用
var catClient = new LuCat.LuCatClient(channel); var catReply = await catClient.SuckingCatAsync(new Empty()); Console.WriteLine("调用撸猫服务:"+ catReply.Message);
5.运行测试
六.实际使用中的技巧
技巧1
上面章节的操作步骤中,我们需要在服务和客户端之间复制proto,这是一个可以省略掉的步骤。
1.复制 Protos 文件夹到解决方案根目录(sln文件所在目录)
2.删除客户端和服务项目中的 Protos 文件夹
3.在客户端项目文件csproj中添加关于proto文件的描述
<ItemGroup> <Protobuf Include="..\..\Protos\greet.proto" GrpcServices="Client" Link="Protos\greet.proto" /> </ItemGroup>
4.在服务项目文件csproj中添加关于proto文件的描述
<ItemGroup> <Protobuf Include="..\..\Protos\greet.proto" GrpcServices="Server" Link="Protos\greet.proto" /> </ItemGroup>
在实际项目中,请自己计算相对路径
5.这样两个项目都是使用的一个proto文件,只用维护这一个文件即可
技巧2
我们在实际项目中使用,肯定有多个 proto 文件,难道我们每添加一个 proto 文件都要去更新 csproj文件?
我们可以使用MSBuild变量来帮我们完成,我们将 csproj 项目文件中引入proto文件信息进行修改。
服务端:
<ItemGroup> <Protobuf Include="..\..\Protos\*.proto" GrpcServices="Server" Link="Protos\%(RecursiveDir)%(Filename)%(Extension)" /> </ItemGroup>
客户端:
<ItemGroup> <Protobuf Include="..\..\Protos\*.proto" GrpcServices="Client" Link="Protos\%(RecursiveDir)%(Filename)%(Extension)" /> </ItemGroup>
示例:
七.总结
gRPC 现目前是一款非常成熟的高性能RPC框架,当前的生态是非常好的,很多公司的产品或者开源项目都有在使用gRPC,有了它,相信可以让我们更容易的构建.NET Core 微服务,可以让 .NET Core 更好的接入 gRPC 生态。不得不说这是 .NET Core 3.0 带来的最令人振奋的特性之一。