Skip to main content

Fetch

Struct Fetch 

Source
pub struct Fetch {
    pub request_id: VarInt,
    pub track_namespace: TrackNamespace,
    pub track_name: Vec<u8>,
    pub parameters: Vec<KeyValuePair>,
}
Expand description

FETCH (0x16), rebuilt in draft-20 (Section 9.11, Figure 16).

FETCH Message {
  Type (vi64) = 0x16,
  Length (16),
  Request ID (vi64),
  Track Namespace (..),
  Track Name Length (vi64),
  Track Name (..),
  Number of Parameters (vi64),
  Parameters (..) ...
}

§What went, and why draft-19’s shape cannot be ported

Draft-19’s FETCH opened with a Fetch Type that chose between a Standalone Fetch — a namespace, a name and an inline Start Location / End Location pair — and a Joining Fetch of two varints. Draft-20 deleted the field, both structures, the Fetch Type registry and the whole joining mechanism, and promoted the namespace and the name to fields of FETCH itself, in the positions they hold inside draft-19’s Standalone Fetch. What is left is byte-identical to Subscribe apart from the type code.

The range travels in the LOCATION_FILTER parameter (Section 9.20.9): “If omitted from FETCH or SUBSCRIBE, the fetch or subscription is unfiltered.” Draft-22 places no restriction on which Location Filter Type a FETCH may carry, so every type decodes here, Relative Start (0x01) and Next Object (0x05) included.

§INVALID_RANGE and a start past Largest Object

Section 3.2: “If no Objects have been published for the track or Start Location is greater than the Largest Object (Section 3.1.4) the publisher MUST return FETCH_ERROR with error code INVALID_RANGE.” A Relative Start of StartGroup = 0 resolves to the Next Group, and a Next Object filter to the object after Largest Object; both are by construction greater than Largest Object, so read literally the rule rejects every such FETCH, and the text carves out nothing. Nothing here can apply either reading: the test needs Largest Object, which is track state rather than anything in this frame, so the decision belongs to the endpoint. It is recorded here because this is where the filter arrives.

The codepoint did not change. A draft-19 decoder fed one of these reads the Number of Track Namespace Fields count as a Fetch Type and mis-parses without complaint; there is no in-band version signal to catch it. That is why draft-22 has a FETCH decoder of its own rather than sharing draft-19’s.

Fields§

§request_id: VarInt§track_namespace: TrackNamespace§track_name: Vec<u8>§parameters: Vec<KeyValuePair>

Trait Implementations§

Source§

impl Clone for Fetch

Source§

fn clone(&self) -> Self

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 Debug for Fetch

Source§

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

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

impl Eq for Fetch

Source§

impl PartialEq for Fetch

Source§

fn eq(&self, other: &Self) -> 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 Fetch

Auto Trait Implementations§

§

impl Freeze for Fetch

§

impl RefUnwindSafe for Fetch

§

impl Send for Fetch

§

impl Sync for Fetch

§

impl Unpin for Fetch

§

impl UnsafeUnpin for Fetch

§

impl UnwindSafe for Fetch

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 = !

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

fn try_from(value: U) -> Result<T, !>

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.