Struct H3Driver

pub struct H3Driver<H: DriverHooks> { /* private fields */ }

A ready-made ApplicationOverQuic which can handle HTTP/3 and MASQUE. Depending on the DriverHooks in use, it powers either a client or a server.

Use the ClientH3Driver and ServerH3Driver aliases to access the respective driver types. The driver is passed into an I/O loop and communicates with the driver’s user (e.g., an HTTP client or a server) via its associated H3Controller. The controller allows the application to both listen for H3Events of note and send H3Commands into the I/O loop.

Implementations

impl<H: DriverHooks> H3Driver<H>

pub fn new(http3_settings: Http3Settings) -> (Self, H3Controller<H>)

Builds a new H3Driver and an associated H3Controller.

The driver should then be passed to InitialQuicConnection’s start method.

Trait Implementations

impl<H: DriverHooks> ApplicationOverQuic for H3Driver<H>

fn process_reads(&mut self, qconn: &mut QuicheConnection) -> QuicResult<()>

Poll the underlying [quiche::h3::Connection] for [quiche::h3::Event]s and DATAGRAMs, delegating processing to Self::process_read_event.

If a DATAGRAM is found, it is sent to the receiver on its channel.

fn process_writes(&mut self, qconn: &mut QuicheConnection) -> QuicResult<()>

Write as much data as possible into the [quiche::h3::Connection] from all sources. This will attempt to write any queued frames into their respective streams, if writable.

fn on_conn_close<M: Metrics>( &mut self, quiche_conn: &mut QuicheConnection, metrics: &M, work_loop_result: &QuicResult<()>, )

Reports connection-level error metrics and forwards IOWorker errors to the associated H3Controller.

async fn wait_for_data( &mut self, qconn: &mut QuicheConnection, ) -> QuicResult<()>

Wait for incoming data from the H3Controller. The next iteration of the I/O loop commences when one of the select!ed futures triggers.

fn on_conn_established( &mut self, quiche_conn: &mut QuicheConnection, handshake_info: &HandshakeInfo, ) -> QuicResult<()>

Callback to customize the ApplicationOverQuic after the QUIC handshake completed successfully.

fn should_act(&self) -> bool

Determines whether the application’s methods will be called by the worker.

fn buffer(&mut self) -> &mut [u8]

A borrowed buffer for the worker to write outbound packets into.

impl<H: DriverHooks> Drop for H3Driver<H>

fn drop(&mut self)

Executes the destructor for this type.