RTI Connext C API
Version 5.3.0
|
Working with large data types. More...
Working with large data types.
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_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.
In order to use the large data feature with the DDS_RELIABLE_RELIABILITY_QOS setting, the DDS_DataWriter must be configured as an asynchronous writer (DDS_ASYNCHRONOUS_PUBLISH_MODE_QOS) with associated DDS_FlowController.
While the use of an asynchronous writer and flow controller is optional when using the DDS_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.
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.