com.toc.coredx.DDS
Interface DataReaderListener

public interface DataReaderListener

The DDS_DataReaderListener provides asynchronous notification of DDS_DataReader events. his listener can be installed during DataReader creation, DDS_DomainParticipant_create_yyy(), as well as by calling DDS_DataReader_set_listener().

Method Summary

long	get_nil_mask() get_nil_mask() returns a bitmask indicating which listener methods (if any) should be considered NIL, and therefore, should not be invoked.
void	on_data_available(DataReader the_reader) Called when the CoreDX infrastructure detects that new data or data state information is available.
void	on_liveliness_changed(DataReader the_reader, LivelinessChangedStatus status) Called when the CoreDX infrastructure detects that the liveliness of a matched DataWriter has changed (either 'active' or 'inactive').
void	on_requested_deadline_missed(DataReader the_reader, RequestedDeadlineMissedStatus status) Called when the CoreDX infrastructure detects that the deadline specified in the DataReader QoS DEADLINE policy was not satisfied for a data instance.
void	on_requested_incompatible_qos(DataReader the_reader, RequestedIncompatibleQosStatus status) Called when the CoreDX infrastructure detects that the DataReader requested a QoS policy that was incompatible with that offered by a DataWriter.
void	on_sample_lost(DataReader the_reader, SampleLostStatus status) Called when the CoreDX infrastructure detects that a sample has been lost (never received).
void	on_sample_rejected(DataReader the_reader, SampleRejectedStatus status) Called when the CoreDX infrastructure detects that a sample has been rejected.
void	on_subscription_matched(DataReader the_reader, SubscriptionMatchedStatus status) Called when the CoreDX infrastructure detects that the DataReader has matched or ceased to be matched with a DataWriter.

Method Detail

on_requested_deadline_missed

void on_requested_deadline_missed(DataReader the_reader,
                                  RequestedDeadlineMissedStatus status)

Called when the CoreDX infrastructure 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.

on_requested_incompatible_qos

void on_requested_incompatible_qos(DataReader the_reader,
                                   RequestedIncompatibleQosStatus status)

Called when the CoreDX infrastructure 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.

on_sample_rejected

void on_sample_rejected(DataReader the_reader,
                        SampleRejectedStatus status)

Called when the CoreDX infrastructure detects that a sample has been rejected.

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

on_liveliness_changed

void on_liveliness_changed(DataReader the_reader,
                           LivelinessChangedStatus status)

Called when the CoreDX infrastructure 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.

on_data_available

void on_data_available(DataReader the_reader)

Called when the CoreDX infrastructure 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.

on_subscription_matched

void on_subscription_matched(DataReader the_reader,
                             SubscriptionMatchedStatus status)

Called when the CoreDX infrastructure 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.

on_sample_lost

void on_sample_lost(DataReader the_reader,
                    SampleLostStatus status)

Called when the CoreDX infrastructure 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.

get_nil_mask

long get_nil_mask()

get_nil_mask() returns a bitmask indicating which listener methods (if any) should be considered NIL, and therefore, should not be invoked.