Struct Request 

pub struct Request { /* private fields */ }

An incoming WebTransport handshake: the CONNECT request, ready to answer.

Produced by accept on a connection whose ALPN negotiated h3. Answer with respond (or ok) to get the Session, or reject to refuse it.

Implementations

impl Request

pub async fn accept(conn: Connection) -> Result<Self, Error>

Run the server side of the HTTP/3 handshake: exchange SETTINGS, then take the CONNECT request.

Everything the session later spawns runs on the worker already driving conn. There is no timeout here; a peer that stalls mid-handshake is bounded by the connection’s idle timeout.

pub fn url(&self) -> &Url

The URL the peer connected to; the path and query are what a server routes and authenticates on. The url crate is re-exported so naming this type needs no dependency of your own.

pub fn protocols(&self) -> &[String]

The subprotocols the peer offered, the WebTransport equivalent of ALPN. Pick one and name it in respond.

pub async fn respond(self, response: Response) -> Result<Session, Error>

Accept with a 200, answering as response describes.

pub async fn ok(self) -> Result<Session, Error>

Accept with a 200 and no subprotocol.

pub async fn reject(self, reason: Rejected) -> Result<(), Error>

Refuse with reason, ending the handshake.

Returns once the peer has the response, or after a grace period if it never acknowledges one, and closes the connection deliberately. The HTTP/3 critical streams (the peer’s control and QPACK streams, and ours) stay open until then: RFC 9114 makes closing one a connection error, so tearing them down here would show the peer an H3 failure instead of the status it was sent.

Trait Implementations

impl Debug for Request

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

Formats the value using the given formatter.