Builder

Struct Builder

pub struct Builder { /* private fields */ }

Expand description

HTTP/3 client builder

Set the configuration for a new client.

§Examples

let h3_conn = h3::client::builder()
    .max_field_section_size(8192)
    .build(quic)
    .await
    .expect("Failed to build connection");

Implementations§

impl Builder

pub fn max_field_section_size(&mut self, value: u64) -> &mut Self

Set the maximum header size this client is willing to accept

See header size constraints section of the specification for details.

pub fn send_grease(&mut self, enabled: bool) -> &mut Self

Just like in HTTP/2, HTTP/3 also uses the concept of “grease” to prevent potential interoperability issues in the future. In HTTP/3, the concept of grease is used to ensure that the protocol can evolve and accommodate future changes without breaking existing implementations.

pub fn enable_datagram(&mut self, enabled: bool) -> &mut Self

Indicates that the client supports HTTP/3 datagrams

See: https://www.rfc-editor.org/rfc/rfc9297#section-2.1.1

pub fn enable_extended_connect(&mut self, value: bool) -> &mut Self

Enables the extended CONNECT protocol required for various HTTP/3 extensions.

pub async fn build<C, O, B>( &mut self, quic: C, ) -> Result<(Connection<C, B>, SendRequest<O, B>), ConnectionError>
where C: Connection<B, OpenStreams = O>, O: OpenStreams<B>, B: Buf,

Create a new HTTP/3 client from a quic connection

Auto Trait Implementations§

impl Freeze for Builder

impl RefUnwindSafe for Builder

impl Send for Builder

impl Sync for Builder

impl Unpin for Builder

impl UnwindSafe for Builder

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, 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, 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.