To install gRPC, run the following commands:
$ export INSTALL_DIR=$HOME/.local
$ mkdir -p $INSTALL_DIR
$ export PATH="$INSTALL_DIR/bin:$PATH"
$ git clone --recurse-submodules -b v1.37.1 https://github.com/grpc/grpc
$ cd grpc
$ mkdir -p cmake/build
$ pushd cmake/build
$ cmake -DgRPC_INSTALL=ON -DgRPC_BUILD_TESTS=OFF -DCMAKE_INSTALL_PREFIX=$INSTALL_DIR ../..
$ make -j
$ make install
$ popd
$ mkdir -p third_party/abseil-cpp/cmake/build
$ pushd third_party/abseil-cpp/cmake/build
$ cmake -DCMAKE_INSTALL_PREFIX=$INSTALL_DIR -DCMAKE_POSITION_INDEPENDENT_CODE=TRUE ../..
$ make -j
$ make install
$ popdIf you encounter the fatal error: absl/synchronization/mutex.h: No such file or directory error when building the Hello world example, simply fix it by copying the absl directory from grpc/third_party/abseil-cpp/absl
to /usr/local/include/:
$ (sudo) cp -r grpc/third_party/abseil-cpp/absl /usr/local/include/
Define a service in a .proto file using the Interface Definition Language (IDL) from Protocol Buffers.
Example: Sample service
syntax = "proto3";
option java_package = "sample.grpc";
package sample;
service SampleService {
rpc SampleMethod (SampleRequest) returns (SampleResponse) {}
}
message SampleRequest {
string request_sample_field = 1;
}
message SampleResponse {
string response_sample_field = 1;
}Example: Calculator service
Use the protocol buffer compiler protoc to generate client and server code:
$ protoc -I=$SRC_DIR --cpp_out=$DST_DIR $SRC_DIR/sample.proto
$ protoc -I=$SRC_DIR --grpc_out=$DST_DIR --plugin=protoc-gen-grpc=/usr/local/bin/grpc_cpp_plugin $SRC_DIR/sample.protowhere:
SRC_DIR: The source directory, or the directory contains the.protofile.DST_DIR: The destination directory, or the directory contains the.pb.h,.pb.cc,.grpc.pb.hand.grpc.pb.ccfiles.
With SRC_DIR = protos/ and DST_DIR = sample/:
$ protoc -I=protos/ --cpp_out=sample/ protos/sample.proto
$ protoc -I=protos/ --grpc_out=sample/ --plugin=protoc-gen-grpc=/usr/local/bin/grpc_cpp_plugin protos/sample.protoWith SRC_DIR = protos/ and DST_DIR = calculator/:
$ protoc -I=protos/ --cpp_out=calculator/ protos/calculator.proto
$ protoc -I=protos/ --grpc_out=calculator/ --plugin=protoc-gen-grpc=/usr/local/bin/grpc_cpp_plugin protos/calculator.protoThe .pb.h, .pb.cc, .grpc.pb.h and .grpc.pb.cc files could be generated automatically by the CMake's add_custom_command command and should not be included in the actual project. See also: Sample CMakeLists.txt, Calculator CMakeLists.txt.
- Create a channel.
- Create a stub.
- Make a unary RPC.
- Check returned status and response.
Example: Sample client
Example: Calculator client
- Implement the service interface.
- Build a server exporting the service.
Example: Sample server
Example: Calculator server
- Create a channel.
- Create a stub.
- Initiate the RPC and bind it to a
CompletionQueue. - Request to update the response and the call status upon completion of the RPC with a unique tag.
- Wait for the completion queue to return the next tag.
Example: Sample async client
Example: Calculator async client
- Build a server exporting the async service.
- Request an RPC with a unique tag.
- Wait for the completion queue to return the next tag.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent