python gRPC接口调用

原创

小嘉欣008 2022-10-21 14:29:21 ©著作权

文章标签 python 服务器 json 文章分类 运维

©著作权归作者所有：来自51CTO博客作者小嘉欣008的原创作品，请联系作者获取转载授权，否则将追究法律责任

gRPC

gRPC 是 Google 开源的基于 Protobuf 和 Http2.0 协议的通信框架。

gRPC官网

https://www.grpc.io/docs/quickstart/python/

grpc-git：https://github.com/grpc/grpc

python实现gRPC接口调用的方法步骤

2.1 安装第三方包：grpcio、protobuf、grpcio_tools

1 pip install grpcio
2 pip install protobuf
3 pip install

2.2 编写proto文件

参考protobuf语法编写.proto文件

2.3 编译proto文件

将protoc文件转化为pb2和pb2_grpc文件，操作步骤如下：

命令：

1 python3  -m  grpc_tools.protoc  --python_out=.  --grpc_python_out=.  -I. xxx.proto  -I=/workspace  -I=xxx/yyy/
 2 
 3 #说明：
 4 -I=：在proto文件中远程调用的内容，导入路径为实际调用的上一级目录即可。
 5 python_out：指定xxx_pb2.py的输出路径，编译生成处理protobuf相关的代码路径。传入.，则默认生成到当前目录。
 6 grpc_python_out：指定xxx_pb2_grpc.py的输出路径，编译生成处理grpc相关的代码路径，传入.，则默认生成到当前目录。
 7 grpc_tools.protoc：工具包，刚安装的。
 8 -I：这个参数指定协议文件的查找目录。
 9  
10 # 生成的文件中：
11 xxx_pb2.py：里面有消息序列化类。是用来和protobuf数据进行交互。
12

# 若报错-缺少文件，则需要找对应文件，然后使用 "-I=" 导入

2.4 写server端代码

demo如下：

1 # coding:utf-8
 2 
 3 import grpc
 4 import json
 5 from concurrent import futures
 6 import xxx_pb2,yyy_pb2_grpc
 7 
 8 _HOST = ''  # todo
 9 _PORT = ''  # todo
10 
11 
12 # 实现 proto 文件中定义的 xxxServicer
13 class xxxServer(yyy_pb2_grpc.xxxServicer):
14     # 实现 proto 文件中定义的GRPC调用
15     def SendRequest(self, request, context):
16         json_response = xxx_pb2.xxxResponse()
17         json_response.rst_string = json.dumps({"ret": "Hi grpc"})
18         return json_response
19 
20 
21 def serve():
22     # 启动GRPC服务,监听特定的端口
23     server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))  # 多线程服务器
24     yyy_pb2_grpc.add_xxxServicer_to_server(xxxServer(), server)  # 注册本地服务
25     server.add_insecure_port("{0}:{1}".format(_HOST, _PORT))  # 监听端口
26     server.start()  # 开始接收请求进行服务
27     try:
28         while True:
29             time.sleep(60 * 60 * 24)  # one day in seconds
30     except KeyboardInterrupt:
31         server.stop(0)
32 
33 
34 if __name__ == '__main__':
35

2.5 写client端代码

demo如下：

1 # coding:utf-8
 2 
 3 import grpc
 4 import xxx_pb2, yyy_pb2_grpc
 5 
 6 _HOST = ''  # todo
 7 _PORT = ''  # todo
 8 
 9 
10 def main():
11     with grpc.insecure_channel("{0}:{1}".format(_HOST, _PORT)) as channel:
12         client = yyy_pb2_grpc.xxxStub(channel=channel)
13         response = client.xxxMessage(xxx_pb2.xxxRequest())
14     print("received: " + response.message + response.result)
15 
16 
17 if __name__ == '__main__':
18

2.6 完成

参考demo实际过程

gRPC四种通信方式

根据不同的业务场景, grpc 支持 4 种通信方式:

客服端一次请求, 服务器一次应答
客服端一次请求, 服务器多次应答(流式)
客服端多次请求(流式), 服务器一次应答
客服端多次请求(流式), 服务器多次应答(流式)

参考demo实际过程： https://www.jianshu.com/p/43fdfeb105ff?from=timeline&isappinstalled=0

protoc

protoc3官网

https://developers.google.com/protocol-buffers/docs/proto3

protobuf数据格式

protobuf是Google开源的一款类似于Json,XML数据交换格式，其内部数据是纯二进制格式，不依赖于语言和平台，具有简单，数据量小，快速等优点。（是使用google规定的proto协议定义语言，之后使用proto的工具对代码进行‘编译’，生成对应的各个平台的源代码，后续可以使用这些源代码进行工作。）目前用于序列化于反序列化官方支持的语言有C++，C#，JAVA，PYTHON。适用于大小在1M以内的数据。可以使用prorobuf将内容序列化后保存在文件中，下次使用的时候，加载文件，反序列化后就可以直接使用了。