org.jivesoftware.smack

Class ConnectionConfiguration

java.lang.Object

org.jivesoftware.smack.ConnectionConfiguration

All Implemented Interfaces:

Cloneable

public class ConnectionConfiguration
extends Object
implements Cloneable

Configuration to use while establishing the connection to the server. It is possible to configure the path to the trustore file that keeps the trusted CA root certificates and enable or disable all or some of the checkings done while verifying server certificates.

It is also possible to configure if TLS, SASL, and compression are used or not.

Author:

Gaston Dombiak

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConnectionConfiguration.SecurityMode An enumeration for TLS security modes that are available when making a connection to the XMPP server.

Field Summary

Fields

Modifier and Type	Field and Description
protected List<HostAddress>	hostAddresses
protected ProxyInfo	proxy

Constructor Summary

Constructors

Constructor and Description
ConnectionConfiguration(String serviceName) Creates a new ConnectionConfiguration for the specified service name.
ConnectionConfiguration(String host, int port) Creates a new ConnectionConfiguration for a connection that will connect to the desired host and port.
ConnectionConfiguration(String host, int port, ProxyInfo proxy) Creates a new ConnectionConfiguration for a connection that will connect to the desired host and port with desired proxy.
ConnectionConfiguration(String host, int port, String serviceName) Creates a new ConnectionConfiguration using the specified host, port and service name.
ConnectionConfiguration(String host, int port, String serviceName, ProxyInfo proxy) Creates a new ConnectionConfiguration using the specified host, port and service name.
ConnectionConfiguration(String serviceName, ProxyInfo proxy) Creates a new ConnectionConfiguration for the specified service name with specified proxy.

Method Summary

Methods

Modifier and Type	Method and Description
CallbackHandler	getCallbackHandler() Returns a CallbackHandler to obtain information, such as the password or principal information during the SASL authentication.
SSLContext	getCustomSSLContext() Gets the custom SSLContext for SSL sockets.
String	getHost() Returns the host to use when establishing the connection.
List<HostAddress>	getHostAddresses()
String	getKeystorePath() Retuns the path to the keystore file.
String	getKeystoreType() Returns the keystore type, or null if it's not set.
String	getPKCS11Library() Returns the PKCS11 library file location, needed when the Keystore type is PKCS11.
int	getPort() Returns the port to use when establishing the connection.
RosterStore	getRosterStore() Get the permanent roster store
ConnectionConfiguration.SecurityMode	getSecurityMode() Returns the TLS security mode used when making the connection.
String	getServiceName() Returns the server name of the target server.
SocketFactory	getSocketFactory() Returns the socket factory used to create new xmppConnection sockets.
protected void	init(String serviceName, ProxyInfo proxy)
boolean	isCompressionEnabled() Returns true if the connection is going to use stream compression.
boolean	isDebuggerEnabled() Returns true if the new connection about to be establish is going to be debugged.
boolean	isReconnectionAllowed() Returns if the reconnection mechanism is allowed to be used.
boolean	isRosterLoadedAtLogin() Returns true if the roster will be loaded from the server when logging in.
boolean	isSASLAuthenticationEnabled() Returns true if the client is going to use SASL authentication when logging into the server.
void	setCallbackHandler(CallbackHandler callbackHandler) Sets a CallbackHandler to obtain information, such as the password or principal information during the SASL authentication.
void	setCompressionEnabled(boolean compressionEnabled) Sets if the connection is going to use stream compression.
void	setCustomSSLContext(SSLContext context) Sets a custom SSLContext for creating SSL sockets.
void	setDebuggerEnabled(boolean debuggerEnabled) Sets if the new connection about to be establish is going to be debugged.
void	setKeystorePath(String keystorePath) Sets the path to the keystore file.
void	setKeystoreType(String keystoreType) Sets the keystore type.
void	setPKCS11Library(String pkcs11Library) Sets the PKCS11 library file location, needed when the Keystore type is PKCS11
void	setReconnectionAllowed(boolean isAllowed) Sets if the reconnection mechanism is allowed to be used.
void	setRosterLoadedAtLogin(boolean rosterLoadedAtLogin) Sets if the roster will be loaded from the server when logging in.
void	setRosterStore(RosterStore store) Set the permanent roster store
void	setSASLAuthenticationEnabled(boolean saslAuthenticationEnabled) Sets whether the client will use SASL authentication when logging into the server.
void	setSecurityMode(ConnectionConfiguration.SecurityMode securityMode) Sets the TLS security mode used when making the connection.
void	setSendPresence(boolean sendPresence) Sets if an initial available presence will be sent to the server.
void	setServiceName(String serviceName) Sets the server name, also known as XMPP domain of the target server.
void	setSocketFactory(SocketFactory socketFactory) Sets the socket factory used to create new xmppConnection sockets.
void	setUsedHostAddress(HostAddress hostAddress)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

hostAddresses

protected List<HostAddress> hostAddresses

proxy

protected ProxyInfo proxy

Constructor Detail

ConnectionConfiguration

public ConnectionConfiguration(String serviceName)

