Sets the kinds of instances that can be replaced when instance resource limits (com.rti.dds.infrastructure.ResourceLimitsQosPolicy.max_instances) are reached. More...
Static Public Attributes | |
| static final DataReaderInstanceRemovalKind | NO_INSTANCE_REMOVAL |
| No instance can be removed. More... | |
| static final DataReaderInstanceRemovalKind | EMPTY_INSTANCE_REMOVAL |
| Only empty instances can be removed. More... | |
| static final DataReaderInstanceRemovalKind | FULLY_PROCESSED_INSTANCE_REMOVAL |
| Only fully-processed instances can be removed. More... | |
| static final DataReaderInstanceRemovalKind | ANY_INSTANCE_REMOVAL |
| Any instance can be removed. More... | |
Additional Inherited Members | |
 Public Member Functions inherited from Enum | |
| final int | ordinal () |
| The integral value of this enumerated constant. More... | |
| Object | copy_from (Object src) |
| final String | name () |
| The name of this enum constant, as declared in the enum declaration. More... | |
| final String | toString () |
| The string value of this enum constant. More... | |
| Protected Member Functions inherited from Enum | |
| Enum (String name, int ordinal) | |
| The constructor. More... | |
| final Object | clone () throws CloneNotSupportedException |
Detailed Description
Sets the kinds of instances that can be replaced when instance resource limits (com.rti.dds.infrastructure.ResourceLimitsQosPolicy.max_instances) are reached.
Member Data Documentation
◆ NO_INSTANCE_REMOVAL
|
static |
No instance can be removed.
If an instance resource is required because com.rti.dds.infrastructure.ResourceLimitsQosPolicy.max_instances is reached, this setting will disallow instances from being replaced. Samples for new instances will be dropped and reported as lost with reason com.rti.dds.subscription.SampleLostStatusKind.LOST_BY_INSTANCES_LIMIT.
◆ EMPTY_INSTANCE_REMOVAL
|
static |
Only empty instances can be removed.
Instances can be replaced only if they are empty. An instance is considered empty when all samples have been taken or removed from the DataReader queue due to the com.rti.dds.infrastructure.LifespanQosPolicy or sample purging due to the com.rti.dds.infrastructure.ReaderDataLifecycleQosPolicy, and there are no outstanding loans on any of the instance's samples.
◆ FULLY_PROCESSED_INSTANCE_REMOVAL
|
static |
Only fully-processed instances can be removed.
An instance is considered fully processed if every sample for the instance has been processed by the application. A sample is considered processed by the application depending on the com.rti.dds.infrastructure.ReliabilityQosPolicy.kind:
-
com.rti.dds.infrastructure.ReliabilityQosPolicyKind.RELIABLE_RELIABILITY_QOS (depends on the com.rti.dds.infrastructure.ReliabilityQosPolicyAcknowledgmentModeKind):
- com.rti.dds.infrastructure.ReliabilityQosPolicyAcknowledgmentModeKind.PROTOCOL_ACKNOWLEDGMENT_MODE or com.rti.dds.infrastructure.ReliabilityQosPolicyAcknowledgmentModeKind.APPLICATION_AUTO_ACKNOWLEDGMENT_MODE: The sample is considered processed when it has been read or taken by the application and return_loan has been called.
- com.rti.dds.infrastructure.ReliabilityQosPolicyAcknowledgmentModeKind.APPLICATION_EXPLICIT_ACKNOWLEDGMENT_MODE: The sample is considered processed when the subscribing application has explicitly acknowledged the DDS sample, the AppAckConf has been received, and the application has called return_loan.
- com.rti.dds.infrastructure.ReliabilityQosPolicyKind.BEST_EFFORT_RELIABILITY_QOS: All samples are considered processed when they have been read or taken by the application and return_loan has been called.
◆ ANY_INSTANCE_REMOVAL
|
static |
Any instance can be removed.
Instances can be replaced regardless of whether the subscribing application has processed all of the samples. Samples that have not been processed will be removed.