Go Grpc Gateway兼容HTTP協(xié)議文檔自動生成網(wǎng)關
前言
調用，讓客戶端可以更具自身情況自由選擇，服務端工作只需要做一份呢？還別說真還有一個準備好的輪子那就是今天的主角《grpc-gateway》。
附上:
博文實例demo：https://github.com/sunmi-OS/grpc-gateway-demo
grpc-gateway官網(wǎng)：https://github.com/grpc-ecosystem/grpc-gateway
一，grpc-gateway介紹
grpc-gateway是protoc的一個插件 。它讀取Grpc服務定義，并生成反向代理服務器，將RESTful JSON API請求轉換為Grpc的方式調用。主要是根據(jù) google.api.http定義中思想完成的，一下就是grpc-gateway結構圖：
二，grpc-gateway環(huán)境準備
grpc-gateway使用完全的Go語言進行開發(fā)，所以安裝起來也非常簡單，首先需要獲取相關的依賴包
PS：需要先準備好準備好protoc的環(huán)境
go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger go get -u github.com/golang/protobuf/protoc-gen-go
cd $GOPATH/src/
mkdir -p grpc-gateway-demo/gateway
cd grpc-gateway-demo/gateway
vim gateway.proto
syntax = "proto3";
package gateway;
# 新增以下引入
import "google/api/annotations.proto";
message StringMessage {
string value = 1;
}
# 修改方法增加http定義
# service Gateway {
# rpc SayHello Echo(StringMessage) returns (StringMessage) {}
# }
service Gateway {
rpc Echo(StringMessage) returns (StringMessage) {
option (google.api.http) = {
post: "/v1/example/echo"
body: "*"
};
}
}
生成grpc結構文件和gateway文件：
protoc --proto_path=../ -I/usr/local/include -I. -I$GOPATH/src -I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis --go_out=plugins=grpc:. gateway.proto
protoc --proto_path=../ -I/usr/local/include -I. -I$GOPATH/src -I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis --grpc-gateway_out=logtostderr=true:. gateway.proto
最終可以看到以下文件
二，編寫grpc-gateway服務
服務端代碼：
cd ..
vim grpc_service.go
package main
import (
"log"
"net"
pb "grpc-gateway-demo/gateway"
"google.golang.org/grpc"
"golang.org/x/net/context"
)
const (
PORT = ":9192"
)
type server struct {}
func (s *server) Echo(ctx context.Context, in *pb.StringMessage) (*pb.StringMessage, error) {
log.Println("request: ", in.Value)
return &pb.StringMessage{Value: "Hello " + in.Value}, nil
}
func main() {
lis, err := net.Listen("tcp", PORT)
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
s := grpc.NewServer()
pb.RegisterGatewayServer(s, &server{})
log.Println("rpc服務已經(jīng)開啟")
s.Serve(lis)
}運行grpc服務端：
go build grpc_service.go ./grpc_service
編寫gateway服務
vim grpc_gateway.go
package main
import (
"flag"
"net/http"
"log"
"github.com/golang/glog"
"golang.org/x/net/context"
"github.com/grpc-ecosystem/grpc-gateway/runtime"
"google.golang.org/grpc"
gw "grpc-gateway-demo/gateway"
)
var (
echoEndpoint = flag.String("echo_endpoint", "localhost:9192", "endpoint of Gateway")
)
func run() error {
ctx := context.Background()
ctx, cancel := context.WithCancel(ctx)
defer cancel()
mux := runtime.NewServeMux()
opts := []grpc.DialOption{grpc.WithInsecure()}
err := gw.RegisterGatewayHandlerFromEndpoint(ctx, mux, *echoEndpoint, opts)
if err != nil {
return err
}
log.Println("服務開啟")
return http.ListenAndServe(":8080", mux)
}
func main() {
flag.Parse()
defer glog.Flush()
if err := run(); err != nil {
glog.Fatal(err)
}
}運行網(wǎng)關程序
go build grpc_gateway.go ./grpc_gateway
使用http的方式調用網(wǎng)關：
curl -X POST -k http://localhost:8080/v1/example/echo -d '{"value":" world"}'
{"value":"Hello world"}四，使用gateway生成swagger文檔
cd gateway protoc -I/usr/local/include -I. \ -I$GOPATH/src \ -I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \ --swagger_out=logtostderr=true:. \ gateway.proto
五，性能對比
對比以下兩項：
http -> go -> grpc -> go
http -> go -> http -> grpc_gateway -> grpc -> go
全程使用ab 帶 -k進行壓測
http -> go -> grpc -> go
http -> go -> http -> grpc_gateway -> grpc -> go
六，總結
在GO的場景下基本上4倍差距，但是考慮到本身Go在grpc和http上本身就有3.5倍的差距，本身在同等HTTP的情況下經(jīng)過grpc-gateway和不經(jīng)過直接到API差距大概在20~30%左右，這樣的性能消耗帶來的是兼容HTTP并且還可以自動生成swagger（還可以作為調試工具），何樂而不為呢？
以上就是Go Grpc Gateway兼容HTTP協(xié)議文檔自動生成網(wǎng)關的詳細內容，更多關于Go Grpc Gateway兼容HTTP的資料請關注腳本之家其它相關文章！
相關文章
這篇文章主要介紹了golang值接收者和指針接收者的區(qū)別,它和函數(shù)的區(qū)別在于方法有一個接收者，給一個函數(shù)添加一個接收者，那么它就變成了方法，接收者可以是值接收者，也可以是指針接收者，本文通過實例代碼介紹的非常詳細，需要的朋友可以參考下2022-08-08
Go語言反射reflect.Value實現(xiàn)方法的調用
本文主要介紹了Go語言反射reflect.Value實現(xiàn)方法的調用，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-05-05
關于golang中map使用的幾點注意事項總結(強烈推薦!)
map是一種無序的基于key-value的數(shù)據(jù)結構,Go語言中的map是引用類型,必須初始化才能使用,下面這篇文章主要給大家介紹了關于golang中map使用的幾點注意事項,需要的朋友可以參考下2023-01-01
這篇文章主要介紹了GO語言實現(xiàn)簡單的目錄復制功能,通過新建及復制內容等操作最終實現(xiàn)復制目錄的功能效果,具有一定的參考借鑒價值,需要的朋友可以參考下2014-12-12
golang多次讀取http request body的問題分析
這篇文章主要給大家分析了golang多次讀取http request body的問題,文中通過代碼示例和圖文介紹的非常詳細,對大家的學習或工作有一定的幫助,需要的朋友可以參考下2024-01-01
Go?web中cookie值安全securecookie庫使用原理
這篇文章主要為大家介紹了Go?web中cookie值安全securecookie庫使用及實現(xiàn)原理詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-11-11
本文主要介紹了go語言中gorm時間格式化，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-03-03
日常項目中，讀取各種配置文件是避免不了的，本文主要介紹了golang讀取各種配置文件(ini、json、yaml)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-05-05
這篇文章主要介紹了mayfly-go部署和使用詳解,此處部署基于CentOS7.4部署，結合實例代碼圖文給大家講解的非常詳細，需要的朋友可以參考下2022-09-09
Golang當中的變量類型和C/C++比較接近,一般用的比較多的也就是int,float和字符串,下面這篇文章主要給大家介紹了關于Golang語言的多種變量聲明方式與使用場景的相關資料,需要的朋友可以參考下2022-02-02