15.14. Request-Reply communication
This section explains how to configure a Request-Reply communication in Fast DDS between two applications. A Client application will send a Request to the Server application and this one, after processing the request, will send a Reply to the Client application.
15.14.1. Overview
This kind of communication involves in the DDS paradigm the usage of two Topics: one for sending requests (Request Topic) and the other one for sending replies (Reply Topic). For managing these Topics four DDS entities are involved: a DataReader and a DataWriter for each Topic. The DDS communication schema will be:
The key for making Request-Reply work is relating the Request with the Reply in the client’s side.
Fast DDS API provides SampleIdentity
to achieve this.
A full example can be found in Fast DDS repository.
15.14.2. Getting started
For Request-Reply communication perform the following steps:
Define two structures in an IDL file. One structure will be used as Request Topic’s data type and the other one as Reply Topic’s data type.
enum OperationType { ADDITION, SUBSTRACTION, MULTIPLICATION, DIVISION }; struct RequestType { OperationType operation; long x; long y; }; struct ReplyType { long long z; };
In the client application, create a DataWriter for the request and a DataReader for the reply.
participant->register_type(request_type); participant->register_type(reply_type); Topic* request_topic = participant->create_topic("CalculatorRequest", request_type.get_type_name(), TOPIC_QOS_DEFAULT); Topic* reply_topic = participant->create_topic("CalculatorReply", reply_type.get_type_name(), TOPIC_QOS_DEFAULT); DataWriter* request_writer = publisher->create_datawriter(request_topic, DATAWRITER_QOS_DEFAULT); DataReader* reply_reader = subscriber->create_datareader(reply_topic, DATAREADER_QOS_DEFAULT, &listener);
In the server application, create a DataWriter for the reply and a DataReader for the request.
participant->register_type(request_type); participant->register_type(reply_type); Topic* request_topic = participant->create_topic("CalculatorRequest", request_type.get_type_name(), TOPIC_QOS_DEFAULT); Topic* reply_topic = participant->create_topic("CalculatorReply", reply_type.get_type_name(), TOPIC_QOS_DEFAULT); DataWriter* reply_writer = publisher->create_datawriter(reply_topic, DATAWRITER_QOS_DEFAULT); DataReader* request_reader = subscriber->create_datareader(request_topic, DATAREADER_QOS_DEFAULT, &listener);
15.14.3. Sending the request and storing the assigned identifier
For sending the request, the client application should retrieve and store the internal identifier assigned to the
published sample.
Therefore the sample should be published using the overloaded write()
function which second argument is
a reference to a WriteParams
object.
The assigned identifier will be stored in the WriteParams
’s attribute sample_identity()
.
eprosima::fastdds::rtps::SampleIdentity my_request_sample_identity;
RequestType request;
// Fill the request
// Publish request
eprosima::fastdds::rtps::WriteParams write_params;
request_writer->write(static_cast<void*>(&request), write_params);
// Store sample identity
my_request_sample_identity = write_params.sample_identity();
15.14.4. Receiving the request and sending a reply associated with it
When the server application receives the request (for example through on_data_available()
),
it has to retrieve the request’s identifier using sample_identity
.
void on_data_available(
eprosima::fastdds::dds::DataReader* reader) override
{
RequestType request;
eprosima::fastdds::dds::SampleInfo sample_info;
reader->take_next_sample(&request, &sample_info);
if (eprosima::fastdds::dds::InstanceStateKind::ALIVE_INSTANCE_STATE == sample_info.instance_state)
{
// Store the request identity.
eprosima::fastdds::rtps::SampleIdentity client_request_identity = sample_info.sample_identity;
}
}
After processing the request, the server should send the reply to the client with the related request attached.
This is done assigning the stored identifier in related_sample_identity()
.
ReplyType reply;
// Fill reply
// Send reply associating it with the client request.
eprosima::fastdds::rtps::WriteParams write_params;
write_params.related_sample_identity() = client_request_identity;
reply_writer->write(reinterpret_cast<void*>(&reply), write_params);
15.14.5. Identifying the reply for the client
When the client application receives a reply (for example through on_data_available()
),
the client application should identify if the received reply is the one expected for its request.
For this the client application has to compare the stored SampleIdentity
with the incoming
related_sample_identity
.
void on_data_available(
eprosima::fastdds::dds::DataReader* reader) override
{
ReplyType reply;
eprosima::fastdds::dds::SampleInfo sample_info;
reader->take_next_sample(&reply, &sample_info);
if (eprosima::fastdds::dds::InstanceStateKind::ALIVE_INSTANCE_STATE == sample_info.instance_state)
{
if (sample_info.related_sample_identity == my_request_sample_identity)
{
// Work to do
}
}
}