Enum websocket_server::Message

pub enum Message {
    Text(String),
    Binary(Vec<u8>),
    Close(Option<CloseData>),
    Ping(Vec<u8>),
    Pong(Vec<u8>),
}

Represents an owned WebSocket message.

OwnedMessages are generated when the user receives a message (since the data has to be copied out of the network buffer anyway). If you would like to create a message out of borrowed data to use for sending please use the Message struct (which contains a Cow).

Note that OwnedMessage can Message can be converted into each other.

Variants

Text(String)

A message containing UTF-8 text data

Binary(Vec<u8>)

A message containing binary data

Close(Option<CloseData>)

A message which indicates closure of the WebSocket connection. This message may or may not contain data.

Ping(Vec<u8>)

A ping message - should be responded to with a pong message. Usually the pong message will be sent with the same data as the received ping message.

Pong(Vec<u8>)

A pong message, sent in response to a Ping message, usually containing the same data as the received ping message.

Methods

impl OwnedMessage

fn is_close(&self) -> bool

Checks if this message is a close message.

assert!(OwnedMessage::Close(None).is_close());

fn is_control(&self) -> bool

Checks if this message is a control message. Control messages are either Close, Ping, or Pong.

assert!(OwnedMessage::Ping(vec![]).is_control());
assert!(OwnedMessage::Pong(vec![]).is_control());
assert!(OwnedMessage::Close(None).is_control());

fn is_data(&self) -> bool

Checks if this message is a data message. Data messages are either Text or Binary.

assert!(OwnedMessage::Text("1337".to_string()).is_data());
assert!(OwnedMessage::Binary(vec![]).is_data());

fn is_ping(&self) -> bool

Checks if this message is a ping message. Ping messages can come at any time and usually generate a Pong message response.

assert!(OwnedMessage::Ping("ping".to_string().into_bytes()).is_ping());

fn is_pong(&self) -> bool

Checks if this message is a pong message. Pong messages are usually sent only in response to Ping messages.

assert!(OwnedMessage::Pong("pong".to_string().into_bytes()).is_pong());

Trait Implementations

impl Eq for OwnedMessage

impl Debug for OwnedMessage

fn fmt(&self, __arg_0: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl Message for OwnedMessage

fn serialize(
    &self,
    writer: &mut Write,
    masked: bool
) -> Result<(), WebSocketError>

Attempt to form a message from a series of data frames

fn message_size(&self, masked: bool) -> usize

Returns how many bytes this message will take up

fn from_dataframes<D>(frames: Vec<D>) -> Result<OwnedMessage, WebSocketError> where
    D: DataFrame, 

Attempt to form a message from a series of data frames

impl DataFrame for OwnedMessage

fn is_last(&self) -> bool

fn opcode(&self) -> u8

fn reserved(&self) -> &[bool; 3]

fn size(&self) -> usize

fn write_payload(&self, socket: &mut Write) -> Result<(), WebSocketError>

fn take_payload(self) -> Vec<u8>

impl<'m> From<Message<'m>> for OwnedMessage

fn from(message: Message<'m>) -> OwnedMessage

impl PartialEq<OwnedMessage> for OwnedMessage

fn eq(&self, __arg_0: &OwnedMessage) -> bool

fn ne(&self, __arg_0: &OwnedMessage) -> bool

impl Clone for OwnedMessage

fn clone(&self) -> OwnedMessage

Returns a copy of the value.

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

Performs copy-assignment from source.