Enum websocket::message::OwnedMessage

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

[−] Expand description

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 and Message can be converted into each other.

Variants

Text(String)

[−] Expand description

A message containing UTF-8 text data

Binary(Vec<u8>)

[−] Expand description

A message containing binary data

Close(Option<CloseData>)

[−] Expand description

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

Ping(Vec<u8>)

[−] Expand description

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>)

[−] Expand description

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

Methods

impl OwnedMessage[−]

pub fn is_close(&self) -> bool[−]

Checks if this message is a close message.

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

pub 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());

pub 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());

pub 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());

pub 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 PartialEq for OwnedMessage[+]

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

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.

impl Debug for OwnedMessage[+]

fn fmt(&self, __arg_0: &mut Formatter) -> Result[−]

Formats the value using the given formatter.

impl Message for OwnedMessage[+]

fn serialize(&self, writer: &mut Write, masked: bool) -> WebSocketResult<()>[−]

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>) -> WebSocketResult<Self> where
    D: DataFrameTrait, [−]

Attempt to form a message from a series of data frames

impl DataFrame for OwnedMessage[+]

fn is_last(&self) -> bool[−]

Is this dataframe the final dataframe of the message?

fn opcode(&self) -> u8[−]

What type of data does this dataframe contain?

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

Reserved bits of this dataframe

fn size(&self) -> usize[−]

How long (in bytes) is this dataframe's payload

fn write_payload(&self, socket: &mut Write) -> WebSocketResult<()>[−]

Write the payload to a writer

Important traits for Vec<u8>

impl Write for Vec<u8>

fn take_payload(self) -> Vec<u8>[−]

Takes the payload out into a vec

fn frame_size(&self, masked: bool) -> usize[−]

Get's the size of the entire dataframe in bytes, i.e. header and payload.

fn write_to(&self, writer: &mut Write, mask: bool) -> WebSocketResult<()>[−]

Writes a DataFrame to a Writer.

impl<'m> From<Message<'m>> for OwnedMessage[+]

fn from(message: Message<'m>) -> Self[−]

Performs the conversion.

impl<'m> From<OwnedMessage> for Message<'m>[+]

fn from(message: OwnedMessage) -> Self[−]

Performs the conversion.