ddsf:public:guidebook:06_append:02_quality_of_service:durability
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
ddsf:public:guidebook:06_append:02_quality_of_service:durability [2021/07/14 15:46] murphy ↷ Links adapted because of a move operation |
ddsf:public:guidebook:06_append:02_quality_of_service:durability [2021/07/14 15:56] (current) murphy ↷ Links adapted because of a move operation |
||
|---|---|---|---|
| Line 3: | Line 3: | ||
| ;Note | ;Note | ||
| - | : The decoupling between ''DataReader'' and ''DataWriter'' offered by the [[ddsf:private:guidebook:06_append:glossary:p:publish-subscribe|Publish/Subscribe]] paradigm allows an application to write data even if there are no current readers on the network. Moreover, a DataReader that joins the network after some data has been written could potentially be interested in accessing the most current values of the data as well as potentially some history. | + | : The decoupling between ''DataReader'' and ''DataWriter'' offered by the [[ddsf:public:guidebook:06_append:glossary:p:publish-subscribe|Publish/Subscribe]] paradigm allows an application to write data even if there are no current readers on the network. Moreover, a DataReader that joins the network after some data has been written could potentially be interested in accessing the most current values of the data as well as potentially some history. |
| - | The [[ddsf:public:guidebook:06_append:glossary:d:durability|DURABILITY]] [[ddsf:private:guidebook:06_append:glossary:q:quality_of_service_qos_policies|QoS]] policy controls whether the Service will actually make data available to late-joining readers. Note that although related, this does not strictly control what data the Service will maintain internally. That is, the Service may choose to maintain some data for its own purposes (e.g., flow control) and yet not make it available to late-joining readers if the DURABILITY QoS policy is set to VOLATILE. | + | The [[ddsf:public:guidebook:06_append:glossary:d:durability|DURABILITY]] [[ddsf:public:guidebook:06_append:glossary:q:quality_of_service_qos_policies|QoS]] policy controls whether the Service will actually make data available to late-joining readers. Note that although related, this does not strictly control what data the Service will maintain internally. That is, the Service may choose to maintain some data for its own purposes (e.g., flow control) and yet not make it available to late-joining readers if the DURABILITY QoS policy is set to VOLATILE. |
| The value offered is considered compatible with the value requested if and only if the inequality ''offered kind >= requested kind'' evaluates to ''TRUE''. For the purposes of this inequality, the values of DURABILITY kind are considered ordered such that ''VOLATILE < TRANSIENT_LOCAL < TRANSIENT < PERSISTENT''. | The value offered is considered compatible with the value requested if and only if the inequality ''offered kind >= requested kind'' evaluates to ''TRUE''. For the purposes of this inequality, the values of DURABILITY kind are considered ordered such that ''VOLATILE < TRANSIENT_LOCAL < TRANSIENT < PERSISTENT''. | ||
| For the purpose of implementing the DURABILITY QoS kind TRANSIENT or PERSISTENT, the service behaves “as if” for | For the purpose of implementing the DURABILITY QoS kind TRANSIENT or PERSISTENT, the service behaves “as if” for | ||
| - | each ''[[ddsf:private:guidebook:06_append:glossary:t:topic|Topic]]'' that has TRANSIENT or PERSISTENT DURABILITY kind there was a corresponding “built-in” ''DataReader'' and ''DataWriter'' configured to have the same DURABILITY kind. In other words, it is “as if” somewhere in the system (possibly on a remote node) there was a “built-in durability ''DataReader''” that subscribed to that Topic and a “built-in durability ''DataWriter”'' that published that Topic as needed for the new subscribers that join the system. | + | each ''[[ddsf:public:guidebook:06_append:glossary:t:topic|Topic]]'' that has TRANSIENT or PERSISTENT DURABILITY kind there was a corresponding “built-in” ''DataReader'' and ''DataWriter'' configured to have the same DURABILITY kind. In other words, it is “as if” somewhere in the system (possibly on a remote node) there was a “built-in durability ''DataReader''” that subscribed to that Topic and a “built-in durability ''DataWriter”'' that published that Topic as needed for the new subscribers that join the system. |
| For each ''Topic'', the built-in fictitious “persistence service” ''DataReader'' and ''DataWriter'' has its QoS configured from the ''Topic'' QoS of the corresponding ''Topic''. In other words, it is “as-if” the service first did find_topic to access the ''Topic'', and then used the QoS from the Topic to configure the fictitious built-in entities. | For each ''Topic'', the built-in fictitious “persistence service” ''DataReader'' and ''DataWriter'' has its QoS configured from the ''Topic'' QoS of the corresponding ''Topic''. In other words, it is “as-if” the service first did find_topic to access the ''Topic'', and then used the QoS from the Topic to configure the fictitious built-in entities. | ||
| Line 16: | Line 16: | ||
| A consequence of this model is that the transient or persistence serviced can be configured by means of setting the proper QoS on the Topic. | A consequence of this model is that the transient or persistence serviced can be configured by means of setting the proper QoS on the Topic. | ||
| - | For a given Topic, the usual request/offered [[ddsf:private:guidebook:06_append:glossary:s:semantics|semantics]] apply to the matching between any DataWriter in the system that writes the Topic and the built-in transient/persistent DataReader for that Topic; similarly for the built-in transient/persistent DataWriter for a Topic and any DataReader for the Topic. As a consequence, a DataWriter that has an incompatible QoS with respect to what the Topic specified will not send its data to the transient/persistent service, and a DataReader that has an incompatible QoS with respect to the specified in the Topic will not get data from it. | + | For a given Topic, the usual request/offered [[ddsf:public:guidebook:06_append:glossary:s:semantics|semantics]] apply to the matching between any DataWriter in the system that writes the Topic and the built-in transient/persistent DataReader for that Topic; similarly for the built-in transient/persistent DataWriter for a Topic and any DataReader for the Topic. As a consequence, a DataWriter that has an incompatible QoS with respect to what the Topic specified will not send its data to the transient/persistent service, and a DataReader that has an incompatible QoS with respect to the specified in the Topic will not get data from it. |
| - | Incompatibilities between local ''DataReader''/''DataWriter'' entities and the corresponding fictitious “built-in transient/persistent entities” cause the REQUESTED_INCOMPATIBLE_QOS/OFFERED_INCOMPATIBLE_QOS status to change and the corresponding [[ddsf:private:guidebook:06_append:glossary:l:listener|Listener]] invocations and/or signaling of ''[[ddsf:public:guidebook:06_append:glossary:c:condition|Condition]]'' and ''[[ddsf:private:guidebook:06_append:glossary:w:waitset|WaitSet]]'' objects as they would with non-fictitious entities. | + | Incompatibilities between local ''DataReader''/''DataWriter'' entities and the corresponding fictitious “built-in transient/persistent entities” cause the REQUESTED_INCOMPATIBLE_QOS/OFFERED_INCOMPATIBLE_QOS status to change and the corresponding [[ddsf:public:guidebook:06_append:glossary:l:listener|Listener]] invocations and/or signaling of ''[[ddsf:public:guidebook:06_append:glossary:c:condition|Condition]]'' and ''[[ddsf:public:guidebook:06_append:glossary:w:waitset|WaitSet]]'' objects as they would with non-fictitious entities. |
| The setting of the service_cleanup_delay controls when the TRANSIENT or PERSISTENT service is able to remove all | The setting of the service_cleanup_delay controls when the TRANSIENT or PERSISTENT service is able to remove all | ||
ddsf/public/guidebook/06_append/02_quality_of_service/durability.1626291984.txt.gz · Last modified: 2021/07/14 15:46 by murphy
