这篇文章讨论的是如何通过gRPC在C++服务端和Python客户端之间进行通信。下面是一个详细的解读以及手把手的操作步骤： ### 文章概述 文章的主要内容包括以下几个部分： 1. **环境搭建**：安装并配置gRPC相关的依赖库。 2. **Protobuf文件编写**：创建`.proto`文件来定义服务接口和服务消息。 3. **生成代码**：利用Protobuf编译器从.proto文件生成相应的语言绑定代码。 4. **实现服务端与客户端**：分别使用C++完成服务端，用Python实现实现客户端。 ### 手把手操作指南 #### 第一步 - 环境准备 你需要确保系统上已经安装了以下工具和库： - Protobuf 编译器 (`protoc`) - gRPC C++ 库及其头文件 - Python 的 `grpcio-tools` 可以参考官方文档或者使用包管理工具如APT、Homebrew等安装上述软件。 #### 第二步 - 创建 .proto 文件 假设我们要构建一个简单的问候功能，可以先建立如下结构的服务描述文件`hello_service.proto`: ```protobuf syntax = "proto3"; service Greeter { rpc SayHello (HelloRequest) returns (HelloReply); } message HelloRequest { string name = 1; } message HelloReply { string message = 1; } ``` 然后保存此文件到合适位置，并记下路径名用于后续命令行处理阶段。 #### 第三步 - 使用 protoc 工具生成代码模板 对于每种支持的语言（这里是CPP 和 PYTHON），都需要单独运行一次类似这样的指令来生成对应的胶水代码： 针对cpp版本: ```bash protoc --cpp_out=./generated ./your_path/hello_service.proto ``` 而对于python，则执行另一条命令行语句: ```bash python -m grpc_tools.protoc -I./your_proto_directory --python_out=. --grpc_python_out=. your_file_name.proto ``` 这将为我们提供必要的stubs以便下一步继续工作. #### 第四步 - 实现业务逻辑及测试连接 ##### 对于服务器(C++) 加载之前生产的pb.cc文件并且设置监听地址等待请求到来. 示例片段可能看起来像这样子: ```cpp #include <iostream> #include <memory> #include <string> #include "greeter.grpc.pb.h" using grpc::Server; using grpc::ServerBuilder; using grpc::ServerContext; using grpc::Status; class GreeterServiceImpl final : public GreeterService::Service { Status SayHello(ServerContext* context, const HelloRequest* request, HelloReply* reply) override { std::string prefix("Hello "); reply->set_message(prefix + request->name()); return Status::OK; } }; void RunServer() { std::string server_address("0.0.0.0:50051"); GreeterServiceImpl service; ServerBuilder builder; // Listen on the given address without any authentication mechanism. builder.AddListeningPort(server_address, grpc::InsecureServerCredentials()); builder.RegisterService(&service); std::unique_ptr<Server> server(builder.BuildAndStart()); std::cout << "Server listening on " << server_address << std::endl; server->Wait(); } int main(int argc, char** argv) { RunServer(); return 0; } ``` ##### 对于客户端(PYTHON) 现在我们有了响应函数之后就可以发起调用了，在PYTHON这边只需要简单几句话就能搞定整个流程啦~ ```pytho import grpc from generated import greeter_pb2 as hello__pb2 def run(): channel = grpc.insecure_channel('localhost:50051') stub = hello__pb2.GreeterStub(channel) response = stub.SayHello(hello__pb2.HelloRequest(name='you')) print(f"Greeting received: {response.message}") if __name__ == '__main__': run() ``` 以上就是基本完整的项目架构过程说明咯~