Struct 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, Error>

Block until the peer creates a new unidirectional stream.

Won’t return None unless the connection is closed.

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

Block until the peer creates a new bidirectional stream.

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

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

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

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<(), Error>

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

Receive a datagram over the network.

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

Close the connection immediately with a code and reason.

pub async fn closed(&self) -> Error

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.

impl PartialEq for Session

fn eq(&self, other: &Session) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Session

impl StructuralPartialEq for Session