RequestStream

Struct RequestStream 

Source
pub struct RequestStream<S, B> { /* private fields */ }
Expand description

Manage request and response transfer for an incoming request

The RequestStream struct is used to send and/or receive information from the client. After sending the final response, call RequestStream::finish to close the stream.

Implementations§

Source§

impl<S, B> RequestStream<S, B>
where S: RecvStream, B: Buf,

Source

pub async fn recv_data(&mut self) -> Result<Option<impl Buf>, StreamError>

Receive data sent from the client

Source

pub fn poll_recv_data( &mut self, cx: &mut Context<'_>, ) -> Poll<Result<Option<impl Buf>, StreamError>>

Poll for data sent from the client

Source

pub async fn recv_trailers(&mut self) -> Result<Option<HeaderMap>, StreamError>

Receive an optional set of trailers for the request

Source

pub fn poll_recv_trailers( &mut self, cx: &mut Context<'_>, ) -> Poll<Result<Option<HeaderMap>, StreamError>>

Poll for an optional set of trailers for the request

Source

pub fn stop_sending(&mut self, error_code: Code)

Tell the peer to stop sending into the underlying QUIC stream

Source

pub fn id(&self) -> StreamId

Returns the underlying stream id

Source§

impl<S, B> RequestStream<S, B>
where S: SendStream<B>, B: Buf,

Source

pub async fn send_response( &mut self, resp: Response<()>, ) -> Result<(), StreamError>

Send the HTTP/3 response

This should be called before trying to send any data with RequestStream::send_data.

Source

pub async fn send_data(&mut self, buf: B) -> Result<(), StreamError>

Send some data on the response body.

Source

pub fn stop_stream(&mut self, error_code: Code)

Stop a stream with an error code

The code can be Code::H3_NO_ERROR.

Source

pub async fn send_trailers( &mut self, trailers: HeaderMap, ) -> Result<(), StreamError>

Send a set of trailers to end the response.

RequestStream::finish must be called to finalize a request.

Source

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

End the response without trailers.

RequestStream::finish must be called to finalize a request.

Source

pub fn send_id(&self) -> StreamId

Returns the underlying stream id

Source§

impl<S, B> RequestStream<S, B>
where S: BidiStream<B>, B: Buf,

Source

pub fn split( self, ) -> (RequestStream<S::SendStream, B>, RequestStream<S::RecvStream, B>)

Splits the Request-Stream into send and receive. This can be used the send and receive data on different tasks.

Auto Trait Implementations§

§

impl<S, B> !Freeze for RequestStream<S, B>

§

impl<S, B> !RefUnwindSafe for RequestStream<S, B>

§

impl<S, B> Send for RequestStream<S, B>
where S: Send, B: Send,

§

impl<S, B> Sync for RequestStream<S, B>
where S: Sync, B: Sync,

§

impl<S, B> Unpin for RequestStream<S, B>

§

impl<S, B> !UnwindSafe for RequestStream<S, B>

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, 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.