这篇文章将讲述如何使用 gRPC 异步/非阻塞 C++ API 编写一个简单的服务端(server)和客户端(client)。在读取这篇文章之前,你需要先了解 Protocol Buffer 和 gRPC 基础,你可在本博客搜索到它们的相关文章。
这篇文章将围绕 gRPC 的官方例子 Greeter 展开学习,你可在 grpc/examples/protos/helloworld.proto 中查看服务的定义,在 grpc/examples/cpp/helloworld/ 中查看完整代码。
概览
gRPC 使用 CompletionQueue API 进行异步操作。基本工作流程如下:在 RPC 调用上绑定一个 CompletionQueue
做一些事情,例如读或写这样的事情,用一个唯一的 void* 标记表示
调用 CompletionQueue::Next 等待操作完成,如果返回之前的一个标记,则表示对应的操作已经完成。
异步客户端
要使用异步客户端调用远程方法,首先要创建 channel 和 stub,这个过程和 grpc/examples/cpp/helloworld/greeter_client.cc 中差不多(同步示例)。一旦你创建了 stub,就可以做以下事情来进行异步调用了:初始化 RPC 并为其创建句柄。将 RPC 绑定到一个 CompletionQueue 上。CompletionQueue cq;
std::unique_ptr > rpc(
stub_->AsyncSayHello(&context, request, &cq));
使用一个唯一的标记(这里用的是 (void*)1),请求回复和最终状态Status status;
rpc->Finish(&reply, &status, (void*)1);
等待完成队列返回标记(tag)。一旦返回了之前对应 Finish() 函数中传递的标记,应答和状态就可以被返回了。void* got_tag;
bool ok = false;
cq.Next(&got_tag, &ok);
if (ok && got_tag == (void*)1) {
// check reply and status
}
你可以在 grpc/examples/cpp/helloworld/greeter_async_client.cc 中看到完整的客户端示例。
异步服务端
服务器实现一个带有标记(tag)的 RP