Creates a new ConnectionConfiguration for the specified service name. A DNS SRV lookup will be performed to find out the actual host address and port to use for the connection.

Parameters:

serviceName - the name of the service provided by an XMPP server.

ConnectionConfiguration

public ConnectionConfiguration(String serviceName,
                       ProxyInfo proxy)

Creates a new ConnectionConfiguration for the specified service name with specified proxy. A DNS SRV lookup will be performed to find out the actual host address and port to use for the connection.

Parameters:

serviceName - the name of the service provided by an XMPP server.

proxy - the proxy through which XMPP is to be connected

ConnectionConfiguration

public ConnectionConfiguration(String host,
                       int port,
                       String serviceName)

Creates a new ConnectionConfiguration using the specified host, port and service name. This is useful for manually overriding the DNS SRV lookup process that's used with the ConnectionConfiguration(String) constructor. For example, say that an XMPP server is running at localhost in an internal network on port 5222 but is configured to think that it's "example.com" for testing purposes. This constructor is necessary to connect to the server in that case since a DNS SRV lookup for example.com would not point to the local testing server.

Parameters:

host - the host where the XMPP server is running.

port - the port where the XMPP is listening.

serviceName - the name of the service provided by an XMPP server.

ConnectionConfiguration

public ConnectionConfiguration(String host,
                       int port,
                       String serviceName,
                       ProxyInfo proxy)

Creates a new ConnectionConfiguration using the specified host, port and service name. This is useful for manually overriding the DNS SRV lookup process that's used with the ConnectionConfiguration(String) constructor. For example, say that an XMPP server is running at localhost in an internal network on port 5222 but is configured to think that it's "example.com" for testing purposes. This constructor is necessary to connect to the server in that case since a DNS SRV lookup for example.com would not point to the local testing server.

Parameters:

host - the host where the XMPP server is running.

port - the port where the XMPP is listening.

serviceName - the name of the service provided by an XMPP server.

proxy - the proxy through which XMPP is to be connected

ConnectionConfiguration

public ConnectionConfiguration(String host,
                       int port)

Creates a new ConnectionConfiguration for a connection that will connect to the desired host and port.

Parameters:

host - the host where the XMPP server is running.

port - the port where the XMPP is listening.

ConnectionConfiguration

public ConnectionConfiguration(String host,
                       int port,
                       ProxyInfo proxy)

Creates a new ConnectionConfiguration for a connection that will connect to the desired host and port with desired proxy.

Parameters:

host - the host where the XMPP server is running.

port - the port where the XMPP is listening.

proxy - the proxy through which XMPP is to be connected

Method Detail

init

protected void init(String serviceName,
        ProxyInfo proxy)

setServiceName

public void setServiceName(String serviceName)

Sets the server name, also known as XMPP domain of the target server.

Parameters:

serviceName - the XMPP domain of the target server.

getServiceName

public String getServiceName()

Returns the server name of the target server.

Returns:

the server name of the target server.

getHost

public String getHost()

