17.2.12.3. WriterListener

class WriterListener

Class WriterListener with virtual method so the user can implement callbacks to certain events.

Public Functions

inline virtual void onWriterMatched(RTPSWriter *writer, MatchingInfo &info)

This method is called when a new Reader is matched with this Writer by the builtin protocols

Parameters

  • writer – Pointer to the RTPSWriter.

  • info – Matching Information.

inline virtual void onWriterMatched(RTPSWriter *writer, const eprosima::fastdds::dds::PublicationMatchedStatus &info)

This method is called when a new Reader is matched with this Writer by the builtin protocols

Parameters

  • writer – Pointer to the RTPSWriter.

  • info – Publication matching information.

inline virtual void on_offered_incompatible_qos(RTPSWriter *writer, eprosima::fastdds::dds::PolicyMask qos)

This method is called when a new Reader is discovered, with a Topic that matches that of a local writer, but with a requested QoS that is incompatible with the one offered by the local writer

Parameters

  • writer – Pointer to the RTPSWriter.

  • qos – A mask with the bits of all incompatible Qos activated.

inline virtual void onWriterChangeReceivedByAll(RTPSWriter *writer, CacheChange_t *change)

This method is called when all the readers matched with this Writer acknowledge that a cache change has been received.

Parameters
inline virtual void on_liveliness_lost(RTPSWriter *writer, const LivelinessLostStatus &status)

Method called when the liveliness of a writer is lost.

Parameters

  • writer – The writer

  • status – The liveliness lost status

inline virtual void on_reader_discovery(RTPSWriter *writer, ReaderDiscoveryInfo::DISCOVERY_STATUS reason, const GUID_t &reader_guid, const ReaderProxyData *reader_info)

Method called when the discovery information of a reader regarding a writer changes.

Parameters

  • writer – The writer.

  • reason – The reason motivating this method to be called.

  • reader_guid – The GUID of the reader for which the discovery information changed.

  • reader_info – Discovery information about the reader. Will be nullptr for reason REMOVED_READER.

inline virtual void on_incompatible_type(RTPSWriter *writer)

This method is called when a new Reader is discovered, with a Topic that matches the name of a local writer, but with an incompatible type

Parameters

writer – Pointer to the RTPSWriter.