Skip to main content

ClientStreamingCall

Struct ClientStreamingCall 

Source
pub struct ClientStreamingCall<Req, Resp> { /* private fields */ }
Expand description

Client-streaming requests with exactly one response after successful completion.

Implementations§

Source§

impl<Req: 'static, Resp: 'static> ClientStreamingCall<Req, Resp>

Source

pub fn new<D: StreamDriver<Send = Req, Receive = Resp> + 'static>( driver: D, ) -> Self

Source

pub fn send(&mut self, value: &Req) -> Result<(), StreamError>

Sends a message, waiting for transport capacity.

§Errors

Returns a closed-direction or terminal failure.

Source

pub fn try_send(&mut self, value: &Req) -> Result<(), StreamError>

Attempts a send; pending means the message was not accepted.

§Errors

Returns pending, closed-direction or terminal failure.

Source

pub fn half_close(&mut self) -> Result<(), StreamError>

Idempotently half-closes requests while allowing further responses.

§Errors

Returns a terminal failure.

Source

pub fn try_half_close(&mut self) -> Result<(), StreamError>

Attempts request half-close without waiting.

§Errors

Returns pending or terminal failure.

Source

pub fn try_finish(&mut self) -> Result<Resp, StreamError>

Advances completion by at most two receive steps, preserving a pending response.

§Errors

Returns pending, terminal error, or response cardinality failure.

Source

pub fn try_recv_next(&mut self) -> Result<Option<Resp>, StreamError>

Polls the single response through validated final status.

§Errors

Returns the same pending or terminal errors as Self::try_finish.

Source

pub fn recv_next(&mut self) -> Result<Option<Resp>, StreamError>

Waits for the single response, then returns EOF on subsequent reads.

§Errors

Returns the terminal errors from Self::finish.

Source

pub fn finish(&mut self) -> Result<Resp, StreamError>

Waits for exactly one response and a successful final status.

§Errors

Returns terminal failure or response cardinality failure.

Source

pub fn initial_metadata(&self) -> Result<Option<Metadata>, StreamError>

Copies received initial metadata, if available.

§Errors

Rejects reentrant access from a driver callback.

Source

pub fn trailing_metadata(&self) -> Result<Option<Metadata>, StreamError>

Copies terminal metadata, including on a remote failure.

§Errors

Rejects reentrant access from a driver callback.

Source

pub fn cancel(&mut self) -> Result<(), StreamError>

Cancels local resources without waiting for peer acknowledgement.

§Errors

Rejects reentrant access from a driver callback.

Auto Trait Implementations§

§

impl<Req, Resp> !RefUnwindSafe for ClientStreamingCall<Req, Resp>

§

impl<Req, Resp> !Send for ClientStreamingCall<Req, Resp>

§

impl<Req, Resp> !Sync for ClientStreamingCall<Req, Resp>

§

impl<Req, Resp> !UnwindSafe for ClientStreamingCall<Req, Resp>

§

impl<Req, Resp> Freeze for ClientStreamingCall<Req, Resp>
where BidiStreamingCall<Req, Resp>: Freeze, Option<Resp>: Freeze,

§

impl<Req, Resp> Unpin for ClientStreamingCall<Req, Resp>
where BidiStreamingCall<Req, Resp>: Unpin, Option<Resp>: Unpin,

§

impl<Req, Resp> UnsafeUnpin for ClientStreamingCall<Req, Resp>
where BidiStreamingCall<Req, Resp>: UnsafeUnpin, Option<Resp>: UnsafeUnpin,

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

Source§

type Output = T

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