dds::pub::NoOpDataWriterListener< T > Class Template Reference

DataWriter events Listener. More...

#include "DataWriterListener.hpp"

Inherits dds::pub::DataWriterListener< T >.

Public Member Functions
virtual void	on_liveliness_lost (dds::pub::DataWriter< T > &writer, const dds::core::status::LivelinessLostStatus &status)=0
virtual void	on_offered_deadline_missed (dds::pub::DataWriter< T > &writer, const dds::core::status::OfferedDeadlineMissedStatus &status)=0
virtual void	on_offered_incompatible_qos (dds::pub::DataWriter< T > &writer, const dds::core::status::OfferedIncompatibleQosStatus &status)=0
virtual void	on_publication_matched (dds::pub::DataWriter< T > &writer, const dds::core::status::PublicationMatchedStatus &status)=0

Detailed Description

template<typename T>
class dds::pub::NoOpDataWriterListener< T >

DataWriter events Listener.

This listener is just like DataWriterListener, except that the application doesn't have to implement all operations.

class ExampleListener : public virtual dds::pub::NoOpDataWriterListener<Foo::Bar>
{
   // Not necessary to implement any Listener operations.
};

See also

dds::pub::DataWriterListener

Definition at line 223 of file DataWriterListener.hpp.

Member Function Documentation

on_liveliness_lost()

template<typename T>

virtual void dds::pub::DataWriterListener< T >::on_liveliness_lost ( dds::pub::DataWriter< T > &  writer, const dds::core::status::LivelinessLostStatus &  status  )

pure virtualinherited

This operation is called by the Data Distribution Service when the LivelinessLostStatus changes.

This operation will only be called when the relevant DataWriterListener is installed and enabled for the liveliness lost status (StatusMask::liveliness_lost()). The liveliness lost status will change when the liveliness that the DataWriter has committed through its LivelinessQosPolicy was not respected. In other words, the DataWriter failed to actively signal its liveliness within the offered liveliness period. As a result, the DataReader objects will consider the DataWriter as no longer “alive”.

Parameters

writer	contains a pointer to the DataWriter on which the LivelinessLostStatus has changed (this is an input to the application).
status	contains the LivelinessLostStatus object (this is an input to the application).

on_offered_deadline_missed()

template<typename T>

virtual void dds::pub::DataWriterListener< T >::on_offered_deadline_missed ( dds::pub::DataWriter< T > &  writer, const dds::core::status::OfferedDeadlineMissedStatus &  status  )

pure virtualinherited

This operation is called by the Data Distribution Service when the OfferedDeadlineMissedStatus changes.

This operation will only be called when the relevant DataWriterListener is installed and enabled for the offered deadline missed status (StatusMask::offered_deadline_missed()). The offered deadline missed status will change when the deadline that the DataWriter has committed through its DeadlineQosPolicy was not respected for a specific instance.

Parameters

writer	contain a pointer to the DataWriter on which the OfferedDeadlineMissedStatus has changed (this is an input to the application)
status	contain the OfferedDeadlineMissedStatus object (this is an input to the application).

on_offered_incompatible_qos()

template<typename T>

virtual void dds::pub::DataWriterListener< T >::on_offered_incompatible_qos ( dds::pub::DataWriter< T > &  writer, const dds::core::status::OfferedIncompatibleQosStatus &  status  )

pure virtualinherited

This operation called by the Data Distribution Service when the OfferedIncompatibleQosStatus changes.

This operation will only be called when the relevant DataWriterListener is installed and enabled for the StatusMask::offered_incompatible_qos(). The incompatible Qos status will change when a DataReader object has been discovered by the DataWriter with the same Topic and a requested DataReaderQos that was incompatible with the one offered by the DataWriter.

Parameters

writer	contain a pointer to the DataWriter on which the OfferedIncompatibleQosStatus has changed (this is an input to the application).
status	contain the OfferedIncompatibleQosStatus object (this is an input to the application).

on_publication_matched()

template<typename T>

virtual void dds::pub::DataWriterListener< T >::on_publication_matched ( dds::pub::DataWriter< T > &  writer, const dds::core::status::PublicationMatchedStatus &  status  )

pure virtualinherited

This operation is called by the Data Distribution Service when a new match has been discovered for the current publication, or when an existing match has ceased to exist.

Usually this means that a new DataReader that matches the Topic and that has compatible Qos as the current DataWriter has either been discovered, or that a previously discovered DataReader has ceased to be matched to the current DataWriter. A DataReader may cease to match when it gets deleted, when it changes its Qos to a value that is incompatible with the current DataWriter or when either the DataWriter or the DataReader has chosen to put its matching counterpart on its ignore-list using the dds::sub::ignore or dds::pub::ignore operations.

it will only be called when the relevant DataWriterListener is installed and enabled for the StatusMask::publication_matched().

Parameters

writer	contains a pointer to the DataWriter for which a match has been discovered (this is an input to the application provided by the Data Distribution Service).
status	contains the PublicationMatchedStatus object (this is an input to the application provided by the Data Distribution Service).

---

The documentation for this class was generated from the following file:

• dds/pub/DataWriterListener.hpp