GRPC Gateway使用示例

Sat, 29 Jun 2024 10:54:55 +0800

gRPC-Gateway使用示例

grpc 相比REST HTTP服务没有默认的速度优势, 但是它提供了一些可选的能提高速度的方式:

选择性消息压缩
负载均衡
等 grpc并不是万能的工具. 比如因为兼容性易维护的等需求, 我想提供一个传统的HTTP/JSON式的API.但是另写一份HTTP/JSON的API服务又是非常耗时的一件事. 社区提出的gRPC-Gateway项目解决了这个问题.

gRPC-Gateway是protoc编译器的一个插件, 它读取protobuf的服务定义并生成一个反向代理服务器, 反向代理会将RESTful HTTP API翻译为gRPC. gRPC-Gateway帮助一次性同时开发HTTP/JSON和gRPC API. 所以gRPC-Gateway的介绍如下:

protobuf编译器的插件
从protobuf中生成代理代码
翻译HTTP/JSON 调用为gRPC

使用示例

创建项目安装工具

mkdir grpc_gateway && cd grpc_gateway 
go mod init grpcgateway

# 安装protoc的插件: go gRPC, gRPC Gateway
go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/bufbuild/buf/cmd/buf@v1.28.1

# 安装grpcurl工具
scoop install grpcurl

使用protocol buffers定义helloworld gRPC服务

编辑proto文件

GRPC on 我的绕地飞行记录

GRPC Gateway使用示例

gRPC-Gateway使用示例

使用示例

创建项目 安装工具

使用protocol buffers定义helloworld gRPC服务

创建项目安装工具