Introduction

RTI Connext supports data types whose size exceeds the maximum message size of the underlying transports. A DDS::DataWriter will fragment data samples when required. Fragments are automatically reassembled at the receiving end.

Once all fragments of a sample have been received, the new sample is passed to the DDS::DataReader which can then make it available to the user. Note that the new sample is treated as a regular sample at that point and its availability depends on standard QoS settings such as DDS::ResourceLimitsQosPolicy::max_samples and ::DDS::HistoryQosPolicyKind::KEEP_LAST_HISTORY_QOS.

The large data feature is fully supported by all DDS API's, so its use is mostly transparent. Some additional considerations apply as explained below.

Writing Large Data

In order to use the large data feature with the ::DDS::ReliabilityQosPolicyKind::RELIABLE_RELIABILITY_QOS setting, the DDS::DataWriter must be configured as an asynchronous writer (::DDS::PublishModeQosPolicyKind::ASYNCHRONOUS_PUBLISH_MODE_QOS) with associated DDS::FlowController.

While the use of an asynchronous writer and flow controller is optional when using the ::DDS::ReliabilityQosPolicyKind::BEST_EFFORT_RELIABILITY_QOS setting, most large data use cases will benefit from the use of a flow controller to prevent flooding the network when fragments are being sent.

Set up writer

Add flow control

Receiving Large Data

Large data is supported by default and in most cases, no further changes are required.

The DDS::DataReaderResourceLimitsQosPolicy allows tuning the resources available to the DDS::DataReader for reassembling fragmented large data.

Set up reader