Returns the host to use when establishing the connection. The host and port to use might have been resolved by a DNS lookup as specified by the XMPP spec (and therefore may not match the service name.

Returns:

the host to use when establishing the connection.

getPort

public int getPort()

Returns the port to use when establishing the connection. The host and port to use might have been resolved by a DNS lookup as specified by the XMPP spec.

Returns:

the port to use when establishing the connection.

setUsedHostAddress

public void setUsedHostAddress(HostAddress hostAddress)

getSecurityMode

public ConnectionConfiguration.SecurityMode getSecurityMode()

Returns the TLS security mode used when making the connection. By default, the mode is ConnectionConfiguration.SecurityMode.enabled.

Returns:

the security mode.

setSecurityMode

public void setSecurityMode(ConnectionConfiguration.SecurityMode securityMode)

Sets the TLS security mode used when making the connection. By default, the mode is ConnectionConfiguration.SecurityMode.enabled.

Parameters:

securityMode - the security mode.

getKeystorePath

public String getKeystorePath()

Retuns the path to the keystore file. The key store file contains the certificates that may be used to authenticate the client to the server, in the event the server requests or requires it.

Returns:

the path to the keystore file.

setKeystorePath

public void setKeystorePath(String keystorePath)

Sets the path to the keystore file. The key store file contains the certificates that may be used to authenticate the client to the server, in the event the server requests or requires it.

Parameters:

keystorePath - the path to the keystore file.

getKeystoreType

public String getKeystoreType()

Returns the keystore type, or null if it's not set.

Returns:

the keystore type.

setKeystoreType

public void setKeystoreType(String keystoreType)

Sets the keystore type.

Parameters:

keystoreType - the keystore type.

getPKCS11Library

public String getPKCS11Library()

Returns the PKCS11 library file location, needed when the Keystore type is PKCS11.

Returns:

the path to the PKCS11 library file

setPKCS11Library

public void setPKCS11Library(String pkcs11Library)

Sets the PKCS11 library file location, needed when the Keystore type is PKCS11

Parameters:

pkcs11Library - the path to the PKCS11 library file

getCustomSSLContext

public SSLContext getCustomSSLContext()

Gets the custom SSLContext for SSL sockets. This is null by default.

Returns:

the SSLContext previously set with setCustomSSLContext() or null.

setCustomSSLContext

public void setCustomSSLContext(SSLContext context)

Sets a custom SSLContext for creating SSL sockets. A custom Context causes all other SSL/TLS realted settings to be ignored.

Parameters:

context - the custom SSLContext for new sockets; null to reset default behavior.

isCompressionEnabled

public boolean isCompressionEnabled()

Returns true if the connection is going to use stream compression. Stream compression will be requested after TLS was established (if TLS was enabled) and only if the server offered stream compression. With stream compression network traffic can be reduced up to 90%. By default compression is disabled.

Returns:

true if the connection is going to use stream compression.

setCompressionEnabled

public void setCompressionEnabled(boolean compressionEnabled)

Sets if the connection is going to use stream compression. Stream compression will be requested after TLS was established (if TLS was enabled) and only if the server offered stream compression. With stream compression network traffic can be reduced up to 90%. By default compression is disabled.

Parameters:

compressionEnabled - if the connection is going to use stream compression.

isSASLAuthenticationEnabled

public boolean isSASLAuthenticationEnabled()

Returns true if the client is going to use SASL authentication when logging into the server. If SASL authenticatin fails then the client will try to use non-sasl authentication. By default SASL is enabled.

Returns:

true if the client is going to use SASL authentication when logging into the server.

setSASLAuthenticationEnabled

public void setSASLAuthenticationEnabled(boolean saslAuthenticationEnabled)

Sets whether the client will use SASL authentication when logging into the server. If SASL authenticatin fails then the client will try to use non-sasl authentication. By default, SASL is enabled.

Parameters:

saslAuthenticationEnabled - if the client is going to use SASL authentication when logging into the server.

isDebuggerEnabled

public boolean isDebuggerEnabled()

Returns true if the new connection about to be establish is going to be debugged. By default the value of Connection.DEBUG_ENABLED is used.

Returns:

true if the new connection about to be establish is going to be debugged.

setDebuggerEnabled

public void setDebuggerEnabled(boolean debuggerEnabled)

Sets if the new connection about to be establish is going to be debugged. By default the value of Connection.DEBUG_ENABLED is used.

Parameters:

debuggerEnabled - if the new connection about to be establish is going to be debugged.

setReconnectionAllowed

public void setReconnectionAllowed(boolean isAllowed)

Sets if the reconnection mechanism is allowed to be used. By default reconnection is allowed.

Parameters:

isAllowed - if the reconnection mechanism is allowed to use.

isReconnectionAllowed

public boolean isReconnectionAllowed()

Returns if the reconnection mechanism is allowed to be used. By default reconnection is allowed.

Returns:

if the reconnection mechanism is allowed to be used.

setSocketFactory

public void setSocketFactory(SocketFactory socketFactory)

Sets the socket factory used to create new xmppConnection sockets. This is useful when connecting through SOCKS5 proxies.

Parameters:

socketFactory - used to create new sockets.

setSendPresence

public void setSendPresence(boolean sendPresence)

Sets if an initial available presence will be sent to the server. By default an available presence will be sent to the server indicating that this presence is not online and available to receive messages. If you want to log in without being 'noticed' then pass a false value.

Parameters:

sendPresence - true if an initial available presence will be sent while logging in.

isRosterLoadedAtLogin

public boolean isRosterLoadedAtLogin()

Returns true if the roster will be loaded from the server when logging in. This is the common behaviour for clients but sometimes clients may want to differ this or just never do it if not interested in rosters.

Returns:

true if the roster will be loaded from the server when logging in.

setRosterLoadedAtLogin

public void setRosterLoadedAtLogin(boolean rosterLoadedAtLogin)

Sets if the roster will be loaded from the server when logging in. This is the common behaviour for clients but sometimes clients may want to differ this or just never do it if not interested in rosters.

Parameters:

rosterLoadedAtLogin - if the roster will be loaded from the server when logging in.

getCallbackHandler

public CallbackHandler getCallbackHandler()

Returns a CallbackHandler to obtain information, such as the password or principal information during the SASL authentication. A CallbackHandler will be used ONLY if no password was specified during the login while using SASL authentication.

Returns:

a CallbackHandler to obtain information, such as the password or principal information during the SASL authentication.

setCallbackHandler

public void setCallbackHandler(CallbackHandler callbackHandler)

Sets a CallbackHandler to obtain information, such as the password or principal information during the SASL authentication. A CallbackHandler will be used ONLY if no password was specified during the login while using SASL authentication.

Parameters:

callbackHandler - to obtain information, such as the password or principal information during the SASL authentication.

getSocketFactory

public SocketFactory getSocketFactory()

Returns the socket factory used to create new xmppConnection sockets. This is useful when connecting through SOCKS5 proxies.

Returns:

socketFactory used to create new sockets.

getHostAddresses

public List<HostAddress> getHostAddresses()

setRosterStore

public void setRosterStore(RosterStore store)

Set the permanent roster store

getRosterStore

public RosterStore getRosterStore()

Get the permanent roster store