rocks.xmpp.extensions.httpbind

Class BoshConnectionConfiguration

java.lang.Object

rocks.xmpp.core.session.ConnectionConfiguration

rocks.xmpp.extensions.httpbind.BoshConnectionConfiguration

public final class BoshConnectionConfiguration
extends ConnectionConfiguration

A configuration for a BOSH connection. It allows you to configure basic connection settings like hostname and port, but also BOSH specific settings like the wait interval, a route or the use of a key sequencing mechanism.

Usage

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

 
 BoshConnectionConfiguration boshConnectionConfiguration = BoshConnectionConfiguration.builder()
     .hostname("localhost")
     .port(5280)
     .file("/http-bind/")
     .build();
 
 

The above sample configuration will connect to http://localhost:5280/http-bind/.

This class is immutable.

See Also:

TcpConnectionConfiguration, BoshConnection

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static BoshConnectionConfiguration.Builder	builder() Creates a new builder.
Connection	createConnection(XmppSession xmppSession) A factory method to create the connection.
static BoshConnectionConfiguration	getDefault() Gets the default configuration.
String	getFile() Gets the file on the host, e.g.
String	getRoute() Gets the route.
int	getWait() Gets the longest time (in seconds) that the connection manager is allowed to wait before responding to any request during the session.
boolean	isUseKeySequence() If the connection is secured via a key sequence mechanism.
static void	setDefault(BoshConnectionConfiguration configuration) Sets the default configuration.

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, toString, wait, wait, wait

Method Detail

getDefault

public static BoshConnectionConfiguration getDefault()

Gets the default configuration.

Returns:

The default configuration.

setDefault

public static void setDefault(BoshConnectionConfiguration configuration)

Sets the default configuration.

Parameters:

configuration - The default configuration.

builder

public static BoshConnectionConfiguration.Builder builder()

Creates a new builder.

Returns:

The builder.

createConnection

public 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.

getWait

public final int getWait()

Gets the longest time (in seconds) that the connection manager is allowed to wait before responding to any request during the session.

Returns:

The wait time.

getFile

public final String getFile()

Gets the file on the host, e.g. "/http-bind/".

Returns:

The file on the host.

getRoute

public final String getRoute()

Gets the route.

Returns:

The route.

isUseKeySequence

public final boolean isUseKeySequence()

If the connection is secured via a key sequence mechanism.

Returns:

If the connection is secured via a key sequence mechanism.