Crate websocket

Rust-WebSocket is a WebSocket (RFC6455) library written in Rust.

Clients

WebSocket clients make use of the Client object, which features two connection functions: connect() and connect_ssl_context(). See the Client struct documentation for more information. These both return a client-side Request object which is sent to the server with the send() method. The Request can be altered, typically using Request.headers.set() to add additional headers or change existing ones before calling send().

Calling send() on a Request will obtain a Response, which can be checked with the validate() method, which will return Ok(()) if the response is a valid one. Data frames and messages can then be sent by obtaining a Client object with begin().

Servers

WebSocket servers act similarly to the TcpListener, and listen for connections. See the Server struct documentation for more information. The bind() and bind_secure() functions will bind the server to the given SocketAddr. Server implements Iterator and can be used to iterate over incoming Request items.

Requests can be validated using validate(), and other parts of the request may be examined (e.g. the Host header and/or the Origin header). A call to accept() or fail() will generate a Response which either accepts the connection, or denies it respectively.

A Response can then be altered if necessary, and is sent with the 'send()method, returning aClient` ready to send and receive data frames or messages.

Extending Rust-WebSocket

The ws module contains the traits and functions used by Rust-WebSockt at a lower level. Their usage is explained in the module documentation.

Reexports

pub extern crate url;

pub use self::client::Client;

pub use self::client::ClientBuilder;

pub use self::server::Server;

pub use self::dataframe::DataFrame;

pub use self::message::Message;

pub use self::stream::Stream;

pub use self::ws::Sender;

pub use self::ws::Receiver;

Modules

client	Contains the WebSocket client.
dataframe	Module containing the default implementation of data frames.
header	Structs representing headers relevant in a WebSocket context.
message	Module containing the default implementation for messages.
receiver	The default implementation of a WebSocket Receiver.
result	The result type used within Rust-WebSocket
sender	The default implementation of a WebSocket Sender.
server	Provides an implementation of a WebSocket server
stream	Provides the default stream type for WebSocket connections.
ws	A module containing the traits and structs that lower layer of Rust-WebSocket is based on.