Skip to main content

PipelinedSender

Struct PipelinedSender 

Source
pub struct PipelinedSender { /* private fields */ }
Expand description

A pipelined transfer connection: multiple chunk requests can be enqueued and in flight simultaneously, instead of a blocking one-at-a-time model.

Backed by a background sender task (see spawn_pipelined) that owns the socket; this struct is just a cheap handle (an mpsc sender + a liveness flag) and can be cloned freely if multiple call sites need to share one pipelined connection.

Implementations§

Source§

impl PipelinedSender

Source

pub fn is_alive(&self) -> bool

true if the underlying sender task is still running. Does not guarantee the next request will succeed (the connection could die between this check and the next enqueue), but is enough to decide whether to keep using this sender or fall back to opening a new one.

Source

pub async fn enqueue( &self, body: Vec<u8>, ) -> Result<impl Future<Output = Result<Vec<u8>, InvocationError>> + Send + use<>, InvocationError>

Enqueue a pre-serialised TL request body and return a future that resolves when the server responds. Does not wait for the response itself - callers can enqueue several of these before awaiting any of them, which is exactly what gives this connection X > 1 (multiple chunk requests in flight at once on one socket).

Returns an error immediately if the sender task has already shut down (e.g. the connection died); otherwise returns a future that resolves to the eventual RPC result or a connection-failure error.

Source

pub async fn call(&self, body: Vec<u8>) -> Result<Vec<u8>, InvocationError>

Enqueue and immediately await a single request - convenience for call sites that don’t need explicit pipelining (e.g. the final part of a transfer, or error-recovery paths).

Trait Implementations§

Source§

impl Clone for PipelinedSender

Source§

fn clone(&self) -> PipelinedSender

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

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> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> Same for T

Source§

type Output = T

Should always be Self
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.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more