LivelinessChangedStatus Class Reference
[DataReaders]

StatusKind.LIVELINESS_CHANGED_STATUS. More...

Inherits Status.

List of all members.

Public Member Functions
	LivelinessChangedStatus ()
	The no-argument constructor for this status object.
	LivelinessChangedStatus (LivelinessChangedStatus src)
	A copy constructor.
Public Attributes
int	alive_count
	The total count of currently alive com.rti.dds.publication.DataWriter entities that write the com.rti.dds.topic.Topic the com.rti.dds.subscription.DataReader reads.
int	not_alive_count
	The total count of currently not_alive com.rti.dds.publication.DataWriter entities that write the com.rti.dds.topic.Topic the com.rti.dds.subscription.DataReader reads.
int	alive_count_change
	The change in the alive_count since the last time the listener was called or the status was read.
int	not_alive_count_change
	The change in the not_alive_count since the last time the listener was called or the status was read.
final InstanceHandle_t	last_publication_handle
	An instance handle to the last remote writer to change its liveliness.

---

Detailed Description

StatusKind.LIVELINESS_CHANGED_STATUS.

The com.rti.dds.subscription.DataReaderListener.on_liveliness_changed callback may be invoked for the following reasons:

• Liveliness is truly lost - a sample has not been received within the timeframe specified in com.rti.dds.infrastructure.LivelinessQosPolicy.lease_duration

• Liveliness is recovered after being lost.

• A new matching entity has been discovered.

• A QoS has changed such that a pair of matching entities are no longer matching (such as a change to the com.rti.dds.infrastructure.PartitionQosPolicy). In this case, RTI Connext will no longer keep track of the entities' liveliness. Furthermore:
  • If liveliness was maintained: com.rti.dds.subscription.LivelinessChangedStatus.alive_count will decrease and com.rti.dds.subscription.LivelinessChangedStatus.not_alive_count will remain the same.
  • If liveliness had been lost: com.rti.dds.subscription.LivelinessChangedStatus.alive_count will remain the same and com.rti.dds.subscription.LivelinessChangedStatus.not_alive_count will decrease.

---

Constructor & Destructor Documentation

LivelinessChangedStatus

(

)

The no-argument constructor for this status object.

LivelinessChangedStatus

(

LivelinessChangedStatus

src

)

A copy constructor.

Exceptions:

NullPointerException

if the given status is null.

---

Member Data Documentation

int alive_count

The total count of currently alive com.rti.dds.publication.DataWriter entities that write the com.rti.dds.topic.Topic the com.rti.dds.subscription.DataReader reads.

int not_alive_count

The total count of currently not_alive com.rti.dds.publication.DataWriter entities that write the com.rti.dds.topic.Topic the com.rti.dds.subscription.DataReader reads.

int alive_count_change

The change in the alive_count since the last time the listener was called or the status was read.

int not_alive_count_change

The change in the not_alive_count since the last time the listener was called or the status was read.

final InstanceHandle_t last_publication_handle

An instance handle to the last remote writer to change its liveliness.