Enum websocket::message::OwnedMessage

[+] Show declaration

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 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 dyn 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 dyn Write, mask: bool) -> WebSocketResult<()>

[−]

Writes a DataFrame to a Writer.

impl Message for OwnedMessage

[+]

fn serialize(&self, writer: &mut dyn 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 PartialEq<OwnedMessage> for OwnedMessage

[+]

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

[−]

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

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

[−]

This method tests for !=.

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.

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 Eq for OwnedMessage

impl Debug for OwnedMessage

[+]

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

[−]

Formats the value using the given formatter.