DDSDomainParticipantListener Class Reference

<<interface>> Listener for participant status. More...

Inheritance diagram for DDSDomainParticipantListener:

Public Member Functions
virtual void	on_invalid_local_identity_status_advance_notice (DDSDomainParticipant *participant, const DDS_InvalidLocalIdentityAdvanceNoticeStatus &status)
	Notifies the user that the identity of the local DDSDomainParticipant is about to expire. More...
Public Member Functions inherited from DDSTopicListener
virtual void	on_inconsistent_topic (DDSTopic *topic, const DDS_InconsistentTopicStatus &status)
	Handle the DDS_INCONSISTENT_TOPIC_STATUS status. More...
Public Member Functions inherited from DDSDataWriterListener
virtual void	on_offered_deadline_missed (DDSDataWriter *writer, const DDS_OfferedDeadlineMissedStatus &status)
	Handles the DDS_OFFERED_DEADLINE_MISSED_STATUS status. More...
virtual void	on_liveliness_lost (DDSDataWriter *writer, const DDS_LivelinessLostStatus &status)
	Handles the DDS_LIVELINESS_LOST_STATUS status. More...
virtual void	on_offered_incompatible_qos (DDSDataWriter *writer, const DDS_OfferedIncompatibleQosStatus &status)
	Handles the DDS_OFFERED_INCOMPATIBLE_QOS_STATUS status. More...
virtual void	on_publication_matched (DDSDataWriter *writer, const DDS_PublicationMatchedStatus &status)
	Handles the DDS_PUBLICATION_MATCHED_STATUS status. More...
virtual void	on_reliable_writer_cache_changed (DDSDataWriter *writer, const DDS_ReliableWriterCacheChangedStatus &status)
	<<extension>> A change has occurred in the writer's cache of unacknowledged samples. More...
virtual void	on_reliable_reader_activity_changed (DDSDataWriter *writer, const DDS_ReliableReaderActivityChangedStatus &status)
	<<extension>> A matched reliable reader has become active or become inactive. More...
virtual void	on_sample_removed (DDSDataWriter *writer, const DDS_Cookie_t &cookie)
	<<extension>> Called when a sample is removed from the DataWriter queue. More...
virtual void	on_instance_replaced (DDSDataWriter *writer, const DDS_InstanceHandle_t &handle)
	<<extension>> Notifies when an instance is replaced in DataWriter queue. More...
virtual void	on_application_acknowledgment (DDSDataWriter *writer, const DDS_AcknowledgmentInfo &info)
	<<extension>> Called when a sample is application-acknowledged More...
virtual void	on_service_request_accepted (DDSDataWriter *writer, const DDS_ServiceRequestAcceptedStatus &status)
	<<extension>> Called when a DDS_ServiceRequest for the DDSTopicQuery service is dispatched to this DDSDataWriter for processing. More...
Public Member Functions inherited from DDSSubscriberListener
virtual void	on_data_on_readers (DDSSubscriber *sub)
	Handles the DDS_DATA_ON_READERS_STATUS communication status. More...
Public Member Functions inherited from DDSDataReaderListener
virtual void	on_requested_deadline_missed (DDSDataReader *reader, const DDS_RequestedDeadlineMissedStatus &status)
	Handles the DDS_REQUESTED_DEADLINE_MISSED_STATUS communication status. More...
virtual void	on_liveliness_changed (DDSDataReader *reader, const DDS_LivelinessChangedStatus &status)
	Handles the DDS_LIVELINESS_CHANGED_STATUS communication status. More...
virtual void	on_requested_incompatible_qos (DDSDataReader *reader, const DDS_RequestedIncompatibleQosStatus &status)
	Handles the DDS_REQUESTED_INCOMPATIBLE_QOS_STATUS communication status. More...
virtual void	on_sample_rejected (DDSDataReader *reader, const DDS_SampleRejectedStatus &status)
	Handles the DDS_SAMPLE_REJECTED_STATUS communication status. More...
virtual void	on_data_available (DDSDataReader *reader)
	Handle the DDS_DATA_AVAILABLE_STATUS communication status. More...
virtual void	on_sample_lost (DDSDataReader *reader, const DDS_SampleLostStatus &status)
	Handles the DDS_SAMPLE_LOST_STATUS communication status. More...
virtual void	on_subscription_matched (DDSDataReader *reader, const DDS_SubscriptionMatchedStatus &status)
	Handles the DDS_SUBSCRIPTION_MATCHED_STATUS communication status. More...

Detailed Description

<<interface>> Listener for participant status.

Entity:

DDSDomainParticipant

Status:

Status Kinds

This is the interface that can be implemented by an application-provided class and then registered with the DDSDomainParticipant such that the application can be notified by RTI Connext of relevant status changes.

The DDSDomainParticipantListener interface extends all other Listener interfaces and has no additional operation beyond the ones defined by the more general listeners.

The purpose of the DDSDomainParticipantListener is to be the listener of last resort that is notified of all status changes not captured by more specific listeners attached to the DDSDomainEntity objects. When a relevant status change occurs, RTI Connext will first attempt to notify the listener attached to the concerned DDSDomainEntity if one is installed. Otherwise, RTI Connext will notify the Listener attached to the DDSDomainParticipant.

Important: Because a DDSDomainParticipantListener may receive callbacks pertaining to many different entities, it is possible for the same listener to receive multiple callbacks simultaneously in different threads. (Such is not the case for listeners of other types.) It is therefore critical that users of this listener provide their own protection for any thread-unsafe activities undertaken in a DDSDomainParticipantListener callback.

Note: Due to a thread-safety issue, the destruction of a DomainParticipantListener from an enabled DomainParticipant should be avoided – even if the DomainParticipantListener has been removed from the DomainParticipant. (This limitation does not affect the Java API.)

See also

DDSListener

DDSDomainParticipant::set_listener

Member Function Documentation

on_invalid_local_identity_status_advance_notice()

virtual void DDSDomainParticipantListener::on_invalid_local_identity_status_advance_notice ( DDSDomainParticipant *  participant, const DDS_InvalidLocalIdentityAdvanceNoticeStatus &  status  )

virtual

Notifies the user that the identity of the local DDSDomainParticipant is about to expire.