grpcurl通過命令行訪問gRPC服務(wù)
前言
一般情況下測(cè)試 gRPC 服務(wù)，都是通過客戶端來直接請(qǐng)求服務(wù)端。如果客戶端還沒準(zhǔn)備好的話，也可以使用 BloomRPC 這樣的 GUI 客戶端。
如果環(huán)境不支持安裝這種 GUI 客戶端的話，那么有沒有一種工具，類似于 curl 這樣的，直接通過終端，在命令行發(fā)起請(qǐng)求呢？
答案肯定是有的，就是本文要介紹的 grpcurl。
gRPC Server
首先來寫一個(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)境的話，可以通過 go tool 來安裝：
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 格式，并且需要使用 '' 包裹起來。
總結(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通過命令行訪問gRPC服務(wù)的詳細(xì)內(nèi)容，更多關(guān)于grpcurl命令行訪問gRPC服務(wù)的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Golang設(shè)計(jì)模式之外觀模式講解和代碼示例
外觀是一種結(jié)構(gòu)型設(shè)計(jì)模式， 能為復(fù)雜系統(tǒng)、 程序庫(kù)或框架提供一個(gè)簡(jiǎn)單 （但有限） 的接口，這篇文章就給大家詳細(xì)介紹一下Golang的外觀模式，文中有詳細(xì)的代碼示例，具有一定的參考價(jià)值,需要的朋友可以參考下2023-06-06
這篇文章主要為大家介紹了golang context接口類型方法詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-09-09
內(nèi)存溢出是指程序在申請(qǐng)內(nèi)存時(shí)，沒有足夠的內(nèi)存空間供其使用，簡(jiǎn)單點(diǎn)說就是你要求分配的內(nèi)存超出了系統(tǒng)能給你的，系統(tǒng)不能滿足需求，于是產(chǎn)生溢出出現(xiàn)out of memory異常2022-12-12
Go語(yǔ)言Swagger實(shí)現(xiàn)為項(xiàng)目生成 API 文檔
Swagger 是一個(gè)基于 OpenAPI 規(guī)范設(shè)計(jì)的工具,用于為 RESTful API 生成交互式文檔,下面小編就來介紹一下如何在 Go 項(xiàng)目中集成 Swagger,特別是結(jié)合 Gin 框架生成 API 文檔2025-03-03
go語(yǔ)言使用jwt認(rèn)證的實(shí)現(xiàn)
本文主要介紹了go語(yǔ)言使用jwt認(rèn)證的實(shí)現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2022-04-04
判斷一個(gè)文件是否存在是一個(gè)相當(dāng)常見的需求,在golang中也有多種方案實(shí)現(xiàn)這一功能,下面就跟隨小編一起學(xué)習(xí)一下具體的實(shí)現(xiàn)方法吧2024-11-11
golang小游戲開發(fā)實(shí)戰(zhàn)之飛翔的小鳥
這篇文章主要給大家介紹了關(guān)于golang小游戲開發(fā)實(shí)戰(zhàn)之飛翔的小鳥的相關(guān)資料,,本文可以帶你你從零開始,一步一步的開發(fā)出這款小游戲,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-03-03
在Golang代碼中如何自動(dòng)生成版本號(hào)的方法示例
這篇文章主要給大家介紹了在Golang代碼中如何自動(dòng)生成版本號(hào)的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來一起看看吧。2017-07-07
go語(yǔ)言string轉(zhuǎn)結(jié)構(gòu)體的實(shí)現(xiàn)
本文主要介紹了go語(yǔ)言string轉(zhuǎn)結(jié)構(gòu)體的實(shí)現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-03-03
在 Go 語(yǔ)言中也經(jīng)常會(huì)遇到操作文件的需求,下面這篇文章主要給大家介紹了關(guān)于Go讀取文件與寫入文件的三種方法操作,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2022-09-09