public interface Deadline extends QosPolicy.ForTopic, QosPolicy.ForDataReader, QosPolicy.ForDataWriter, RequestedOffered<Deadline>
DataReader expects a new sample updating the value of each
instance at least once every deadline period. The DataWriter
indicates that the application commits to write a new value (using the
DataWriter) for each instance managed by the DataWriter at least once
every deadline period. It is inconsistent for a DataReader to have a
deadline period less than the result of its
TimeBasedFilter.getMinimumSeparation(). The default value
of the deadline period is infinite.
Concerns: Topic, DataReader, DataWriter
RxO: Yes
Changeable: Yes
This policy is useful for cases where a Topic is expected to have
each instance updated periodically. On the publishing side this setting
establishes a contract that the application must meet. On the subscribing
side the setting establishes a minimum requirement for the remote
publishers that are expected to supply the data values.
When the Service "matches" a DataWriter and a DataReader it checks whether
the settings are compatible (i.e., offered deadline period<= requested
deadline period). If they are not, the two entities are informed (via the
listener or Condition mechanism) of the incompatibility of the QoS
settings and communication will not occur.
Assuming that the reader and writer ends have compatible settings, the
fulfillment of this contract is monitored by the Service and the
application is informed of any violations by means of the proper listener
or condition.
The value offered is considered compatible with the value requested if and
only if the inequality "offered deadline period <= requested deadline
period" evaluates to true.
The setting of the DEADLINE policy must be set consistently with that of
the TimeBasedFilter. For these two policies to be
consistent the settings must be such that "deadline period >=
minimum_separation."QosPolicy.ForDataReader, QosPolicy.ForDataWriter, QosPolicy.ForDomainParticipant, QosPolicy.ForDomainParticipantFactory, QosPolicy.ForPublisher, QosPolicy.ForSubscriber, QosPolicy.ForTopic| Modifier and Type | Method and Description |
|---|---|
Duration |
getPeriod() |
Deadline |
withPeriod(Duration period)
Copy this policy and override the value of the property.
|
Deadline |
withPeriod(long period,
TimeUnit unit)
Copy this policy and override the value of the property.
|
getEnvironmentrequestedOfferedContractcompareToCopyright © 2014. All rights reserved.