Connection

Struct Connection 

Source
pub struct Connection<C, B>
where C: Connection<B>, B: Buf,
{ pub inner: ConnectionInner<C, B>, /* private fields */ }
Expand description

Server connection driver

The Connection struct manages a connection from the side of the HTTP/3 server

Create a new Instance with Connection::new(). Accept incoming requests with Connection::accept(). And shutdown a connection with Connection::shutdown().

Fields§

§inner: ConnectionInner<C, B>

TODO: temporarily break encapsulation for WebTransportSession

Implementations§

Source§

impl<C, B> Connection<C, B>
where C: Connection<B>, B: Buf,

Source

pub async fn new(conn: C) -> Result<Self, ConnectionError>

Create a new HTTP/3 server connection with default settings

Use a custom super::builder::Builder with super::builder::builder() to create a connection with different settings. Provide a Connection which implements quic::Connection.

Source§

impl<C, B> Connection<C, B>
where C: Connection<B>, B: Buf,

Source

pub async fn accept( &mut self, ) -> Result<Option<RequestResolver<C, B>>, ConnectionError>

Accept an incoming request.

This method returns a RequestResolver which can be used to read the request and send the response. This method will return None when the connection receives a GOAWAY frame and all requests have been completed.

Source

pub async fn shutdown( &mut self, max_requests: usize, ) -> Result<(), ConnectionError>

Initiate a graceful shutdown, accepting max_request potentially still in-flight

See connection shutdown for more information.

Trait Implementations§

Source§

impl<C, B> Drop for Connection<C, B>
where C: Connection<B>, B: Buf,

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

§

impl<C, B> Freeze for Connection<C, B>
where C: Freeze, <C as OpenStreams<B>>::SendStream: Freeze, <C as Connection<B>>::RecvStream: Freeze,

§

impl<C, B> !RefUnwindSafe for Connection<C, B>

§

impl<C, B> Send for Connection<C, B>
where C: Send, <C as OpenStreams<B>>::SendStream: Send, B: Send, <C as Connection<B>>::RecvStream: Send,

§

impl<C, B> Sync for Connection<C, B>
where C: Sync, <C as OpenStreams<B>>::SendStream: Sync, B: Sync, <C as Connection<B>>::RecvStream: Sync,

§

impl<C, B> Unpin for Connection<C, B>
where C: Unpin, <C as OpenStreams<B>>::SendStream: Unpin, B: Unpin,

§

impl<C, B> !UnwindSafe for Connection<C, 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.