dds::core::policy::DurabilityService Class Reference

Configures the external RTI Persistence Service used by persistent and transient DataWriters. More...

#include <dds/core/policy/CorePolicy.hpp>

Public Member Functions
	DurabilityService ()
	Creates the default policy. More...
	DurabilityService (const dds::core::Duration &the_service_cleanup_delay, dds::core::policy::HistoryKind the_history_kind, int32_t the_history_depth, int32_t the_max_samples, int32_t the_max_instances, int32_t the_max_samples_per_instance)
	Creates an instance with all the parameters set. More...
DurabilityService &	service_cleanup_delay (const dds::core::Duration &d)
	Controls when the service is able to remove all information regarding a data instances. More...
dds::core::Duration	service_cleanup_delay () const
	Getter (see setter with the same name) More...
DurabilityService &	history_kind (dds::core::policy::HistoryKind the_kind)
	The kind of history to apply in recouping durable data. More...
dds::core::policy::HistoryKind	history_kind () const
	Getter (see setter with the same name) More...
DurabilityService &	history_depth (int32_t the_depth)
	Setting to use for the dds::core::policy::Durability::writer_depth when recouping durable data. More...
int32_t	history_depth () const
	Getter (see setter with the same name) More...
DurabilityService &	max_samples (int32_t the_max_samples)
	Part of resource limits QoS policy to apply when feeding a late joiner. More...
int32_t	max_samples () const
	Getter (see setter with the same name) More...
DurabilityService &	max_instances (int32_t the_max_instances)
	Part of resource limits QoS policy to apply when feeding a late joiner. More...
DurabilityService &	max_samples_per_instance (int32_t the_max_samples_per_instance)
	Part of resource limits QoS policy to apply when feeding a late joiner. More...
int32_t	max_samples_per_instance () const
	Getter (see setter with the same name) More...

Detailed Description

Configures the external RTI Persistence Service used by persistent and transient DataWriters.

Entity:

dds::topic::Topic, dds::pub::DataWriter

Properties:

RxO = NO
Changeable = UNTIL ENABLE

See also

DURABILITY

HISTORY

RESOURCE_LIMITS

Usage

When a DataWriter's dds::core::policy::Durability::kind is dds::core::policy::DurabilityKind::PERSISTENT or dds::core::policy::DurabilityKind::TRANSIENT, an external service, the RTI Persistence Service, is used to store and possibly forward the data sent by the dds::pub::DataWriter to dds::sub::DataReader objects that are created after the data was initially sent.

This QoS policy is used to configure certain parameters of the Persistence Service when it operates on the behalf of the dds::pub::DataWriter, such as how much data to store. For example, it configures the DURABILITY, HISTORY, and the RESOURCE_LIMITS used by the fictitious DataReader and DataWriter used by the Persistence Service. Note, however, that the Persistence Service itself may be configured to ignore these values and instead use values from its own configuration file.

Constructor & Destructor Documentation

DurabilityService() [1/2]

dds::core::policy::DurabilityService::DurabilityService ( )

inline

Creates the default policy.

DurabilityService() [2/2]

dds::core::policy::DurabilityService::DurabilityService ( const dds::core::Duration &  the_service_cleanup_delay, dds::core::policy::HistoryKind  the_history_kind, int32_t  the_history_depth, int32_t  the_max_samples, int32_t  the_max_instances, int32_t  the_max_samples_per_instance  )

inline

Creates an instance with all the parameters set.

Member Function Documentation

service_cleanup_delay() [1/2]

DurabilityService& dds::core::policy::DurabilityService::service_cleanup_delay ( const dds::core::Duration &  d )

inline

Controls when the service is able to remove all information regarding a data instances.

When the service cleanup delay is set to 0, disposed instances will be completely removed from the service. Only values of 0 and dds::core::Duration::infinite() are currently supported.

[default] 0

service_cleanup_delay() [2/2]

dds::core::Duration dds::core::policy::DurabilityService::service_cleanup_delay ( ) const

inline

Getter (see setter with the same name)

history_kind() [1/2]

DurabilityService& dds::core::policy::DurabilityService::history_kind ( dds::core::policy::HistoryKind  the_kind )

inline

The kind of history to apply in recouping durable data.

[default] dds::core::policy::HistoryKind::KEEP_LAST

history_kind() [2/2]

dds::core::policy::HistoryKind dds::core::policy::DurabilityService::history_kind ( ) const

inline

Getter (see setter with the same name)

history_depth() [1/2]

DurabilityService& dds::core::policy::DurabilityService::history_depth ( int32_t  the_depth )

inline

Setting to use for the dds::core::policy::Durability::writer_depth when recouping durable data.

If the dds::core::policy::History::depth is set to a value lower than this value, dds::core::policy::History::depth will be set equal to the value of this field.

[default] rti::core::policy::auto_writer_depth() (1)

history_depth() [2/2]

int32_t dds::core::policy::DurabilityService::history_depth ( ) const

inline

Getter (see setter with the same name)

max_samples() [1/2]

DurabilityService& dds::core::policy::DurabilityService::max_samples ( int32_t  the_max_samples )

inline

Part of resource limits QoS policy to apply when feeding a late joiner.

[default] dds::core::LENGTH_UNLIMITED

max_samples() [2/2]

int32_t dds::core::policy::DurabilityService::max_samples ( ) const

inline

Getter (see setter with the same name)

max_instances()

DurabilityService& dds::core::policy::DurabilityService::max_instances ( int32_t  the_max_instances )

inline

Part of resource limits QoS policy to apply when feeding a late joiner.

[default] dds::core::LENGTH_UNLIMITED

max_samples_per_instance() [1/2]

DurabilityService& dds::core::policy::DurabilityService::max_samples_per_instance ( int32_t  the_max_samples_per_instance )

inline

Part of resource limits QoS policy to apply when feeding a late joiner.

[default] dds::core::LENGTH_UNLIMITED

max_samples_per_instance() [2/2]

int32_t dds::core::policy::DurabilityService::max_samples_per_instance ( ) const

inline

Getter (see setter with the same name)