org.jivesoftware.smack

Class SmackConfiguration

java.lang.Object

org.jivesoftware.smack.SmackConfiguration

public final class SmackConfiguration
extends Object

Represents the configuration of Smack. The configuration is used for:

• Initializing classes by loading them at start-up.
• Getting the current Smack version.
• Getting and setting global library behavior, such as the period of time to wait for replies to packets from the server. Note: setting these values via the API will override settings in the configuration file.

Configuration settings are stored in org.jivesoftware.smack/smack-config.xml.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG_ENABLED Value that indicates whether debugging is enabled.

Constructor Summary

Constructors

Constructor and Description
SmackConfiguration()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addCompressionHandler(XMPPInputOutputStream xmppInputOutputStream)
static void	addSaslMech(String mech) Add a SASL mechanism to the list to be used.
static void	addSaslMechs(Collection<String> mechs) Add a Collection of SASL mechanisms to the list to be used.
static List<XMPPInputOutputStream>	getCompresionHandlers()
static int	getDefaultPacketReplyTimeout() Returns the number of milliseconds to wait for a response from the server.
static ParsingExceptionCallback	getDefaultParsingExceptionCallback() Returns the default parsing exception callback
static int	getPacketCollectorSize() Gets the default max size of a packet collector before it will delete the older packets.
static List<String>	getSaslMechs() Returns the list of SASL mechanisms to be used.
static String	getVersion() Returns the Smack version information, eg "1.3.0".
static void	processConfigFile(InputStream cfgFileStream, Collection<Exception> exceptions)
static void	processConfigFile(InputStream cfgFileStream, Collection<Exception> exceptions, ClassLoader classLoader)
static void	removeSaslMech(String mech) Remove a SASL mechanism from the list to be used.
static void	removeSaslMechs(Collection<String> mechs) Remove a Collection of SASL mechanisms to the list to be used.
static void	setDefaultHostnameVerifier(HostnameVerifier verifier) Set the default HostnameVerifier that will be used by XMPP connections to verify the hostname of a TLS certificate.
static void	setDefaultPacketReplyTimeout(int timeout) Sets the number of milliseconds to wait for a response from the server.
static void	setDefaultParsingExceptionCallback(ParsingExceptionCallback callback) Set the default parsing exception callback for all newly created connections
static void	setPacketCollectorSize(int collectorSize) Sets the default max size of a packet collector before it will delete the older packets.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG_ENABLED

public static boolean DEBUG_ENABLED

Value that indicates whether debugging is enabled. When enabled, a debug window will apear for each new connection that will contain the following information:

• Client Traffic -- raw XML traffic generated by Smack and sent to the server.
• Server Traffic -- raw XML traffic sent by the server to the client.
• Interpreted Packets -- shows XML packets from the server as parsed by Smack.

Debugging can be enabled by setting this field to true, or by setting the Java system property smack.debugEnabled to true. The system property can be set on the command line such as "java SomeApp -Dsmack.debugEnabled=true".

Constructor Detail

SmackConfiguration

public SmackConfiguration()

Method Detail

getVersion

public static String getVersion()

Returns the Smack version information, eg "1.3.0".

Returns:

the Smack version information.

getDefaultPacketReplyTimeout

public static int getDefaultPacketReplyTimeout()

Returns the number of milliseconds to wait for a response from the server. The default value is 5000 ms.

Returns:

the milliseconds to wait for a response from the server

setDefaultPacketReplyTimeout

public static void setDefaultPacketReplyTimeout(int timeout)

Sets the number of milliseconds to wait for a response from the server.

Parameters:

timeout - the milliseconds to wait for a response from the server

getPacketCollectorSize

public static int getPacketCollectorSize()

Gets the default max size of a packet collector before it will delete the older packets.

Returns:

The number of packets to queue before deleting older packets.

setPacketCollectorSize

public static void setPacketCollectorSize(int collectorSize)

Sets the default max size of a packet collector before it will delete the older packets.

Parameters:

collectorSize - the number of packets to queue before deleting older packets.

addSaslMech

public static void addSaslMech(String mech)

Add a SASL mechanism to the list to be used.

Parameters:

mech - the SASL mechanism to be added

addSaslMechs

public static void addSaslMechs(Collection<String> mechs)

Add a Collection of SASL mechanisms to the list to be used.

Parameters:

mechs - the Collection of SASL mechanisms to be added

removeSaslMech

public static void removeSaslMech(String mech)

Remove a SASL mechanism from the list to be used.

Parameters:

mech - the SASL mechanism to be removed

removeSaslMechs

public static void removeSaslMechs(Collection<String> mechs)

Remove a Collection of SASL mechanisms to the list to be used.

Parameters:

mechs - the Collection of SASL mechanisms to be removed

getSaslMechs

public static List<String> getSaslMechs()

Returns the list of SASL mechanisms to be used. If a SASL mechanism is listed here it does not guarantee it will be used. The server may not support it, or it may not be implemented.

Returns:

the list of SASL mechanisms to be used.

setDefaultParsingExceptionCallback

public static void setDefaultParsingExceptionCallback(ParsingExceptionCallback callback)

Set the default parsing exception callback for all newly created connections

Parameters:

callback -

See Also:

ParsingExceptionCallback

getDefaultParsingExceptionCallback

public static ParsingExceptionCallback getDefaultParsingExceptionCallback()

Returns the default parsing exception callback

Returns:

the default parsing exception callback

See Also:

ParsingExceptionCallback

addCompressionHandler

public static void addCompressionHandler(XMPPInputOutputStream xmppInputOutputStream)

getCompresionHandlers

public static List<XMPPInputOutputStream> getCompresionHandlers()

setDefaultHostnameVerifier

public static void setDefaultHostnameVerifier(HostnameVerifier verifier)

Set the default HostnameVerifier that will be used by XMPP connections to verify the hostname of a TLS certificate. XMPP connections are able to overwrite this settings by supplying a HostnameVerifier in their ConnecitonConfiguration with ConnectionConfiguration.setHostnameVerifier(HostnameVerifier).

processConfigFile

public static void processConfigFile(InputStream cfgFileStream,
                     Collection<Exception> exceptions)
                              throws Exception

Throws:

Exception

processConfigFile

public static void processConfigFile(InputStream cfgFileStream,
                     Collection<Exception> exceptions,
                     ClassLoader classLoader)
                              throws Exception

Throws:

Exception