RTI Connext Java API Version 7.3.0
|
<<extension>> A summary of the state of a data writer's cache of unacknowledged samples written. More...
Inherits Status.
Public Member Functions | |
ReliableWriterCacheChangedStatus () | |
Construct a new status object. More... | |
ReliableWriterCacheChangedStatus (ReliableWriterCacheChangedStatus src) | |
A copy constructor. More... | |
Public Attributes | |
final ReliableWriterCacheEventCount | empty_reliable_writer_cache |
The number of times the reliable writer's cache of unacknowledged samples has become empty. More... | |
final ReliableWriterCacheEventCount | full_reliable_writer_cache = new ReliableWriterCacheEventCount() |
The number of times the reliable writer's cache, or send window, of unacknowledged samples has become full. More... | |
final ReliableWriterCacheEventCount | low_watermark_reliable_writer_cache |
The number of times the reliable writer's cache of unacknowledged samples has fallen to the low watermark. More... | |
final ReliableWriterCacheEventCount | high_watermark_reliable_writer_cache |
The number of times the reliable writer's cache of unacknowledged samples has risen to the high watermark. More... | |
int | unacknowledged_sample_count |
The current number of unacknowledged samples in the writer's cache. More... | |
int | unacknowledged_sample_count_peak |
The highest value that unacknowledged_sample_count has reached until now. More... | |
long | replaced_unacknowledged_sample_count |
The number of unacknowledged samples that have been replaced in the writer's cache. More... | |
<<extension>> A summary of the state of a data writer's cache of unacknowledged samples written.
A written sample is unacknowledged (and therefore accounted for in this status) if the writer is reliable and one or more readers matched with the writer has not yet sent an acknowledgement to the writer declaring that it has received the sample.
If the low watermark is zero and the unacknowledged sample count decreases to zero, both the low watermark and cache empty events are considered to have taken place. A single callback will be dispatched (assuming the user has requested one) that contains both status changes. The same logic applies when the high watermark is set equal to the maximum number of samples and the cache becomes full.
Construct a new status object.
A copy constructor.
src | Source to copy from. |
NullPointerException | if the source object is null. |
References ReliableWriterCacheChangedStatus.empty_reliable_writer_cache, ReliableWriterCacheChangedStatus.full_reliable_writer_cache, ReliableWriterCacheChangedStatus.high_watermark_reliable_writer_cache, ReliableWriterCacheChangedStatus.low_watermark_reliable_writer_cache, ReliableWriterCacheChangedStatus.replaced_unacknowledged_sample_count, ReliableWriterCacheChangedStatus.unacknowledged_sample_count, and ReliableWriterCacheChangedStatus.unacknowledged_sample_count_peak.
final ReliableWriterCacheEventCount empty_reliable_writer_cache |
The number of times the reliable writer's cache of unacknowledged samples has become empty.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().
final ReliableWriterCacheEventCount full_reliable_writer_cache = new ReliableWriterCacheEventCount() |
The number of times the reliable writer's cache, or send window, of unacknowledged samples has become full.
Applies to writer's cache when the send window is enabled (when both com.rti.dds.infrastructure.RtpsReliableWriterProtocol_t.min_send_window_size and com.rti.dds.infrastructure.RtpsReliableWriterProtocol_t.max_send_window_size are not com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED).
Otherwise, applies when the number of unacknowledged samples has reached the send window limit.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().
final ReliableWriterCacheEventCount low_watermark_reliable_writer_cache |
The number of times the reliable writer's cache of unacknowledged samples has fallen to the low watermark.
A low watermark event will only be considered to have taken place when the number of unacknowledged samples in the writer's cache decreases to this value. A sample count that increases to this value will not result in a callback or in a change to the total count of low watermark events.
When the writer's send window is enabled, the low watermark is scaled down, if necessary, to fit within the current send window.
Set the low watermark value using the com.rti.dds.infrastructure.RtpsReliableWriterProtocol_t.low_watermark field of the com.rti.dds.infrastructure.RtpsReliableWriterProtocol_t structure.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().
final ReliableWriterCacheEventCount high_watermark_reliable_writer_cache |
The number of times the reliable writer's cache of unacknowledged samples has risen to the high watermark.
A high watermark event will only be considered to have taken place when the number of unacknowledged sampled increases to this value. A sample count that was above this value and then decreases back to it will not trigger an event.
When the writer's send window is enabled, the high watermark is scaled down, if necessary, to fit within the current send window.
Set the high watermark value using the com.rti.dds.infrastructure.RtpsReliableWriterProtocol_t.high_watermark field of the com.rti.dds.infrastructure.RtpsReliableWriterProtocol_t structure.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().
int unacknowledged_sample_count |
The current number of unacknowledged samples in the writer's cache.
A sample is considered unacknowledged if the writer has failed to receive an acknowledgement from one or more reliable readers matched to it.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().
int unacknowledged_sample_count_peak |
The highest value that unacknowledged_sample_count has reached until now.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().
long replaced_unacknowledged_sample_count |
The number of unacknowledged samples that have been replaced in the writer's cache.
Total number of unacknowledged samples that have been replaced by a DataWriter after applying com.rti.dds.infrastructure.HistoryQosPolicyKind.HistoryQosPolicyKind.KEEP_LAST_HISTORY_QOS policy.
Referenced by ReliableWriterCacheChangedStatus.ReliableWriterCacheChangedStatus().