rocks.xmpp.websocket.net.client

Class WebSocketConnectionConfiguration

java.lang.Object

rocks.xmpp.core.net.client.ClientConnectionConfiguration

rocks.xmpp.websocket.net.client.WebSocketConnectionConfiguration

All Implemented Interfaces:

ConnectionConfiguration

public final class WebSocketConnectionConfiguration
extends ClientConnectionConfiguration

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)
.channelEncryption(ChannelEncryption.DIRECT)
.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.
java.lang.String	getPath() Gets the path on the host, e.g.
java.time.Duration	getPingInterval() Gets the ping interval.
static void	setDefault(WebSocketConnectionConfiguration configuration) Sets the default configuration.
java.lang.String	toString()

Methods inherited from class rocks.xmpp.core.net.client.ClientConnectionConfiguration

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

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 java.lang.String getPath()

Gets the path on the host, e.g. “/ws/”.

Returns:

The path on the host.

getPingInterval

public final java.time.Duration getPingInterval()

Gets the ping interval.

Returns:

The ping interval.

See Also:

WebSocketConnectionConfiguration.Builder.pingInterval(Duration)

createConnection

public final Connection createConnection(XmppSession xmppSession)
                                  throws java.lang.Exception

Description copied from class: ClientConnectionConfiguration

A factory method to create the connection.

Specified by:

createConnection in class ClientConnectionConfiguration

Parameters:

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

Returns:

The connection.

Throws:

java.lang.Exception - Any exception which may occur during connection establishment.

toString

public final java.lang.String toString()

Overrides:

toString in class ClientConnectionConfiguration