C++ REST service module#

namespace service#

Namespace including the API Eigen Example Server logic (i.e. service) implemented in C++.

class GRPCService : public grpcdemo::GRPCDemo::Service#

Class containing the server logic (i.e. service).

Public Functions

GRPCService(const bool debug_log)#

Construct a new GRPCDemo Service object.

Parameters:

debug_log – whether to show the enhanced debugging logs or not.

~GRPCService()#

Destroy the GRPCDemo Service object.

::grpc::Status SayHello(::grpc::ServerContext *context, const ::grpcdemo::HelloRequest *request, ::grpcdemo::HelloReply *response) override#

Method to provide a simple greeting to the client.

Parameters:

  • context – the gRPC Server context.

  • request – the gRPC request.

  • response – the gRPC response this method will fill.

Returns:

::grpc::Status

::grpc::Status FlipVector(::grpc::ServerContext *context, ::grpc::ServerReaderWriter<::grpcdemo::Vector, ::grpcdemo::Vector> *stream) override#

Method to provide a flipped vector to the client.

Parameters:

  • context – the gRPC Server context.

  • stream – the gRPC stream.

Returns:

::grpc::Status

::grpc::Status AddVectors(::grpc::ServerContext *context, ::grpc::ServerReaderWriter<::grpcdemo::Vector, ::grpcdemo::Vector> *stream) override#

Method to provide the addition of Vector messages.

Parameters:

  • context – the gRPC Server context.

  • stream – the gRPC stream.

Returns:

::grpc::Status

::grpc::Status MultiplyVectors(::grpc::ServerContext *context, ::grpc::ServerReaderWriter<::grpcdemo::Vector, ::grpcdemo::Vector> *stream) override#

Method to provide the dot product of Vector messages.

Parameters:

  • context – the gRPC Server context.

  • stream – the gRPC stream.

Returns:

::grpc::Status

::grpc::Status AddMatrices(::grpc::ServerContext *context, ::grpc::ServerReaderWriter<::grpcdemo::Matrix, ::grpcdemo::Matrix> *stream) override#

Method to provide the addition of Matrix messages.

Parameters:

  • context – the gRPC Server context.

  • stream – the gRPC stream.

Returns:

::grpc::Status

::grpc::Status MultiplyMatrices(::grpc::ServerContext *context, ::grpc::ServerReaderWriter<::grpcdemo::Matrix, ::grpcdemo::Matrix> *stream) override#

Method to provide the multiplication of Matrix messages.

Parameters:

  • context – the gRPC Server context.

  • stream – the gRPC stream.

Returns:

::grpc::Status

Private Functions

Eigen::VectorXd deserialize_vector(const std::string &bytes, const int length, grpcdemo::DataType type)#

Method used to deserialize a Vector message into an Eigen::VectorXd object.

Parameters:

  • bytes – the chunk of bytes from where the vector is deserialized.

  • length – the length of the vector we are deserializing.

  • type – the type of data inside the vector (e.g. double, int…).

Returns:

Eigen::VectorXd

std::string serialize_vector(const Eigen::VectorXd &vector, const int start, const int end)#

Method used to serialize an Eigen::VectorXd object into a Vector message.

Parameters:

  • vector – the Eigen::VectorXd to be serialized.

  • start – the starting index to serialize.

  • end – the last index to serialize (not included).

Returns:

std::string

Eigen::MatrixXd deserialize_matrix(const std::string &bytes, const int rows, const int cols, grpcdemo::DataType type)#

Method used to deserialize a Matrix message into an Eigen::MatrixXd object.

Parameters:

  • bytes – the chunk of bytes from where the matrix is deserialized.

  • rows – the number of rows of the matrix we are deserializing.

  • cols – the number of columns of the matrix we are deserializing.

  • type – the type of data inside the matrix (e.g. double, int…).

Returns:

Eigen::MatrixXd

std::string serialize_matrix(const Eigen::MatrixXd &matrix, const int start, const int end)#

Method used to serialize an Eigen::MatrixXd object into a Matrix message.

Parameters:

  • matrix – the Eigen::MatrixXd to be serialized.

  • start – the starting index to serialize.

  • end – the last index to serialize (not included).

Returns:

std::string

std::vector<Eigen::VectorXd> receive_vectors(::grpc::ServerReaderWriter<grpcdemo::Vector, grpcdemo::Vector> *reader_writer, ::grpc::ServerContext *context)#

Method in charge of providing a set of Eigen::VectorXd objects from a stream of Vector messages.

Parameters:

  • reader_writer – the gRPC reader-writer in the bidirectional stream protocol.

  • context – the gRPC context.

Returns:

std::vector<Eigen::VectorXd>

std::vector<Eigen::MatrixXd> receive_matrices(::grpc::ServerReaderWriter<grpcdemo::Matrix, grpcdemo::Matrix> *reader_writer, ::grpc::ServerContext *context)#

Method in charge of providing a set of Eigen::MatrixXd objects from a stream of Matrix messages.

Parameters:

  • reader_writer – the gRPC reader-writer in the bidirectional stream protocol.

  • context – the gRPC context.

Returns:

std::vector<Eigen::MatrixXd>

void send_vector(::grpc::ServerReaderWriter<grpcdemo::Vector, grpcdemo::Vector> *reader_writer, ::grpc::ServerContext *context, const Eigen::VectorXd &vector)#

Method in charge of sending the resulting vector of the operation through the protocol.

Parameters:

  • reader_writer – the gRPC reader-writer in the bidirectional stream protocol.

  • context – the gRPC context.

  • vector – the vector to be sent.

void send_matrix(::grpc::ServerReaderWriter<grpcdemo::Matrix, grpcdemo::Matrix> *reader_writer, ::grpc::ServerContext *context, const Eigen::MatrixXd &matrix)#

Method in charge of sending the resulting matrix of the operation through the protocol.

Parameters:

  • reader_writer – the gRPC reader-writer in the bidirectional stream protocol.

  • context – the gRPC context.

  • matrix – the matrix to be sent.

Private Members

bool _debug_log#

Boolean indicating whether to show the debugging logs or not.