图示即为使用Protocol Buffers的跨平台RPC系统的使用情况.
安装
pip install grpcio
pip install grpcio-tools googleapis-common-protos
使用
编写protocol buffer
使用GRPC首先需要做的就是设计protocolo buffer. 新建一个msg.proto
文件
syntax = "proto3";
service MsgService {
rpc GetMsg (MsgRequest) returns (MsgResponse) {
}
}
message MsgRequest {
string name =1;
}
message MsgResponse {
string msg = 1;
}
以以上的这个消息服务为例, 首先是规定语法, 这里使用的是proto3
的语法. 接着使用service
关键字定义服务, GRPC提供4种RPC类型的服务, 这里定义的是一种单一请求单一回应, 类似普通的函数调用, 其他的使用到了stream
关键字, 将其放在括号里, 代表这个数据是流数据. 这个以后再来研究, 本次先设计一个简单的RPC.
之后定义两个message
, 一个是请求的结构, 一个是回应的结果. 这里表示这个数据结构是字符串, protocol buffer还可以定义为 int32, int64, double, float 等等. 这里赋予的初值可以随便填写, 实际使用中, 会被赋予新的值.
生成接口代码
因为之前安装好了一些辅助插件, 使用这里直接可以生成.
打开命令窗口, 把目录切换至msg.proto所在的位置:
运行:
python -m grpc_tools.protoc -I. --python_out=. -- grpc_python_out=. ./msg.proto
这里会生成两个文件, msg_pb2py
和 msg_pb2_grpc.py
. 这两个文件是为后续的服务端和客户端所用. 前者定义了一些变量, 例如 _MSGREQUEST
中就包含了请求函数的名字, 可接受的变量, 实际上还是msg.proto
里定义的东西.
创建服务端
首选需要导入RPC必备的包, 以及刚才生成的两个文件.
import grpc
import msg_pb2
import msg_pb2_grpc
因为RPC应