c++ grpc API

### C++ 中 gRPC API 文档与使用示例

#### 关于 gRPC 的概述
gRPC 是由 Google 开发的一种开源远程过程调用(RPC)框架，旨在提供高效的跨平台通信机制[^2]。

#### C++ gRPC API 文档概览
官方提供了详尽的文档来指导开发者如何在不同编程环境中应用 gRPC 技术。对于 C++ 用户而言，可以访问 [gRPC 官方网站](https://grpc.io/docs/languages/cpp/) 获取最新的安装指南、教程以及API 参考手册。

#### 创建服务端实例
下面是一个简单的例子展示怎样定义并启动一个基于 ProtoBuf 协议的服务端程序：

#include <iostream>
#include "greeter.grpc.pb.h"

class GreeterServiceImpl final : public helloworld::Greeter::Service {
  grpc::Status SayHello(grpc::ServerContext* context, const helloworld::HelloRequest* request,
                        helloworld::HelloReply* reply) override {
    std::string prefix("Hello ");
    reply->set_message(prefix + request->name());
    return grpc::Status::OK;
  }
};

void RunServer() {
  std::string server_address("0.0.0.0:50051");
  GreeterServiceImpl service;

  grpc::EnableDefaultHealthCheckService(true);
  grpc::reflection::InitProtoReflectionServerBuilderPlugin();
  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();
}

此代码片段展示了创建 `Greeter` 类型的服务，并实现了其唯一的接口方法 `SayHello()` 。通过构建器模式配置服务器参数后即开始监听指定地址上的连接请求。

#### 构建客户端应用程序
同样地，在客户端部分也需要引入相应的头文件，并按照如下方式编写逻辑以发起远程调用:

#include <memory>
#include <iostream>

#include "greeter.grpc.pb.h"

std::shared_ptr<Channel> channel =
      grpc::CreateChannel("localhost:50051", grpc::InsecureChannelCredentials());

std::unique_ptr<helloworld::Greeter::Stub> stub = helloworld::Greeter::NewStub(channel);

// Data we are sending to the server.
helloworld::HelloRequest request;
request.set_name("world");

// Container for the data we expect from the server.
helloworld::HelloReply reply;

// Context for the client. It could be used to convey extra information to
// the server and/or tweak certain RPC behaviors.
ClientContext context;

// The actual RPC.
Status status = stub->SayHello(&context, request, &reply);

if (status.ok()) {
  std::cout << "Greeter received: " << reply.message() << std::endl;
} else {
  std::cerr << status.error_code() << ": " << status.error_message()
            << std::endl;
  return 1;
}

return 0;

上述脚本说明了如何建立到目标主机的链接通道，随后利用该信道发送消息给远端节点并接收响应数据。