当前位置 博文首页 > SpringLeee:使用 gRPCurl 调试.NET 5的gPRC服务

    SpringLeee:使用 gRPCurl 调试.NET 5的gPRC服务

    作者:SpringLeee 时间:2021-01-30 18:12

    介绍

    你用过 Curl 吗?这个工具允许你通过 http 来发送数据,现在有一个适用于gGRPC的工具,gRPCurl,在本文中,我将介绍如何下载安装这个工具,然后通过这个工具调试我们.NET 5上面的gGRC程序。

    安装 gRPCurl

    gRPCurl 基于GO语言开发,所以,你要安装GO环境,可以在这里下载, https://golang.org/doc/install,它的安装非常简单,您只需要运行安装程序就可以了!

    安装完GO环境以后,还需要设置 Windows环境变量,然后使用管理员身份打开PowerShell,运行下边两个命令:

    go get github.com/fullstorydev/grpcurl/...
    
    go install github.com/fullstorydev/grpcurl/cmd/grpcurl
    

    如果安装成功,则可以通过运行以下的命令进行测试:

    grpcurl --help
    

    你应该在PowerShell窗口中看到以下内容:

    ASP.NET Core gRPC

    为了使gRPCurl有效,它需要了解gRPC消息和端点定义,有两种方法:反射。我将向您展示如何使用反射,因为这是.NET中最简单的方法,为了能够使用Reflection,使用以下命令安装:

    Install-Package Grpc.AspNetCore.Server.Reflection -Version 2.34.0
    

    然后,使用 services.AddGrpcReflection()和 endpoints.MapGrpcReflectionService()方法为ASP.NET Core gRPC应用程序配置, 第一个启用gRPC的反射,第二个是通过反射向gRPCurl提供示例端点和消息信息的端点:

    using CountryService.Web.Services;
    using Microsoft.AspNetCore.Builder;
    using Microsoft.AspNetCore.Hosting;
    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.Hosting;
    
    
    namespace CountryService.Web
    {
        public class Startup
        {
            public void ConfigureServices(IServiceCollection services)
            {
                services.AddGrpc();
                services.AddGrpcReflection();
                services.AddSingleton<CountryManagementService>();
            }
    
            public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
            {
                if (env.IsDevelopment())
                {
                    app.UseDeveloperExceptionPage();
                }
    
                app.UseRouting();
    
                app.UseEndpoints(endpoints =>
                {
                    endpoints.MapGrpcService<CountryGrpcService>();
    
                    endpoints.MapGrpcReflectionService();
                });
            }
        }
    }
    

    使用 gRPCurl

    通过运行以下命令列出所有可用的gRPC服务:

    grpccurl localhost:5001 list
    

    通过运行以下命令,列出指定gRPC服务的所有可用gRPC端点:

    grpccurl localhost:5001 list YourgRPCServiceFullName
    

    通过运行以下命令来调用一个获取列表的端点:

    grpcurl localhost:5001 gRPCDemo.v1.CountryService/GetAll
    

    通过运行一下命令,来获取一个元素,它需要传入JSON参数:

    grpcurl localhost:5001 -d 'JSON字符串' gRPCDemo.v1.CountryService/Get
    

    总结

    这是gRPCurl的简单教程, gRPCurl具有很多功能,如果您想了解更多信息, 我建议你可以在这里找到更多的api,https://github.com/fullstorydev/grpcurl

    原文作者: Anthony Giretti
    原文链接:https://anthonygiretti.com/2021/01/13/grpc-asp-net-core-5-test-grpc-endpoints-with-grpcurl/

    最后

    欢迎扫码关注我们的公众号 【全球技术精选】,专注国外优秀博客的翻译和开源项目分享,也可以添加QQ群 897216102

    bk
    下一篇:没有了