先看一下成品效果:
前言
平时大家写完 gRPC
接口后是如何测试的?往往有以下几个方法:
- 写单测代码,自己模拟客户端测试。
- 可以搭一个
gRPC-Gateway
服务,这样就可以在postman
中进行模拟。
但这两种方法都不是特别优雅;第一种方法当请求结构体嵌套特别复杂时,在代码中维护起来就不是很直观;而且代码会特别长。
第二种方法在 postman 中与请求 HTTP 接口一样,看起来非常直观;但需要额为维护一个 gRPC-Gateway
服务,同时接口定义发生变化时也得重新发布,使用起来稍显复杂。
于是我经过一番搜索找到了两个看起来还不错的工具:
- BloomRPC
- https://github.com/fullstorydev/grpcui
首先看 BloomRPC
页面美观,功能也很完善;但却有个非常难受的地方,那就是不支持 int64
数据的请求, 会有精度问题。
代码语言:javascript复制这里我写了一个简单的接口,直接将请求的
int64
返回回来。
func (o *Order) Create(ctx context.Context, in *v1.OrderApiCreate) (*v1.Order, error) {
fmt.Println(in.OrderId)
return &v1.Order{
OrderId: in.OrderId,
Reason: nil,
}, nil
}
会发现服务端收到的数据精度已经丢失了。
这个在我们大量使用 int64
的业务中非常难受,大部分接口都没法用了。
grpcui
是我在使用了 BloomRPC
一段时间之后才发现的工具,功能也比较完善; BloomRPC
中的精度问题也不存在。
但由于我之前已经习惯了在 BloomRPC
中去调试接口,加上日常开发过程中我的浏览器几乎都是开了几十个 tap 页面,导致在其中找到 grpcui
不是那么方便。
所以我就想着能不能有一个类似于 BloomRPC
的独立 APP,也支持 int64
的工具。
准备
找了一圈,貌似没有发现。恰好前段时间写了一个 gRPC
的压测工具,其实已经把该 APP 需要的核心功能也就是泛化调用实现了。
由于核心能力是用 Go 实现的,所以这个 APP 最好也是用 Go 来写,这样复用代码会更方便一些;正好也想看看用 Go 来实现 GUI 应用效果如何。
但可惜 Go 并没有提供原生的 GUI 库支持,最后翻来找去发现了一个库:fyne
从 star
上看用的比较多,同时也支持跨平台打包;所以最终就决定使用该库在构建这个应用。
核心功能
整个 App 的交互流程我参考了 BloomRPC
,但作为一个不懂审美、设计的后端开发来说,整个过程中最难的就是布局了。
这是我花了好几个晚上调试出来的第一版页面,虽然也能用但查看请求和响应数据非常不方便。
于是又花了一个周末最终版如下(乍一看貌似没区别):
虽然页面上与 BloomRPC
还有一定差距,但也不影响使用;关键是 int64
的问题解决了;又可以愉快的撸码了。
安装
有类似需求也想体验的朋友可以在这里下载使用:https://github.com/crossoverJie/ptg/releases/download/0.0.2/ptg-mac-gui.tar
由于我手上暂时没有 Windows
电脑,所以就没有打包 exe 程序;有相关需求的朋友可以自行下载源码编译:
git clone git@github.com:crossoverJie/ptg.git
cd ptg
make pkg-win
后续计划
当前版本的功能还比较简陋,只支持常用的 unary
调用;后续也会逐步加上 stream
、metadata
、工作空间的存储与还原等支持。
对页面、交互有建议也欢迎提出。
原本是准备上传到
brew
方便安装的,结果折腾了一晚上因为数据不够被拒了,所以对大家有帮助或者感兴趣的话帮忙点点关注(咋有种直播带货的感觉