kvarn::application

Enum HttpConnection

pub enum HttpConnection {
    Http1(Arc<Mutex<Encryption>>),
    Http2(Box<Connection<Encryption, Bytes>>),
    Http3(Box<Connection<Connection, Bytes>>),
}

Expand description

A single HTTP connection.

See HttpConnection::new on how to make one and HttpConnection::accept on getting a FatRequest.

Variants§

Http1(Arc<Mutex<Encryption>>)

An HTTP/1 connection

Http2(Box<Connection<Encryption, Bytes>>)

Available on crate feature http2 only.

An HTTP/2 connection

This is boxed because a [h2::server::Connection] takes up over 1000 bytes of memory, and an Arc 8 bytes. It will increase performance on servers with both HTTP/1 and HTTP/2 connections, but slightly hurt exclusively HTTP/2 servers.

We’ll see how we move forward once HTTP/3 support lands.

Http3(Box<Connection<Connection, Bytes>>)

Available on crate feature http3 only.

An HTTP/3 conenction.

Implementations§

impl HttpConnection

pub async fn new(stream: Encryption, version: Version) -> Result<Self, Error>

Creates a new HttpConnection from an Encryption stream.

§Errors

Returns Error::VersionNotSupported when a unsupported version is passed.

Also passes errors from [h2::server::handshake].

pub async fn accept( &mut self, default_host: Option<&[u8]>, ) -> Result<(Request<Body>, ResponsePipe), Error>

Accept a single request. default_host will be used if the Host header is not present on a HTTP/1.x request.

§Errors

Returns any errors emitted from [h2::server::Connection::accept()].

pub async fn shutdown(self)

Ask this connection to shutdown.

Trait Implementations§

impl Debug for HttpConnection

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

impl Freeze for HttpConnection

impl !RefUnwindSafe for HttpConnection

impl !Send for HttpConnection

impl !Sync for HttpConnection

impl Unpin for HttpConnection

impl !UnwindSafe for HttpConnection

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Pointable for T

const ALIGN: usize = _

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

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

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more