Ir para o conteúdo

Última atualização：2026-10-12

Pequeno projeto de gRPC em C++

C++那些事: pequena demo de grpc

Os RPCs mais populares do github são grpc, brpc, além do trpc, muito usado internamente na Tencent, entre outros; esses RPCs dão suporte a diferentes linguagens e plataformas. Hoje vamos conversar sobre como usar o grpc, começando com uma demo simples; todo o projeto é construído com CMake, uma gestão de projeto RPC bem padrão, e todo o código já foi publicado na planeta — a forma de obtê-lo está no QR code no final.

1.Ambiente passo a passo

Se o seu computador é um mac, lamentamos: por enquanto não é possível usar a versão mais recente do grpc. A versão mais recente usa abseil e a compilação apresenta problemas que a equipe oficial ainda não resolveu; se alguém souber como resolver, pode deixar um comentário — eu, por enquanto, não encontrei solução.

Portanto, recomendo instalar uma versão mais antiga do grpc no seu mac, ou instalar direto no linux; no linux é possível usar a versão mais recente do grpc, instalando de uma vez sem nenhum problema.

Modo de instalação:

git clone -b v1.57.0 git@github.com:grpc/grpc.git
Em seguida, inicialize o submodule

git submodule update --init
Compilação e instalação com cmake:

cd cmake
mkdir build
cd build
cmake -DgRPC_INSTALL=ON -DgRPC_BUILD_TESTS=OFF   -DCMAKE_INSTALL_PREFIX=/usr/local/grpc ../..

make -j8
make -j8 install // root 权限
Vocês podem alterar o diretório de instalação acima; note que o install exige permissão de root.

Depois de instalar, coloque o seu diretório bin no path, por exemplo:

export PATH=/usr/local/grpc/bin:$PATH

2.Demo de inversão de string

Com o ambiente pronto, já podemos colocar a mão na massa.

2.1 Protocolo

A primeira coisa é definir o protocolo rpc:

syntax = "proto3";

package stringreverse;

service StringReverse {
    rpc sendRequest (StringRequest) returns (StringReply) {}
}

message StringRequest {
    string original = 1;
}

message StringReply {
    string reversed = 1;
}
Um protocolo muito simples: envia-se uma string e retorna-se uma string.

2.2 Cliente

Constrói a string da requisição rpc e basta chamar a interface sendRequest para enviá-la.

std::string str = "hello world grpc!";
std::cout << "Original string: " << str << std::endl;
StringRequest request;
StringReply reply;
ClientContext context;
request.set_original(str);
Status status = stub->sendRequest(&context, request, &reply);
if (status.ok()) {
    std::cout << "Reversed string: " << reply.reversed() << std::endl;
}
// do something

2.3 Servidor

Implementa a lógica de inversão da string herdando de Service.

class ReverseServiceImplementation final : public StringReverse::Service {
    Status sendRequest(ServerContext* context, const StringRequest* request,
                     StringReply* reply) override {
    // 反转逻辑
  }             
}
Por fim, basta registrar o service:

builder.RegisterService(&service);
std::unique_ptr<Server> server(builder.BuildAndStart());
std::cout << "Server listening on port: " << server_address << std::endl;

3.Execução

Crie o diretório de compilação:

mkdir build
cmake ..
# 输出
-- The C compiler identification is GNU 10.2.1
-- The CXX compiler identification is GNU 10.2.1
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /opt/rh/devtoolset-10/root/usr/bin/cc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /opt/rh/devtoolset-10/root/usr/bin/c++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Looking for pthread.h
-- Looking for pthread.h - found
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD - Failed
-- Looking for pthread_create in pthreads
-- Looking for pthread_create in pthreads - not found
-- Looking for pthread_create in pthread
-- Looking for pthread_create in pthread - found
-- Found Threads: TRUE  
-- Found Protobuf: /usr/local/grpc/bin/protoc-23.4.0 (found version "23.4.0") 
-- Using protobuf 
-- Using gRPC 1.57.0
-- Configuring done
-- Generating done
-- Build files have been written to: /code/stringreverse/build
Compile com make:

[ 10%] Generating stringreverse.pb.cc, stringreverse.pb.h, stringreverse.grpc.pb.cc, stringreverse.grpc.pb.h
Scanning dependencies of target server
[ 20%] Building CXX object CMakeFiles/server.dir/server.cc.o
[ 30%] Building CXX object CMakeFiles/server.dir/stringreverse.pb.cc.o
[ 40%] Building CXX object CMakeFiles/server.dir/stringreverse.grpc.pb.cc.o
[ 50%] Linking CXX executable server
[ 50%] Built target server
Scanning dependencies of target client
[ 60%] Building CXX object CMakeFiles/client.dir/client.cc.o
[ 70%] Building CXX object CMakeFiles/client.dir/stringreverse.pb.cc.o
[ 80%] Building CXX object CMakeFiles/client.dir/stringreverse.grpc.pb.cc.o
[ 90%] Linking CXX executable client
[100%] Built target client
Execute o server:

[light@i-i339drlk build]$ ./server 
Server listening on port: 0.0.0.0:5000
Execute o client:

[light@i-i339drlk build]$ ./client 
Original string: hello world grpc!
Reversed string: !cprg dlrow olleh

Tópicos relacionados

Comentários