UpgradeableConnection

Struct UpgradeableConnection 

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

An upgradable Connection, returned by Builder::serve_upgradable_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> UpgradeableConnection<'_, 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 UpgradeableConnection should continue to be polled until shutdown can finish.

§Note

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

Source

pub fn into_owned(self) -> UpgradeableConnection<'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 UpgradeableConnection<'_, 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 + Send + '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 UpgradeableConnection<'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 UpgradeableConnection<'a, I, S, E>

§

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

§

impl<'a, I, S, E> Send for UpgradeableConnection<'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 UpgradeableConnection<'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 UpgradeableConnection<'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,