com.toc.coredx.DDS
Interface PublisherListener

public interface PublisherListener

The DDS_PublisherListener provides asynchronous notification of DDS_Publisher events. This listener can be installed during Publisher creation DDS_DomainParticipant_create_publisher(), as well as by calling DDS_Publisher_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_liveliness_lost(DataWriter writer, LivelinessLostStatus status) Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has not satisfied its LIVELINESS QoS setting.
void	on_offered_deadline_missed(DataWriter writer, OfferedDeadlineMissedStatus status) Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has failed to meet its DEADLINE QoS commitment.
void	on_offered_incompatible_qos(DataWriter writer, OfferedIncompatibleQosStatus status) Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has offered a QoS policy setting that is incompatible with that requested by a potentially matching DataReader.
void	on_publication_matched(DataWriter writer, PublicationMatchedStatus status) Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has matched with a DataReader or has ceased to be matched with a DataReader.

Method Detail

on_offered_deadline_missed

void on_offered_deadline_missed(DataWriter writer,
                                OfferedDeadlineMissedStatus status)

Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has failed to meet its DEADLINE QoS commitment. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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

on_offered_incompatible_qos

void on_offered_incompatible_qos(DataWriter writer,
                                 OfferedIncompatibleQosStatus status)

Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has offered a QoS policy setting that is incompatible with that requested by a potentially matching DataReader. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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

on_liveliness_lost

void on_liveliness_lost(DataWriter writer,
                        LivelinessLostStatus status)

Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has not satisfied its LIVELINESS QoS setting. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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

on_publication_matched

void on_publication_matched(DataWriter writer,
                            PublicationMatchedStatus status)

Called when the CoreDX infrastructure detects that a DataWriter contained in the Publisher has matched with a DataReader or has ceased to be matched with a DataReader. This listener is invoked only if the concerned DDS_DataWriter does not have an on_offered_deadline_missed listener installed.

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.