Struct websocket_lite::ClientBuilder

pub struct ClientBuilder { /* fields omitted */ }

Establishes a WebSocket connection.

ws://... and wss://... URLs are supported.

Methods

impl ClientBuilder

pub fn new(url: &str) -> Result<Self, ParseError>

Creates a ClientBuilder that connects to a given WebSocket URL.

This method returns an Err result if URL parsing fails.

pub fn from_url(url: Url) -> Self

Creates a ClientBuilder that connects to a given WebSocket URL.

This method never fails as the URL has already been parsed.

pub fn async_connect_insecure(     self ) -> impl Future<Item = Client<TcpStream>, Error = Error>

Establish a connection to the WebSocket server.

pub fn async_connect(     self ) -> impl Future<Item = Client<Box<dyn AsyncNetworkStream + Sync + Send + 'static>>, Error = Error>

Establish a connection to the WebSocket server.

pub fn async_connect_on<S: AsyncRead + AsyncWrite>(     self,     stream: S ) -> impl Future<Item = Client<S>, Error = Error>

Take over an already established stream and use it to send and receive WebSocket messages.

This method assumes that the TLS connection has already been established, if needed. It sends an HTTP Connection: Upgrade request and waits for an HTTP OK response before proceeding.