文章目录:
- 前言
- helloworld.proto
- 小思考
- 小结
前言
ProtoBuf
是什么?
ProtoBuf
是一套接口描述语言(IDL),通俗的讲是一种数据表达方式,也可以称为数据交换格式。
我们常用的数据格式有 JSON
和 XML
,为什么使用 ProtoBuf
?是因为它的传输快,为什么传输快?大家可以找下资料。使用 .proto
文件进行描述要序列化的数据结构,然后将写好 .proto
文件使用 protoc
就可以很容易编译成众多计算机语言的接口代码。
gRPC
是什么?
gRPC
是开源的 RPC
框架,已支持主流的计算机语言,可以通过 ProtoBuf
进行定义接口,可以基于 ProtoBuf
进行数据传输。
两者虽然是一家,但是分别解决不同的问题,可以配合使用,也可以分开。
看一下的 gRPC
helloworld 的 proto
文件是如何定义的?
helloworld.proto
代码语言:javascript复制syntax = "proto3";
package helloworld;
option go_package = "./;helloworld";
// The greeting service definition.
service Greeter {
// Sends a greeting
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
// The request message containing the user's name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}
文件中定义了一个 service
Greeter 和 rpc
SayHello 方法。
入参:string
name
出参:string
message
这些过于简单,还能不能描述其他信息?
小思考
- 定义的
rpc
方法能否也同时支持HTTP
调用?例如:SayHello 方法,既支持 gRPC 调用,也支持 HTTP 调用,同时支持protoc
生成代码时,同时也生成Swagger
接口文档。 - 定义的入参能否支持参数验证?例如:name 长度不能大于 20 个字符。
- 定义的
service
Greeter 服务能否支持拦截器?例如:该服务下的所有方法需要进行登录令牌验证。 - 定义的
rpc
SayHello 方法能够支持拦截器?例如:当前方法支持开启和关闭是否记录日志。
小结
以上问题还未完全解决,学习 gRPC 感觉有些吃力...
参考资料
[1]grpc-gateway: https://github.com/grpc-ecosystem/grpc-gateway