grpcurl通過命令行訪問gRPC服務
前言
一般情況下測試 gRPC 服務，都是通過客戶端來直接請求服務端。如果客戶端還沒準備好的話，也可以使用 BloomRPC 這樣的 GUI 客戶端。
如果環(huán)境不支持安裝這種 GUI 客戶端的話，那么有沒有一種工具，類似于 curl 這樣的，直接通過終端，在命令行發(fā)起請求呢？
答案肯定是有的，就是本文要介紹的 grpcurl。
gRPC Server
首先來寫一個簡單的 gRPC Server：
helloworld.proto
syntax?=?"proto3";
package?proto;
//?The?greeting?service?definition.
service?Greeter?{
????//?Sends?a?greeting
????rpc?SayHello?(HelloRequest)?returns?(HelloReply)?{}
}
//?The?request?message?containing?the?user's?name.
message?HelloRequest?{
????string?name?=?1;
}
//?The?response?message?containing?the?greetings
message?HelloReply?{
????string?message?=?1;
}
main.go
package?main
import?(
????"context"
????"fmt"
????"grpc-hello/proto"
????"log"
????"net"
????"google.golang.org/grpc"
????"google.golang.org/grpc/reflection"
)
func?main()?{
????lis,?err?:=?net.Listen("tcp",?":50051")
????if?err?!=?nil?{
????????log.Fatalf("failed?to?listen:?%v",?err)
????}
????server?:=?grpc.NewServer()
????//?注冊?grpcurl?所需的?reflection?服務
????reflection.Register(server)
????//?注冊業(yè)務服務
????proto.RegisterGreeterServer(server,?&greeter{})
????fmt.Println("grpc?server?start?...")
????if?err?:=?server.Serve(lis);?err?!=?nil?{
????????log.Fatalf("failed?to?serve:?%v",?err)
????}
}
type?greeter?struct?{
}
func?(*greeter)?SayHello(ctx?context.Context,?req?*proto.HelloRequest)?(*proto.HelloReply,?error)?{
????fmt.Println(req)
????reply?:=?&proto.HelloReply{Message:?"hello"}
????return?reply,?nil
}
運行服務：
go?run?main.go server?start?...
grpcurl 安裝
這里我介紹三種方式：
Mac
brew?install?grpcurl
Docker
#?Download?image docker?pull?fullstorydev/grpcurl:latest #?Run?the?tool docker?run?fullstorydev/grpcurl?api.grpc.me:443?list
go tool
如果有 Go 環(huán)境的話，可以通過 go tool 來安裝：
go?install?github.com/fullstorydev/grpcurl/cmd/grpcurl@latest
grpcurl 使用
查看服務列表：
grpcurl?-plaintext?127.0.0.1:50051?list
輸出：
grpc.reflection.v1alpha.ServerReflection
proto.Greeter
查看某個服務的方法列表：
grpcurl?-plaintext?127.0.0.1:50051?list?proto.Greeter
輸出：
proto.Greeter.SayHello
查看方法定義：
grpcurl?-plaintext?127.0.0.1:50051?describe?proto.Greeter.SayHello
輸出：
proto.Greeter.SayHello is a method:
rpc SayHello ( .proto.HelloRequest ) returns ( .proto.HelloReply );
查看請求參數(shù)：
grpcurl?-plaintext?127.0.0.1:50051?describe?proto.HelloRequest
輸出：
proto.HelloRequest is a message:
message HelloRequest {
string name = 1;
}
請求服務：
grpcurl?-d?'{"name":?"zhangsan"}'?-plaintext?127.0.0.1:50051?proto.Greeter.SayHello
輸出：
{
"message": "hello"
}
可能遇到的錯誤
可能會遇到兩個報錯：
1、gRPC Server 未啟用 TLS：
報錯信息：
Failed?to?dial?target?host?"127.0.0.1:50051":?tls:?first?record?does?not?look?like?a?TLS?handshake
解決：
請求時增加參數(shù)：-plaintext，參考上面的命令。
2、參數(shù)格式錯誤：
報錯信息：
Error?invoking?method?"greet.Greeter/SayHello":?error?getting?request?data:?invalid?character?'n'?looking?for?beginning?of?object?key?string
解決：
-d 后面參數(shù)為 json 格式，并且需要使用 '' 包裹起來。
總結(jié)
用這個工具做一些簡單的測試還是相當方便的，上手也簡單。只要掌握文中提到的幾條命令，基本可以涵蓋大部分的測試需求了
擴展閱讀：
https://appimage.github.io/BloomRPC/
https://github.com/fullstorydev/grpcurl
源碼下載地址：https://github.com/yongxinz/gopher/tree/main/blog
以上就是grpcurl通過命令行訪問gRPC服務的詳細內(nèi)容，更多關(guān)于grpcurl命令行訪問gRPC服務的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
外觀是一種結(jié)構(gòu)型設計模式， 能為復雜系統(tǒng)、 程序庫或框架提供一個簡單 （但有限） 的接口，這篇文章就給大家詳細介紹一下Golang的外觀模式，文中有詳細的代碼示例，具有一定的參考價值,需要的朋友可以參考下2023-06-06
這篇文章主要為大家介紹了golang context接口類型方法詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2023-09-09
內(nèi)存溢出是指程序在申請內(nèi)存時，沒有足夠的內(nèi)存空間供其使用，簡單點說就是你要求分配的內(nèi)存超出了系統(tǒng)能給你的，系統(tǒng)不能滿足需求，于是產(chǎn)生溢出出現(xiàn)out of memory異常2022-12-12
Go語言Swagger實現(xiàn)為項目生成 API 文檔
Swagger 是一個基于 OpenAPI 規(guī)范設計的工具,用于為 RESTful API 生成交互式文檔,下面小編就來介紹一下如何在 Go 項目中集成 Swagger,特別是結(jié)合 Gin 框架生成 API 文檔2025-03-03
本文主要介紹了go語言使用jwt認證的實現(xiàn)，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-04-04
判斷一個文件是否存在是一個相當常見的需求,在golang中也有多種方案實現(xiàn)這一功能,下面就跟隨小編一起學習一下具體的實現(xiàn)方法吧2024-11-11
這篇文章主要給大家介紹了關(guān)于golang小游戲開發(fā)實戰(zhàn)之飛翔的小鳥的相關(guān)資料,,本文可以帶你你從零開始,一步一步的開發(fā)出這款小游戲,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2024-03-03
這篇文章主要給大家介紹了在Golang代碼中如何自動生成版本號的相關(guān)資料，文中通過示例代碼介紹的非常詳細，對大家具有一定的參考學習價值，需要的朋友們下面來一起看看吧。2017-07-07
go語言string轉(zhuǎn)結(jié)構(gòu)體的實現(xiàn)
本文主要介紹了go語言string轉(zhuǎn)結(jié)構(gòu)體的實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-03-03
在 Go 語言中也經(jīng)常會遇到操作文件的需求,下面這篇文章主要給大家介紹了關(guān)于Go讀取文件與寫入文件的三種方法操作,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2022-09-09