如何使用公共IDL文件¶
有时,我们希望把一些所有请求都会用到的数据包含在发送给service的request中。 于是,我们会项目外的另一个地方新建一个公共的文件,比如”shared.proto”,然后定义一个新的Message。 然后,再把这个新Message添加到其他request对象中。
下面的例子介绍了如何在Turbo中这么做。
1, 新建 “shared.proto”,并且定义一个新Message¶
创建文件夹”common”(或者其他名字):
$ mkdir -p ~/package/path/to/yourservice/common
在里面创建文件 “shared.proto”:
syntax = "proto3";
package proto;
message CommonValues {
int64 someId = 1;
}
2, 给request对象添加新参数¶
编辑 “yourservice.proto”:
syntax = "proto3";
package proto;
+
+import "shared.proto";
message SayHelloRequest {
string yourName = 1;
+ CommonValues values = 2;
}
3, 生成代码¶
$ turbo generate package/path/to/yourservice -r grpc -I ~/package/path/to/yourservice
-I ~/package/path/to/yourservice/common
完成!
测试前,编辑 “youserviceimpl.go”,返回 “someId”:
func (s *YourService) SayHello(ctx context.Context, req *proto.SayHelloRequest) (*proto.SayHelloResponse, error) {
+ someId := strconv.FormatInt(req.Values.SomeId, 10)
- return &proto.SayHelloResponse{Message: "[grpc server]Hello, " + req.YourName}, nil
+ return &proto.SayHelloResponse{Message: "[grpc server]Hello, " + req.YourName + ", someId=" + someId}, nil
}
重启服务并测试:
$ curl -w "\n" -X GET "http://localhost:8081/hello?your_name=Alice&some_id=12345"
{"message":"[grpc server]Hello, Alice, someId=12345"}
Turbo很智能,queryString中的参数”some_id”会被自动设置给”SayHelloRequest.CommonValues.SomeId”。
除了queryString,也可以读取URL路径里的参数,或者在拦截器中设置在context.Context里的参数。