RTI Connext Java API  Version 5.1.0
ViewStateKind Class Reference

Indicates whether or not an instance is new. More...

Static Public Attributes

static final int NEW_VIEW_STATE = 0x0001 << 0
 New instance. This latest generation of the instance has not previously been accessed.
 
static final int NOT_NEW_VIEW_STATE = 0x0001 << 1
 Not a new instance. This latest generation of the instance has previously been accessed.
 
static final int ANY_VIEW_STATE = 0xffff
 Any view state com.rti.dds.subscription.ViewStateKind.ViewStateKind.NEW_VIEW_STATE | com.rti.dds.subscription.ViewStateKind.ViewStateKind.NOT_NEW_VIEW_STATE.
 

Detailed Description

Indicates whether or not an instance is new.

For each instance (identified by the key), the middleware internally maintains a view state relative to each com.rti.dds.subscription.DataReader. The view state can be either:

  • com.rti.dds.subscription.ViewStateKind.ViewStateKind.NOT_NEW_VIEW_STATE indicates that the com.rti.dds.subscription.DataReader has already accessed samples of the same instance and that the instance has not been reborn since.

The view_state available in the com.rti.dds.subscription.SampleInfo is a snapshot of the view state of the instance relative to the com.rti.dds.subscription.DataReader used to access the samples at the time the collection was obtained (i.e. at the time read or take was called). The view_state is therefore the same for all samples in the returned collection that refer to the same instance.

Once an instance has been detected as not having any "live" writers and all the samples associated with the instance are "taken" from the com.rti.dds.subscription.DataReader, the middleware can reclaim all local resources regarding the instance. Future samples will be treated as "never seen."

Member Data Documentation

final int NEW_VIEW_STATE = 0x0001 << 0
static

New instance. This latest generation of the instance has not previously been accessed.

final int NOT_NEW_VIEW_STATE = 0x0001 << 1
static

Not a new instance. This latest generation of the instance has previously been accessed.


RTI Connext Java API Version 5.1.0 Copyright © Mon Feb 3 2014 Real-Time Innovations, Inc