DDS::DataReaderListener Class Reference
[DDS Listeners]

The DataReaderListener provides asynchronous notification of DataReader events. More...

Inheritance diagram for DDS::DataReaderListener:

List of all members.

Public Member Functions
virtual void	on_requested_deadline_missed (DataReader *, RequestedDeadlineMissedStatus)
virtual void	on_requested_incompatible_qos (DataReader *, RequestedIncompatibleQosStatus)
virtual void	on_sample_rejected (DataReader *, SampleRejectedStatus)
virtual void	on_liveliness_changed (DataReader *, LivelinessChangedStatus)
virtual void	on_data_available (DataReader *)
virtual void	on_subscription_matched (DataReader *, SubscriptionMatchedStatus)
virtual void	on_sample_lost (DataReader *, SampleLostStatus)

---

Detailed Description

The DataReaderListener provides asynchronous notification of DataReader events.

This listener can be installed during DataReader creation, Subscriber_create_datareader(), as well as by calling DataReader_set_listener().

Note:

The listener callback methods should be lightweight and should not block. If a callback method blocks, it will block all other callback operations within the same DomainParticipant.

---

Member Function Documentation

virtual void DDS::DataReaderListener::on_data_available

(

DataReader *

)

[inline, virtual]

on_data_available() is called when the CoreDX DDS middleware detects that new data or data state information is available.

The status argument provides a snapshot of the status at the time the listener was invoked.

virtual void DDS::DataReaderListener::on_liveliness_changed	(	DataReader *	,
		LivelinessChangedStatus
	)			[inline, virtual]

on_liveliness_changed() is called when the CoreDX DDS middleware detects that the liveliness of a matched DataWriter has changed (either 'active' or 'inactive').

The status argument provides a snapshot of the status at the time the listener was invoked.

virtual void DDS::DataReaderListener::on_requested_deadline_missed	(	DataReader *	,
		RequestedDeadlineMissedStatus
	)			[inline, virtual]

on_requested_deadline_missed() is called when the CoreDX DDS middleware detects that the deadline specified in the DataReader QoS DEADLINE policy was not satisfied for a data instance.

The status argument provides a snapshot of the status at the time the listener was invoked.

virtual void DDS::DataReaderListener::on_requested_incompatible_qos	(	DataReader *	,
		RequestedIncompatibleQosStatus
	)			[inline, virtual]

on_requested_incompatible_qos() is called when the CoreDX DDS middleware detects that the DataReader requested a QoS policy that was incompatible with that offered by a DataWriter.

The status argument provides a snapshot of the status at the time the listener was invoked.

virtual void DDS::DataReaderListener::on_sample_lost	(	DataReader *	,
		SampleLostStatus
	)			[inline, virtual]

on_sample_lost() is called when the CoreDX DDS middleware detects that a sample has been lost (never received).

The status argument provides a snapshot of the status at the time the listener was invoked.

virtual void DDS::DataReaderListener::on_sample_rejected	(	DataReader *	,
		SampleRejectedStatus
	)			[inline, virtual]

on_sample_rejected() is called when the CoreDX DDS middleware detects that a sample has been rejected.

The status argument provides a snapshot of the status at the time the listener was invoked.

virtual void DDS::DataReaderListener::on_subscription_matched	(	DataReader *	,
		SubscriptionMatchedStatus
	)			[inline, virtual]

on_subscription_matched() is called when the CoreDX DDS middleware detects that the DataReader has matched or ceased to be matched with a DataWriter.

The status argument provides a snapshot of the status at the time the listener was invoked.