Skip to main content

Contract

Struct Contract 

Source
pub struct Contract {
    pub history_kind: HistoryKind,
    pub history_depth: i32,
    pub max_samples: i32,
    pub max_instances: i32,
    pub max_samples_per_instance: i32,
    pub cleanup_delay: Duration,
}
Expand description

Retention contract for a topic, derived from its DurabilityServiceQosPolicy. The cold store MUST enforce exactly this and nothing tighter (the memory budget is a separate, non-retention knob).

Fields§

§history_kind: HistoryKind

KEEP_LAST (ring per instance at history_depth) or KEEP_ALL (bounded only by the max_* caps).

§history_depth: i32

KEEP_LAST depth per instance (<= 0 is normalized to 1).

§max_samples: i32

Global sample cap (LENGTH_UNLIMITED = unbounded).

§max_instances: i32

Instance-count cap (LENGTH_UNLIMITED = unbounded).

§max_samples_per_instance: i32

Per-instance sample cap under KEEP_ALL (LENGTH_UNLIMITED = unbounded).

§cleanup_delay: Duration

Delay after an instance is unregistered before its samples are purged.

Implementations§

Source§

impl Contract

Source

pub fn from_qos(qos: &DurabilityServiceQosPolicy) -> Self

Derives the contract from the durability-service QoS policy.

Source

pub fn keep_all() -> Self

A KEEP_ALL contract with all caps unlimited and no cleanup delay — the sensible default for a durability service that should retain full history (the DurabilityServiceQosPolicy default is KEEP_LAST(1), which is rarely what a service wants).

Source

pub fn effective_depth(&self) -> usize

Effective KEEP_LAST depth (<= 0 normalized to 1, per DDS default).

Source

pub fn samples_bounded(&self) -> bool

true if max_samples is bounded.

Source

pub fn instances_bounded(&self) -> bool

true if max_instances is bounded.

Source

pub fn per_instance_bounded(&self) -> bool

true if max_samples_per_instance is bounded.

Trait Implementations§

Source§

impl Clone for Contract

Source§

fn clone(&self) -> Contract

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for Contract

Source§

impl Debug for Contract

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for Contract

Source§

fn default() -> Self

KEEP_LAST(1), all caps unlimited, zero cleanup delay — matches the DurabilityServiceQosPolicy default.

Source§

impl Eq for Contract

Source§

impl PartialEq for Contract

Source§

fn eq(&self, other: &Contract) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Contract

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.