grpc-gateway-sample

gRPC-Go Gateway Sample

gRPC-Gateway 是一个 protoc 插件。它读取 gRPC 服务定义并生成一个反向代理服务器，该服务器将 RESTful JSON API 转换为 gRPC。

1. 安装插件

go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway
go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2

2. 生成 gRPC 桩代码

protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=require_unimplemented_servers=false --go-grpc_opt=paths=source_relative go_echo_svr.proto

3. 添加 gRPC-Gateway 注释

...
import "google/api/annotations.proto";

...

option (google.api.http) = {
  post: "/v1/echo"
  body: "*"
};

4. 生成 gRPC-Gateway 桩代码

protoc -I . --grpc-gateway_out ./ --grpc-gateway_opt logtostderr=true --grpc-gateway_opt paths=source_relative go_echo_svr.proto

5. 测试 gRPC-Gateway

使用 cURL 发送 HTTP 请求：

curl -X POST -k http://127.0.0.1:8090/v1/echo -d '{"payload": "hello"}'

得到响应结果：

{"payload":"world"}

License

This project is licensed under the Apache 2.0 license.