grpcurl通過(guò)命令行訪問(wèn)gRPC服務(wù)
前言
一般情況下測(cè)試 gRPC 服務(wù),都是通過(guò)客戶端來(lái)直接請(qǐng)求服務(wù)端。如果客戶端還沒(méi)準(zhǔn)備好的話,也可以使用 BloomRPC 這樣的 GUI 客戶端。
如果環(huán)境不支持安裝這種 GUI 客戶端的話,那么有沒(méi)有一種工具,類似于 curl
這樣的,直接通過(guò)終端,在命令行發(fā)起請(qǐng)求呢?
答案肯定是有的,就是本文要介紹的 grpcurl
。
gRPC Server
首先來(lái)寫一個(gè)簡(jiǎn)單的 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() ????//?注冊(cè)?grpcurl?所需的?reflection?服務(wù) ????reflection.Register(server) ????//?注冊(cè)業(yè)務(wù)服務(wù) ????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 }
運(yùn)行服務(wù):
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)境的話,可以通過(guò) go tool 來(lái)安裝:
go?install?github.com/fullstorydev/grpcurl/cmd/grpcurl@latest
grpcurl 使用
查看服務(wù)列表:
grpcurl?-plaintext?127.0.0.1:50051?list
輸出:
grpc.reflection.v1alpha.ServerReflection
proto.Greeter
查看某個(gè)服務(wù)的方法列表:
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 );
查看請(qǐng)求參數(shù):
grpcurl?-plaintext?127.0.0.1:50051?describe?proto.HelloRequest
輸出:
proto.HelloRequest is a message:
message HelloRequest {
string name = 1;
}
請(qǐng)求服務(wù):
grpcurl?-d?'{"name":?"zhangsan"}'?-plaintext?127.0.0.1:50051?proto.Greeter.SayHello
輸出:
{
"message": "hello"
}
可能遇到的錯(cuò)誤
可能會(huì)遇到兩個(gè)報(bào)錯(cuò):
1、gRPC Server 未啟用 TLS:
報(bào)錯(cuò)信息:
Failed?to?dial?target?host?"127.0.0.1:50051":?tls:?first?record?does?not?look?like?a?TLS?handshake
解決:
請(qǐng)求時(shí)增加參數(shù):-plaintext
,參考上面的命令。
2、參數(shù)格式錯(cuò)誤:
報(bào)錯(cuò)信息:
Error?invoking?method?"greet.Greeter/SayHello":?error?getting?request?data:?invalid?character?'n'?looking?for?beginning?of?object?key?string
解決:
-d
后面參數(shù)為 json 格式,并且需要使用 ''
包裹起來(lái)。
總結(jié)
用這個(gè)工具做一些簡(jiǎn)單的測(cè)試還是相當(dāng)方便的,上手也簡(jiǎn)單。只要掌握文中提到的幾條命令,基本可以涵蓋大部分的測(cè)試需求了
擴(kuò)展閱讀:
https://appimage.github.io/BloomRPC/
https://github.com/fullstorydev/grpcurl
源碼下載地址:https://github.com/yongxinz/gopher/tree/main/blog
以上就是grpcurl通過(guò)命令行訪問(wèn)gRPC服務(wù)的詳細(xì)內(nèi)容,更多關(guān)于grpcurl命令行訪問(wèn)gRPC服務(wù)的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
淺析Go語(yǔ)言bitset的實(shí)現(xiàn)原理
bitset包是一個(gè)將非負(fù)整數(shù)映射到布爾值的位的集合,這篇文章主要通過(guò)開(kāi)源包bitset來(lái)為大家分析一下位集合的設(shè)計(jì)和實(shí)現(xiàn),感興趣的可以學(xué)習(xí)一下2023-08-08Go語(yǔ)言實(shí)現(xiàn)冒泡排序、選擇排序、快速排序及插入排序的方法
這篇文章主要介紹了Go語(yǔ)言實(shí)現(xiàn)冒泡排序、選擇排序、快速排序及插入排序的方法,以實(shí)例形式詳細(xì)分析了幾種常見(jiàn)的排序技巧與實(shí)現(xiàn)方法,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2015-02-02go語(yǔ)言調(diào)用其他包中的函數(shù)簡(jiǎn)單示例
這篇文章主要給大家介紹了關(guān)于go語(yǔ)言調(diào)用其他包中的函數(shù)的相關(guān)資料,文中還介紹了Go語(yǔ)言同一個(gè)包中不同文件之間函數(shù)調(diào)用的相關(guān)問(wèn)題,需要的朋友可以參考下2023-01-01Golang的Crypto/SHA256庫(kù)實(shí)戰(zhàn)指南
無(wú)論是在保護(hù)數(shù)據(jù)安全、驗(yàn)證數(shù)據(jù)完整性,還是在構(gòu)建復(fù)雜的安全系統(tǒng)中,crypto/sha256都是Golang程序員不可或缺的工具,本文主要介紹了Golang的Crypto/SHA256庫(kù)實(shí)戰(zhàn)指南,感興趣的可以了解一下2024-02-02Golang設(shè)計(jì)模式之適配器模式詳細(xì)講解
這篇文章主要介紹了使用go實(shí)現(xiàn)適配器模式,這個(gè)模式就是用來(lái)做適配的,它將不兼容的接口轉(zhuǎn)換為可兼容的接口,讓原本由于接口不兼容而不能一起工作的類可以一起工作,需要的朋友可以參考下2023-01-01Go語(yǔ)言Goroutines?泄漏場(chǎng)景與防治解決分析
這篇文章主要為大家介紹了Go語(yǔ)言Goroutines?泄漏場(chǎng)景與防治解決分析,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-12-12