DDS::PropertyQosPolicy Class Reference
[PROPERTY]
Stores name/value(string) pairs that can be used to configure certain parameters of RTI Data Distribution Service that are not exposed through formal QoS policies. Can also be used to store and propagate application-specific name/value pairs that can be retrieved by user code during discovery.
More...
#include <managed_infrastructure.h>
List of all members.
Detailed Description
Stores name/value(string) pairs that can be used to configure certain parameters of RTI Data Distribution Service that are not exposed through formal QoS policies. Can also be used to store and propagate application-specific name/value pairs that can be retrieved by user code during discovery.
- Entity:
- DDS::DomainParticipant DDS::DataReader DDS::DataWriter
- Properties:
- RxO = N/A;
Changeable = YES
- See also:
- DDS::DomainParticipant::get_builtin_subscriber
The PROPERTY QoS policy can be used to associate a set of properties in the form of (name,value) pairs with a
DDS::DataReader,
DDS::DataWriter, or
DDS::DomainParticipant. This is similar to the
DDS::UserDataQosPolicy, except this policy uses (name, value) pairs, and you can select whether or not a particular pair should be propagated (included in the builtin topic).
This QoS policy may be used to configure:
In addition, you may add your own name/value pairs to the Property QoS policy of an
Entity. Via this QoS policy, you can direct RTI Data Distribution Service to propagate these name/value pairs with the discovery information for the
Entity. Applications that discover the
Entity can then access the user-specific name/value pairs in the discovery information of the remote
Entity. This allows you to add meta-information about an
Entity for application-specific use, for example, authentication/authorization certificates (which can also be done using the
DDS::UserDataQosPolicy or
DDS::GroupDataQosPolicy).
- Supports dynamic loading of extension transports (such as RTI Secure WAN Transport)
- Supports multiple instances of the builtin transports
- Allows full pluggable transport configuration for non-C/C++ language bindings (Java, .NET, etc.)
- Avoids the process of creating entities disabled, changing their QoS settings, then enabling them
- Allows selection of clock
Some of the RTI Data Distribution Service capabilities configurable via the Property QoS policy can also be configured in code via APIs. However, the Property QoS policy allows you to configure those parameters via XML files. In addition, some of the configuration APIs will only work if the
Entity was created in a disabled state and then enabled after the configuration change was applied. By configuring those parameters using the Property QoS policy during entity creation, you avoid the additional work of first creating a disabled entity and then enabling it afterwards.
There are helper functions to facilitate working with properties, see the DDS::PropertyQosPolicyHelper class on the PROPERTY page.
Member Data Documentation
Sequence of properties.
[default] An empty list.