C++怎么使用gRPC框架_C++分布式通信与gRPC应用指南-C++-PHP中文网

C++怎么使用gRPC框架_C++分布式通信与gRPC应用指南

穿越時空

发布： 2025-11-26 11:56:02

原创

259人浏览过

掌握gRPC在C++中的应用需先安装protoc和gRPC库，再定义.proto接口文件并生成C++代码，接着实现服务端和客户端逻辑，最后通过CMake正确编译链接依赖库，完成高效分布式通信。

c++怎么使用grpc框架_c++分布式通信与grpc应用指南

使用gRPC框架进行C++开发：分布式通信实战指南

在现代分布式系统中，服务之间的高效通信至关重要。gRPC 是 Google 开发的高性能、跨语言的远程过程调用（RPC）框架，基于 HTTP/2 协议和 Protocol Buffers（Protobuf），特别适合微服务架构下的 C++ 服务通信。本文将带你从零开始掌握如何在 C++ 中使用 gRPC。

1. 环境准备与依赖安装

要在 C++ 中使用 gRPC，需先安装必要的工具链：

Protocol Buffers 编译器（protoc）：用于将 .proto 文件编译为 C++ 代码。
gRPC C++ 库：包含运行时支持和头文件。

推荐使用包管理器或源码编译方式安装。以 Ubuntu 为例：

立即学习“C++免费学习笔记（深入）”；

sudo apt-get install -y build-essential autoconf libtool pkg-config
git clone -b v1.50.1 https://github.com/grpc/grpc
cd grpc
git submodule update --init
make -j$(nproc)
sudo make install

登录后复制

确保 protoc 版本兼容，必要时单独安装：

sudo apt-get install protobuf-compiler
protoc --version

登录后复制

2. 定义服务接口（.proto 文件）

gRPC 使用 Protobuf 定义服务接口和数据结构。创建一个 helloworld.proto 文件：

syntax = "proto3";
<p>package helloworld;</p><p>service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply);
}</p><p>message HelloRequest {
string name = 1;
}</p><p>message HelloReply {
string message = 1;
}

登录后复制

该定义声明了一个名为 Greeter 的服务，提供 SayHello 方法，接收请求并返回响应。

使用 protoc 生成 C++ 代码：

protoc -I=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_cpp_plugin` helloworld.proto
protoc -I=. --cpp_out=. helloworld.proto

登录后复制

生成两个文件：helloworld.pb.cc（消息类）和 helloworld.grpc.pb.cc（服务和桩代码）。

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

396

查看详情

3. 实现服务端逻辑

创建服务端实现，继承自生成的抽象服务类：

#include <iostream>
#include <memory>
#include <string>
#include <grpcpp/grpcpp.h>
#include "helloworld.grpc.pb.h"
<p>using grpc::Server;
using grpc::ServerBuilder;
using grpc::Status;
using grpc::ServerContext;
using helloworld::HelloRequest;
using helloworld::HelloReply;
using helloworld::Greeter;</p><p>class GreeterServiceImpl final : public Greeter::Service {
Status SayHello(ServerContext<em> context, const HelloRequest</em> request,
HelloReply* reply) override {
std::string prefix("Hello ");
reply->set_message(prefix + request->name());
return Status::OK;
}
};</p><p>void RunServer() {
std::string server_address("0.0.0.0:50051");
GreeterServiceImpl service;</p><p>ServerBuilder builder;
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();
}</p><p>int main() {
RunServer();
return 0;
}

登录后复制

该服务监听 50051 端口，处理客户端的 SayHello 调用。

4. 实现客户端调用

客户端通过存根（stub）调用远程方法：

#include <iostream>
#include <grpcpp/grpcpp.h>
#include "helloworld.grpc.pb.h"
<p>using grpc::Channel;
using grpc::ClientContext;
using grpc::Status;
using helloworld::HelloRequest;
using helloworld::HelloReply;
using helloworld::Greeter;</p><p>class GreeterClient {
public:
GreeterClient(std::shared<em>ptr<Channel> channel)
: stub</em>(Greeter::NewStub(channel)) {}</p><p>std::string SayHello(const std::string& user) {
HelloRequest request;
request.set_name(user);</p><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">HelloReply reply;
ClientContext context;

Status status = stub_->SayHello(&context, request, &reply);
if (status.ok()) {
  return reply.message();
} else {
  std::cout << "RPC failed: " << status.error_code()
            << ": " << status.error_message() << std::endl;
  return "RPC failed";
}

登录后复制

}

private: std::uniqueptr<Greeter::Stub> stub; };

int main() { GreeterClient client(grpc::CreateChannel( "localhost:50051", grpc::InsecureChannelCredentials())); std::string user("World"); std::string reply = client.SayHello(user); std::cout << "Greeter received: " << reply << std::endl; return 0; }

客户端创建通道连接到服务端，构造存根并发起同步调用。

5. 编译与链接注意事项

C++ 项目需正确链接 gRPC 和 Protobuf 库。使用 CMake 示例：

cmake_minimum_required(VERSION 3.14)
project(helloworld)
<p>find_package(Protobuf REQUIRED)
find_package(gRPC CONFIG REQUIRED)</p><p>set(CMAKE_CXX_STANDARD 17)</p><p>add_executable(greeter_server server.cpp helloworld.pb.cc helloworld.grpc.pb.cc)
add_executable(greeter_client client.cpp helloworld.pb.cc helloworld.grpc.pb.cc)</p><p>target_link_libraries(greeter_server
${_PROTOBUF_LIBPROTOBUF}
gRPC::grpc++
gRPC::gpr
)</p><p>target_link_libraries(greeter_client
${_PROTOBUF_LIBPROTOBUF}
gRPC::grpc++
gRPC::gpr
)

登录后复制

确保库路径和依赖正确配置，避免链接错误。

基本上就这些。掌握 gRPC 在 C++ 中的应用，能显著提升服务间通信效率和系统可维护性。关键是定义好接口、生成代码、实现服务逻辑，并正确编译链接。不复杂但容易忽略细节。

以上就是C++怎么使用gRPC框架_C++分布式通信与gRPC应用指南的详细内容，更多请关注php中文网其它相关文章！