Struct SendRequest

pub struct SendRequest<B> { /* private fields */ }

The sender side of an established connection.

Implementations

impl<B> SendRequest<B>

pub fn poll_ready(&mut self, _cx: &mut Context<'_>) -> Poll<Result<(), Error>>

Polls to determine whether this sender can be used yet for a request.

If the associated connection is closed, this returns an Error.

pub async fn ready(&mut self) -> Result<(), Error>

Waits until the dispatcher is ready

If the associated connection is closed, this returns an Error.

pub fn is_ready(&self) -> bool

Checks if the connection is currently ready to send a request.

Note

This is mostly a hint. Due to inherent latency of networks, it is possible that even after checking this is ready, sending a request may still fail because the connection was closed in the meantime.

pub fn is_closed(&self) -> bool

Checks if the connection side has been closed.

impl<B> SendRequest<B>

where B: Body + Send + 'static + Unpin, <B as Body>::Data: Send + 'static, <B as Body>::Error: Into<Box<dyn Error + Sync + Send>>,

pub fn send_request( &mut self, req: Request<B>, ) -> impl Future<Output = Result<Response<Incoming>, Error>>

Sends a Request on the associated connection.

Returns a future that if successful, yields the Response.

req must have a Host header.

Absolute-form Uris are not required. If received, they will be serialized as-is.

pub fn try_send_request( &mut self, req: Request<B>, ) -> impl Future<Output = Result<Response<Incoming>, TrySendError<Request<B>>>>

Sends a Request on the associated connection.

Returns a future that if successful, yields the Response.

Error

If there was an error before trying to serialize the request to the connection, the message will be returned as part of this error.

Trait Implementations

impl<B> Clone for SendRequest<B>

fn clone(&self) -> SendRequest<B>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<B> Debug for SendRequest<B>

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

Formats the value using the given formatter.