org.spincast.plugins.httpclient.websocket.builders

Interface IWebsocketRequestBuilder

All Superinterfaces:

IHttpRequestBuilder<IWebsocketRequestBuilder>

All Known Implementing Classes:

WebsocketRequestBuilder

public interface IWebsocketRequestBuilder
extends IHttpRequestBuilder<IWebsocketRequestBuilder>

Builder to create a WebSocket requesté

Method Summary

Modifier and Type	Method and Description
IWebsocketClientWriter	connect(IWebsocketClientHandler handler) Sends the request and establish the WebSocket connection.
IWebsocketRequestBuilder	ping(int seconds) You can use this to configure the pings that are automatically sent to the Websocket endpoint every X seconds.
IHttpResponse	send() Sends the request and gets the HTTP response.

Methods inherited from interface org.spincast.plugins.httpclient.IHttpRequestBuilder

addCookie, addCookie, addCookies, addHeaderValue, addHeaderValues, addHTMLAcceptHeader, addJsonAcceptHeader, addPlainTextAcceptHeader, addXMLAcceptHeader, disableSslCertificateErrors, setHeaders, setHeaderValues, setHttpAuthCredentials, setHttpClientBuilder, setRequestConfig

Method Detail

ping

IWebsocketRequestBuilder ping(int seconds)

You can use this to configure the pings that are automatically sent to the Websocket endpoint every X seconds. IWebsocketClientHandler#onConnectionClosed() will be called if the connection is closed.

Use a value <= 0 to disable the pings.

The automatic pings and their default interval are also configurable using: ISpincastHttpClientWithWebsocketConfig#isWebsocketAutomaticPingEnabled()
and
ISpincastHttpClientWithWebsocketConfig#getWebsocketAutomaticPingIntervalSeconds()

Pings are enabled by default.

Parameters:

seconds - the interval in seconds or <= 0 to disable the pings.

connect

IWebsocketClientWriter connect(IWebsocketClientHandler handler)

Sends the request and establish the WebSocket connection.

Parameters:

handler - The handler that is responsible to handle the various WebSocket events.

Returns:

a writer to send WebSocket messages to the connected endpoint.

send

IHttpResponse send()

Sends the request and gets the HTTP response. Does not make the actual upgrade to a WebSocket connection! Use the connect(...) method if you want the actual WebSocket connection to be made.

This version is useful to debug the intermediate HTTP upgrade response made from the server before the actual WebSocket connection is established.

Specified by:

send in interface IHttpRequestBuilder<IWebsocketRequestBuilder>