<<interface>> Listener for participant status. More...
Additional Inherited Members | |
 Public Member Functions inherited from TopicListener | |
| void | on_inconsistent_topic (Topic topic, InconsistentTopicStatus status) |
| Handle the com.rti.dds.infrastructure.StatusKind.StatusKind.INCONSISTENT_TOPIC_STATUS status. More... | |
| Public Member Functions inherited from DataWriterListener | |
| void | on_offered_deadline_missed (DataWriter writer, OfferedDeadlineMissedStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.OFFERED_DEADLINE_MISSED_STATUS status. More... | |
| void | on_offered_incompatible_qos (DataWriter writer, OfferedIncompatibleQosStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.OFFERED_INCOMPATIBLE_QOS_STATUS status. More... | |
| void | on_liveliness_lost (DataWriter writer, LivelinessLostStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.LIVELINESS_LOST_STATUS status. More... | |
| void | on_publication_matched (DataWriter writer, PublicationMatchedStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.PUBLICATION_MATCHED_STATUS status. More... | |
| void | on_reliable_writer_cache_changed (DataWriter writer, ReliableWriterCacheChangedStatus status) |
| <<extension>> A change has occurred in the writer's cache of unacknowledged samples. More... | |
| void | on_reliable_reader_activity_changed (DataWriter writer, ReliableReaderActivityChangedStatus status) |
| <<extension>> A matched reliable reader has become active or become inactive. More... | |
| void | on_sample_removed (DataWriter writer, Cookie_t cookie) |
| <<extension>> Called when a sample is removed from the DataWriter queue. More... | |
| void | on_instance_replaced (DataWriter writer, InstanceHandle_t handle) |
| <<extension>> Notifies when an instance is replaced in DataWriter queue. More... | |
| void | on_application_acknowledgment (DataWriter writer, AcknowledgmentInfo info) |
| <<extension>> Called when a sample is application-acknowledged More... | |
| void | on_service_request_accepted (DataWriter writer, ServiceRequestAcceptedStatus status) |
| <<extension>> Called when a com.rti.dds.topic.builtin.ServiceRequest for the com.rti.dds.subscription.TopicQuery service is dispatched to this com.rti.dds.publication.DataWriter for processing. More... | |
| Public Member Functions inherited from SubscriberListener | |
| void | on_data_on_readers (Subscriber subs) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.DATA_ON_READERS_STATUS communication status. More... | |
| Public Member Functions inherited from DataReaderListener | |
| void | on_requested_deadline_missed (DataReader reader, RequestedDeadlineMissedStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.REQUESTED_DEADLINE_MISSED_STATUS communication status. More... | |
| void | on_requested_incompatible_qos (DataReader reader, RequestedIncompatibleQosStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.REQUESTED_INCOMPATIBLE_QOS_STATUS communication status. More... | |
| void | on_sample_rejected (DataReader reader, SampleRejectedStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.SAMPLE_REJECTED_STATUS communication status. More... | |
| void | on_liveliness_changed (DataReader reader, LivelinessChangedStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.LIVELINESS_CHANGED_STATUS communication status. More... | |
| void | on_data_available (DataReader reader) |
| Handle the com.rti.dds.infrastructure.StatusKind.StatusKind.DATA_AVAILABLE_STATUS communication status. More... | |
| void | on_sample_lost (DataReader reader, SampleLostStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.SAMPLE_LOST_STATUS_STATUS communication status. More... | |
| void | on_subscription_matched (DataReader reader, SubscriptionMatchedStatus status) |
| Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.SUBSCRIPTION_MATCHED_STATUS communication status. More... | |
Detailed Description
<<interface>> Listener for participant status.
- Status:
- Status Kinds
This is the interface that can be implemented by an application-provided class and then registered with the com.rti.dds.domain.DomainParticipant such that the application can be notified by RTI Connext of relevant status changes.
The com.rti.dds.domain.DomainParticipantListener interface extends all other Listener interfaces and has no additional operation beyond the ones defined by the more general listeners.
The purpose of the com.rti.dds.domain.DomainParticipantListener is to be the listener of last resort that is notified of all status changes not captured by more specific listeners attached to the com.rti.dds.infrastructure.DomainEntity objects. When a relevant status change occurs, RTI Connext will first attempt to notify the listener attached to the concerned com.rti.dds.infrastructure.DomainEntity if one is installed. Otherwise, RTI Connext will notify the Listener attached to the com.rti.dds.domain.DomainParticipant.
Important: Because a com.rti.dds.domain.DomainParticipantListener 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 com.rti.dds.domain.DomainParticipantListener 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.)