概述
最近這段時間工做挺忙的,發現已經 3 周沒更文了...git
感謝大家還在,今天給你們分享一款 gRPC 的調試工具。github
進入正題。api
當咱們在寫 HTTP 接口的時候,使用的是 Postman
進行接口調試,那麼在寫 gRPC 接口的時候,有沒有相似於 Postman
的調試工具呢?瀏覽器
固然是有的 ~ 微信
我們一塊兒看下 grpcui
,源碼地址:app
https://github.com/fullstorydev/grpcui工具
看下官方描述:flex
grpcui is a command-line tool that lets you interact with gRPC servers via a browser. It's sort of like Postman, but for gRPC APIs instead of REST.ui
下面帶你們一塊兒用用...
寫一個 gRPC API
我原來寫過 Demo,能夠直接用原來寫的 listen 項目。spa
端口:9901
.proto
文件:
syntax = "proto3"; // 指定 proto 版本package listen; // 指定包名// 定義服務service Listen { // 定義方法 rpc ListenData(Request) returns (Response) {}}// Request 請求結構message Request { string name = 1;}// Response 響應結構message Response { string message = 1;}
很簡單,這個你們一看就知道了。
Service name 爲 listen.Listen
Method name 爲 ListenData
再看下 ListenData 方法:
func (l *ListenController) ListenData(ctx context.Context, in *listen.Request) (*listen.Response, error) { return &listen.Response{Message : fmt.Sprintf("[%s]", in.Name)}, nil}
這表示,將 Name
直接返回。
源碼地址:
https://github.com/xinliangnote/go-jaeger-demo/tree/master/listen
啓動服務
cd listen && go run main.go
服務啓動成功後,等待使用。
grpcui 使用
安裝
根據官方 README.md
文檔安裝便可。
go get github.com/fullstorydev/grpcuigo install github.com/fullstorydev/grpcui/cmd/grpcui
這時,在 $GOPATH/bin
目錄下,生成一個 grpcui
可執行文件。
執行個命令,驗證下:
grpcui -help
輸出:
Usage: grpcui [flags] [address]......
表示安裝成功了。
運行
grpcui -plaintext 127.0.0.1:9901Failed to compute set of methods to expose: server does not support the reflection API
這種狀況下,加個反射就能夠了,在 listen 的 main.go 新增以下代碼便可:
reflection.Register(s)
在運行一次試試:
grpcui -plaintext 127.0.0.1:9901gRPC Web UI available at http://127.0.0.1:63027/
表示運行成功了。
在瀏覽器中訪問:http://127.0.0.1:63027/
到這,咱們看到 Service name、Method name 都出來了,傳輸參數直接在頁面上進行操做便可。
當發起 Request "Tom",也能得到 Response 「Tom」。
固然,若是這個服務下面有多個 Service name,多個 Method name 也都會顯示出來的,去試試吧。
go-gin-api 系列文章
本文分享自微信公衆號 - 新亮筆記(XinLiangTalk)。
若有侵權,請聯繫 support@oschina.cn 刪除。
本文參與「OSC源創計劃」,歡迎正在閱讀的你也加入,一塊兒分享。