Struct hyper::client::conn::http1::SendRequest

source ·
pub struct SendRequest<B> { /* private fields */ }
Expand description

The sender side of an established connection.

Implementations§

source§

impl<B> SendRequest<B>

source

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

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

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

source

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

Waits until the dispatcher is ready

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

source

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.

source

pub fn is_closed(&self) -> bool

Checks if the connection side has been closed.

source§

impl<B> SendRequest<B>
where B: Body + 'static,

source

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

Sends a Request on the associated connection.

Returns a future that if successful, yields the Response.

req must have a Host header.

§Uri

The Uri of the request is serialized as-is.

  • Usually you want origin-form (/path?query).
  • For sending to an HTTP proxy, you want to send in absolute-form (https://hyper.rs/guides).

This is however not enforced or validated and it is up to the user of this method to ensure the Uri is correct for their intended purpose.

source

pub fn try_send_request( &mut self, req: Request<B>, ) -> impl Future<Output = Result<Response<IncomingBody>, 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§

source§

impl<B> Debug for SendRequest<B>

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<B> Freeze for SendRequest<B>

§

impl<B> !RefUnwindSafe for SendRequest<B>

§

impl<B> Send for SendRequest<B>
where B: Send,

§

impl<B> Sync for SendRequest<B>
where B: Send,

§

impl<B> Unpin for SendRequest<B>

§

impl<B> !UnwindSafe for SendRequest<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> 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, 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