RTI Connext Java API  Version 5.0.0
DomainParticipantListener Interface Reference

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

Inheritance diagram for DomainParticipantListener:
TopicListener PublisherListener SubscriberListener Listener DataWriterListener DataReaderListener Listener Listener DomainParticipantAdapter

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.
 
- 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.
 
void on_offered_incompatible_qos (DataWriter writer, OfferedIncompatibleQosStatus status)
 Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.OFFERED_INCOMPATIBLE_QOS_STATUS status.
 
void on_liveliness_lost (DataWriter writer, LivelinessLostStatus status)
 Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.LIVELINESS_LOST_STATUS status.
 
void on_publication_matched (DataWriter writer, PublicationMatchedStatus status)
 Handles the com.rti.dds.infrastructure.StatusKind.StatusKind.PUBLICATION_MATCHED_STATUS status.
 
void on_reliable_writer_cache_changed (DataWriter writer, ReliableWriterCacheChangedStatus status)
 <<eXtension>> A change has occurred in the writer's cache of unacknowledged samples.
 
void on_reliable_reader_activity_changed (DataWriter writer, ReliableReaderActivityChangedStatus status)
 <<eXtension>> A matched reliable reader has become active or become inactive.
 
void on_instance_replaced (DataWriter writer, InstanceHandle_t handle)
 Notifies when an instance is replaced in DataWriter queue.
 
- 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.
 

Detailed Description

<<interface>> Listener for participant status.

Entity:
com.rti.dds.domain.DomainParticipant
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.)

See Also
com.rti.dds.infrastructure.Listener
com.rti.dds.domain.DomainParticipant.set_listener

RTI Connext Java API Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc