Struct tungstenite::protocol::WebSocketContext

pub struct WebSocketContext { /* fields omitted */ }

A context for managing WebSocket stream.

Methods

impl WebSocketContext

pub fn new(role: Role, config: Option<WebSocketConfig>) -> Self

Create a WebSocket context that manages a post-handshake stream.

pub fn from_partially_read(
    part: Vec<u8>,
    role: Role,
    config: Option<WebSocketConfig>
) -> Self

Create a WebSocket context that manages an post-handshake stream.

pub fn set_config(&mut self, set_func: impl FnOnce(&mut WebSocketConfig))

Change the configuration.

pub fn read_message<Stream>(&mut self, stream: &mut Stream) -> Result<Message> where
    Stream: Read + Write, 

Read a message from the provided stream, if possible.

This function sends pong and close responses automatically. However, it never blocks on write.

pub fn write_message<Stream>(
    &mut self,
    stream: &mut Stream,
    message: Message
) -> Result<()> where
    Stream: Read + Write, 

Send a message to the provided stream, if possible.

WebSocket will buffer a configurable number of messages at a time, except to reply to Ping and Close requests. If the WebSocket's send queue is full, SendQueueFull will be returned along with the passed message. Otherwise, the message is queued and Ok(()) is returned.

Note that only the last pong frame is stored to be sent, and only the most recent pong frame is sent if multiple pong frames are queued.

pub fn write_pending<Stream>(&mut self, stream: &mut Stream) -> Result<()> where
    Stream: Read + Write, 

Flush the pending send queue.

pub fn close<Stream>(
    &mut self,
    stream: &mut Stream,
    code: Option<CloseFrame>
) -> Result<()> where
    Stream: Read + Write, 

Close the connection.

This function guarantees that the close frame will be queued. There is no need to call it again. Calling this function is the same as calling write(Message::Close(..)).

Trait Implementations

impl Debug for WebSocketContext

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

Formats the value using the given formatter.