rocks.xmpp.websocket

Class WebSocketConnectionConfiguration

java.lang.Object

rocks.xmpp.core.session.ConnectionConfiguration

rocks.xmpp.websocket.WebSocketConnectionConfiguration

public final class WebSocketConnectionConfiguration
extends ConnectionConfiguration

A configuration for a WebSocket connection. It allows you to configure basic connection settings like hostname and port, as well as the path in the WebSocket URI.

Usage

In order to create an instance of this class you have to use the builder pattern as shown below.

 
 WebSocketConnectionConfiguration connectionConfiguration = WebSocketConnectionConfiguration.builder()
     .hostname("localhost")
     .port(7443)
     .path("/ws/")
     .sslContext(sslContext)
     .secure(true)
     .build();
 
 

The above sample configuration will connect to wss://localhost:7443/ws/ using SSL with a custom SSLContext.

This class is immutable.

Since:

0.7.0

See Also:

WebSocketConnection, XMPP Subprotocol for WebSocket

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WebSocketConnectionConfiguration.Builder A builder to create a WebSocketConnectionConfiguration instance.

Method Summary

Modifier and Type	Method and Description
static WebSocketConnectionConfiguration.Builder	builder() Creates a new builder.
Connection	createConnection(XmppSession xmppSession) A factory method to create the connection.
static WebSocketConnectionConfiguration	getDefault() Gets the default configuration.
String	getPath() Gets the path on the host, e.g.
Duration	getPingInterval() Gets the ping interval.
static void	setDefault(WebSocketConnectionConfiguration configuration) Sets the default configuration.
String	toString()

Methods inherited from class rocks.xmpp.core.session.ConnectionConfiguration

getCompressionMethods, getConnectTimeout, getHostname, getHostnameVerifier, getPort, getProxy, getSSLContext, isSecure

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getDefault

public static WebSocketConnectionConfiguration getDefault()

Gets the default configuration.

Returns:

The default configuration.

setDefault

public static void setDefault(WebSocketConnectionConfiguration configuration)

Sets the default configuration.

Parameters:

configuration - The default configuration.

builder

public static WebSocketConnectionConfiguration.Builder builder()

Creates a new builder.

Returns:

The builder.

getPath

public final String getPath()

Gets the path on the host, e.g. "/ws/".

Returns:

The path on the host.

getPingInterval

public final Duration getPingInterval()

Gets the ping interval.

Returns:

The ping interval.

See Also:

WebSocketConnectionConfiguration.Builder.pingInterval(Duration)

createConnection

public final Connection createConnection(XmppSession xmppSession)

Description copied from class: ConnectionConfiguration

A factory method to create the connection.

Specified by:

createConnection in class ConnectionConfiguration

Parameters:

xmppSession - The XMPP session, which is associated with the connection.

Returns:

The connection.

toString

public final String toString()

Overrides:

toString in class ConnectionConfiguration