工作中你会使用到 grpcurl 吗?
在平时的开发过程中,我们一般是 http 接口对外, grpc 接口对内部微服务
相信对于如何去请求 http 接口,大家都很熟悉了
- 如果是 inux 里面使用 curl 命令
- 在 windows 里面我们可以使用 postman 来请求接口
- 如果对于一个云上开发的接口的话,我们可能会使用 apifox 来进行请求
那么对于 grpc 服务端提供的接口,我们一般会如何去请求这些接口来自测呢
- Windows 里面我们可以使用 bloomRPC 工具
- Linux 里面我们可以使用 grpcurl 工具
DEMO
关于 grpc 的基本知识,感兴趣的可以查看历史文章:
那么我们写一个 demo,一个 grpc 的服务端,提供如下接口
- 查询租户的详情
- 查询租户的列表
Demo 目录结构如下:
咱们的 proto 文件可以是这样的:
protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative tenant.proto
基本简单的代码实现如下:
rpc_services.go 代码如下
这个时候启动咱们的服务端,如何运行 golang 程序就不赘述了
bloomRPC 工具
开始来下载 bloomRPC 工具
对于 bloomRPC 工具,我们可以在这个地址里面去下载,自由选择:
下载安装之后,我们可以看到 bloomRPC 是如下这个界面,非常清爽
导入咱们的 tenant.proto 文件后,可以看到咱们服务端提供的如下两个接口:
- get_tenant_detail
- get_tenant_list
这个时候,咱们就可以使用 bloomRPC 工具,请求咱们服务端的接口了,效果如下:
获取租户详情
获取租户列表
Windows 的工具比较简单,我们来看看 linux 里面的 grpcurl 工具
grpcurl 工具
grpcurl 是linux 里面与grpc服务器交互的命令行工具,咱们就可以理解是 curl 工具的 grpc 版本
使用 grpcurl 工具,我们需要在咱们的代码实现中给我们的 grpc 服务端注册一下 reflection
- 先来看看 grpcurl 工具的安装
go get github.com/fullstorydev/grpcurl
go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest
- 然后在我们上述的 rpc_services.go 代码中,注册 reflection
- 效果验证
这个时候,咱们将上述的 rpc_tool_demo 整个项目放到 linux 中进行运行,启动服务端,当然我的 demo 中 grpc 服务端监听的是 8888 端口,如果咱们 linux 环境这个端口已经被占用了,可以自行更换端口
以本 demo 为例
查看服务列表
grpcurl -plaintext localhost:8899 list
查看指定服务的接口列表
grpcurl -plaintext localhost:8899 list tenant.Tenant
查看某一个 rpc 接口的实际情况
grpcurl -plaintext localhost:8899 describe tenant.Tenant.get_tenant_detail
查看具体某一个结构体的详情
grpcurl -plaintext localhost:8899 describe .tenant.TenantDetailRsp
使用 grpcurl 请求 grpc 服务端的接口
对于 grpcurl 的其他奇淫巧技可以查看帮助清单
grpcurl -h
如果需要查看 demo 源码,可以进入地址:https://github.com/qingconglaixueit/rpc_tool_demo
至此,本篇内容结束
【欢迎查看历史文章】
感谢阅读,欢迎交流,点个赞,关注一波 再走吧
欢迎点赞,关注,收藏
朋友们,你的支持和鼓励,是我坚持分享,提高质量的动力
好了,本次就到这里
技术是开放的,我们的心态,更应是开放的。拥抱变化,向阳而生,努力向前行。
我是阿兵云原生,欢迎点赞关注收藏,下次见~