Struct web_transport::Session

pub struct Session(/* private fields */);

A WebTransport Session, able to accept/create streams and send/recv datagrams.

The session can be cloned to create multiple handles. The session will be closed with on drop.

Implementations

impl Session

pub async fn accept_uni(&mut self) -> Result<RecvStream, SessionError>

Block until the peer creates a new unidirectional stream.

pub async fn accept_bi( &mut self, ) -> Result<(SendStream, RecvStream), SessionError>

Block until the peer creates a new bidirectional stream.

pub async fn open_bi( &mut self, ) -> Result<(SendStream, RecvStream), SessionError>

Open a new bidirectional stream, which may block when there are too many concurrent streams.

pub async fn open_uni(&mut self) -> Result<SendStream, SessionError>

Open a new unidirectional stream, which may block when there are too many concurrent streams.

pub async fn send_datagram( &mut self, payload: Bytes, ) -> Result<(), SessionError>

Send a datagram over the network.

QUIC datagrams may be dropped for any reason:

• Network congestion.
• Random packet loss.
• Payload is larger than max_datagram_size()
• Peer is not receiving datagrams.
• Peer has too many outstanding datagrams.
• ???

pub async fn max_datagram_size(&self) -> usize

The maximum size of a datagram that can be sent.

pub async fn recv_datagram(&mut self) -> Result<Bytes, SessionError>

Receive a datagram over the network.

pub fn close(self, code: u32, reason: &str)

Close the connection immediately with a code and reason.

pub async fn closed(&self) -> SessionError

Block until the connection is closed.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<Session> for Session

Convert a web_transport_quinn::Session into a web_transport::Session.

fn from(session: Session) -> Self

Converts to this type from the input type.