org.jivesoftware.smack

Class ReconnectionManager

java.lang.Object

org.jivesoftware.smack.ReconnectionManager

public class ReconnectionManager
extends java.lang.Object

Handles the automatic reconnection process. Every time a connection is dropped without the application explicitly closing it, the manager automatically tries to reconnect to the server.

The reconnection mechanism will try to reconnect periodically:

1. For the first minute it will attempt to connect once every ten seconds.
2. For the next five minutes it will attempt to connect once a minute.
3. If that fails it will indefinitely try to connect once every five minutes.

Method Summary

Methods

Modifier and Type	Method and Description
void	disableAutomaticReconnection() Disable the automatic reconnection mechanism.
void	enableAutomaticReconnection() Enable the automatic reconnection mechanism.
static boolean	getEnabledPerDefault() Get the current default reconnection mechanism setting for new XMPP connections.
static ReconnectionManager	getInstanceFor(AbstractXMPPConnection connection) Get a instance of ReconnectionManager for the given connection.
boolean	isAutomaticReconnectEnabled() Returns if the automatic reconnection mechanism is enabled.
static void	setEnabledPerDefault(boolean enabled) Set if the automatic reconnection mechanism will be enabled per default for new XMPP connections.

Methods inherited from class java.lang.Object

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

Method Detail

getInstanceFor

public static ReconnectionManager getInstanceFor(AbstractXMPPConnection connection)

Get a instance of ReconnectionManager for the given connection.

Parameters:

connection -

Returns:

a ReconnectionManager for the connection.

setEnabledPerDefault

public static void setEnabledPerDefault(boolean enabled)

Set if the automatic reconnection mechanism will be enabled per default for new XMPP connections. The default is 'false'.

Parameters:

enabled -

getEnabledPerDefault

public static boolean getEnabledPerDefault()

Get the current default reconnection mechanism setting for new XMPP connections.

Returns:

true if new connection will come with an enabled reconnection mechanism

enableAutomaticReconnection

public void enableAutomaticReconnection()

Enable the automatic reconnection mechanism. Does nothing if already enabled.

disableAutomaticReconnection

public void disableAutomaticReconnection()

Disable the automatic reconnection mechanism. Does nothing if already disabled.

isAutomaticReconnectEnabled

public boolean isAutomaticReconnectEnabled()

Returns if the automatic reconnection mechanism is enabled. You can disable the reconnection mechanism with disableAutomaticReconnection() and enable the mechanism with enableAutomaticReconnection().

Returns:

true, if the reconnection mechanism is enabled.