org.jivesoftware.smack

Class ReconnectionManager

java.lang.Object

org.jivesoftware.smack.AbstractConnectionListener

org.jivesoftware.smack.ReconnectionManager

All Implemented Interfaces:

ConnectionListener

public class ReconnectionManager
extends AbstractConnectionListener

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	connectionClosed() Notification that the connection was closed normally or that the reconnection process has been aborted.
void	connectionClosedOnError(Exception e) Notification that the connection was closed due to an exception.
protected void	notifyAttemptToReconnectIn(int seconds) Fires listeners when The XMPPConnection will retry a reconnection.
protected void	notifyReconnectionFailed(Exception exception) Fires listeners when a reconnection attempt has failed.
protected void	reconnect() Starts a reconnection mechanism if it was configured to do that.

Methods inherited from class org.jivesoftware.smack.AbstractConnectionListener

authenticated, connected, reconnectingIn, reconnectionFailed, reconnectionSuccessful

Methods inherited from class java.lang.Object

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

Method Detail

reconnect

protected void reconnect()

Starts a reconnection mechanism if it was configured to do that. The algorithm is been executed when the first connection error is detected.

The reconnection mechanism will try to reconnect periodically in this way:

1. First it will try 6 times every 10 seconds.
2. Then it will try 10 times every 1 minute.
3. Finally it will try indefinitely every 5 minutes.

notifyReconnectionFailed

protected void notifyReconnectionFailed(Exception exception)

Fires listeners when a reconnection attempt has failed.

Parameters:

exception - the exception that occured.

notifyAttemptToReconnectIn

protected void notifyAttemptToReconnectIn(int seconds)

Fires listeners when The XMPPConnection will retry a reconnection. Expressed in seconds.

Parameters:

seconds - the number of seconds that a reconnection will be attempted in.

connectionClosed

public void connectionClosed()

Description copied from interface: ConnectionListener

Notification that the connection was closed normally or that the reconnection process has been aborted.

Specified by:

connectionClosed in interface ConnectionListener

Overrides:

connectionClosed in class AbstractConnectionListener

connectionClosedOnError

public void connectionClosedOnError(Exception e)

Description copied from interface: ConnectionListener

Notification that the connection was closed due to an exception. When abruptly disconnected it is possible for the connection to try reconnecting to the server.

Specified by:

connectionClosedOnError in interface ConnectionListener

Overrides:

connectionClosedOnError in class AbstractConnectionListener

Parameters:

e - the exception.