Connection

Struct Connection 

Source
pub struct Connection<'a, I, S, E>{ /* private fields */ }
Expand description

A Future representing an HTTP/1 connection, returned from Builder::serve_connection.

To drive HTTP on this connection this future must be polled, typically with .await. If it isn’t polled, no progress will be made on this connection.

Implementations§

Source§

impl<I, S, E, B> Connection<'_, I, S, E>
where S: HttpService<Incoming, ResBody = B>, S::Error: Into<Box<dyn StdError + Send + Sync>>, I: Read + Write + Unpin, B: Body + 'static, B::Error: Into<Box<dyn StdError + Send + Sync>>, E: HttpServerConnExec<S::Future, B>,

Source

pub fn graceful_shutdown(self: Pin<&mut Self>)

Start a graceful shutdown process for this connection.

This Connection should continue to be polled until shutdown can finish.

§Note

This should only be called while the Connection future is still pending. If called after Connection::poll has resolved, this does nothing.

Source

pub fn into_owned(self) -> Connection<'static, I, S, E>
where Builder<E>: Clone,

Make this Connection static, instead of borrowing from Builder.

Trait Implementations§

Source§

impl<I, S, E, B> Future for Connection<'_, I, S, E>
where S: Service<Request<Incoming>, Response = Response<B>>, S::Future: 'static, S::Error: Into<Box<dyn StdError + Send + Sync>>, B: Body + 'static, B::Error: Into<Box<dyn StdError + Send + Sync>>, I: Read + Write + Unpin + 'static, E: HttpServerConnExec<S::Future, B>,

Source§

type Output = Result<(), Box<dyn Error + Send + Sync>>

The type of value produced on completion.
Source§

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available. Read more
Source§

impl<'__pin, 'a, I, S, E> Unpin for Connection<'a, I, S, E>
where PinnedFieldsOf<__Origin<'__pin, 'a, I, S, E>>: Unpin, S: HttpService<Incoming>,

Auto Trait Implementations§

§

impl<'a, I, S, E> !Freeze for Connection<'a, I, S, E>

§

impl<'a, I, S, E> !RefUnwindSafe for Connection<'a, I, S, E>

§

impl<'a, I, S, E> Send for Connection<'a, I, S, E>
where S: Send, I: Send, E: Send + Sync, <S as HttpService<Incoming>>::ResBody: Send, <S as HttpService<Incoming>>::Future: Send, <<S as HttpService<Incoming>>::ResBody as Body>::Data: Send,

§

impl<'a, I, S, E> Sync for Connection<'a, I, S, E>
where S: Sync, I: Sync, E: Sync, <S as HttpService<Incoming>>::ResBody: Sync, <S as HttpService<Incoming>>::Future: Sync, <<S as HttpService<Incoming>>::ResBody as Body>::Data: Sync,

§

impl<'a, I, S, E> !UnwindSafe for Connection<'a, I, S, E>

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<F> IntoFuture for F
where F: Future,

Source§

type Output = <F as Future>::Output

The output that the future will produce on completion.
Source§

type IntoFuture = F

Which kind of future are we turning this into?
Source§

fn into_future(self) -> <F as IntoFuture>::IntoFuture

Creates a future from a value. 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<F, T, E> TryFuture for F
where F: Future<Output = Result<T, E>> + ?Sized,

Source§

type Ok = T

The type of successful values yielded by this future
Source§

type Error = E

The type of failures yielded by this future
Source§

fn try_poll( self: Pin<&mut F>, cx: &mut Context<'_>, ) -> Poll<<F as Future>::Output>

Poll this TryFuture as if it were a Future. Read more
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<A, B, T> HttpServerConnExec<A, B> for T
where B: Body,