grpc-gateway：grpc网关

Posted 2021-04-11 开源软件库

编辑点评：它可以让你的服务同时支持HTTP调用和gRPC调用。在某些场景下可以节约团队的开发成本。

---

grpc-gateway是Google Protobuf编译器protoc的一个插件，它能读取protobuf服务定义并生成反向代理服务器代码，将RESTful HTTP API翻译成gRPC请求。你可以通过google.api.http注解决定反向代理的逻辑。

支持的特性

• 生成JSON API handler。

• 在请求body中加入参数。

• 在请求路径中加入参数。

• 以查询参数的方式传参数。

• 在请求路径参数中支持枚举字段（包括重复的枚举字段）。

• 将流式API映射到以新行限定（newline-delimited）的JSON流。

• 将带有Grpc-Metadata-前缀的HTTP头文件映射到gRPC元数据（前缀为grpcgateway-）。

• 支持生成  OpenAPI (Swagger) v2

• 通过入站HTTP Grpc-Timeout头设置gRPC超时。

• 部分支持将gRPC API 配置文件作为注释的替代。

• 自动将PATCH请求翻译成Field Mask gRPC请求。