org.omg.dds.core.policy

Interface WriterDataLifecycle

All Superinterfaces:

DDSObject, QosPolicy, QosPolicy.ForDataWriter, Serializable

public interface WriterDataLifecycle
extends QosPolicy.ForDataWriter

Specifies the behavior of the DataWriter with regards to the life cycle of the data instances it manages. Concerns: DataWriter RxO: N/A Changeable: Yes This policy controls the behavior of the DataWriter with regards to the lifecycle of the data instances it manages, that is, the data instances that have been either explicitly registered with the DataWriter using the DataWriter.registerInstance(Object) operations or implicitly by directly writing the data (see DataWriter.write(Object)). The autodisposeUnregisteredInstances flag controls the behavior when the DataWriter unregisters an instance by means of the DataWriter.unregisterInstance(org.omg.dds.core.InstanceHandle) operations:

• The setting "autodisposeUnregisteredInstances = true' causes the DataWriter to dispose the instance each time it is unregistered. The behavior is identical to explicitly calling one of the DataWriter.dispose(org.omg.dds.core.InstanceHandle) operations on the instance prior to calling the unregister operation.
• The setting 'autodisposeUnregisteredInstances = false' will not cause this automatic disposition upon unregistering. The application can still call one of the dispose operations prior to unregistering the instance and accomplish the same effect. Refer to Section 7.1.3.23.3 of the DDS specification, "Semantic difference between unregister_instance and dispose", for a description of the consequences of disposing and unregistering instances.

Note that the deletion of a DataWriter automatically unregisters all data instances it manages (see Entity.close()). Therefore the setting of the autodisposeUnregisteredInstances flag will determine whether instances are ultimately disposed when the DataWriter is deleted either directly by means of the Entity.close() operation or indirectly as a consequence of calling Publisher.closeContainedEntities() or DomainParticipant.closeContainedEntities().

Nested Class Summary

Nested classes/interfaces inherited from interface org.omg.dds.core.policy.QosPolicy

QosPolicy.ForDataReader, QosPolicy.ForDataWriter, QosPolicy.ForDomainParticipant, QosPolicy.ForDomainParticipantFactory, QosPolicy.ForPublisher, QosPolicy.ForSubscriber, QosPolicy.ForTopic

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isAutDisposeUnregisteredInstances()
WriterDataLifecycle	withAutDisposeUnregisteredInstances(boolean autDisposeUnregisteredInstances) Copy this policy and override the value of the property.

Methods inherited from interface org.omg.dds.core.DDSObject

getEnvironment

Method Detail

isAutDisposeUnregisteredInstances

boolean isAutDisposeUnregisteredInstances()

Returns:

the autDisposeUnregisteredInstances

withAutDisposeUnregisteredInstances

WriterDataLifecycle withAutDisposeUnregisteredInstances(boolean autDisposeUnregisteredInstances)

Copy this policy and override the value of the property.

Returns:

a new policy