Go Grpc Gateway兼容HTTP协议文档自动生成网关

前言

调用，让客户端可以更具自身情况自由选择，服务端工作只需要做一份呢？还别说真还有一个准备好的轮子那就是今天的主角《grpc-gateway》。

附上:

一，grpc-gateway介绍

grpc-gateway是protoc的一个插件 。它读取Grpc服务定义，并生成反向代理服务器，将RESTful JSON API请求转换为Grpc的方式调用。主要是根据 google.api.http定义中思想完成的，一下就是grpc-gateway结构图：

二，grpc-gateway环境准备

grpc-gateway使用完全的Go语言进行开发，所以安装起来也非常简单，首先需要获取相关的依赖包

PS：需要先准备好准备好protoc的环境

生成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服务

服务端代码：

运行grpc服务端：

编写gateway服务

运行网关程序

使用http的方式调用网关：

四，使用gateway生成swagger文档

五，性能对比

对比以下两项：

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的情况下经过grpc-gateway和不经过直接到API差距大概在20~30%左右，这样的性能消耗带来的是兼容HTTP并且还可以自动生成swagger（还可以作为调试工具），何乐而不为呢？