rocks.xmpp.core.session

Class ReconnectionManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.core.session.ReconnectionManager

Deprecated.

The only useful API here was setReconnectionStrategy(ReconnectionStrategy), use XmppSessionConfiguration.Builder.reconnectionStrategy(ReconnectionStrategy) instead.

@Deprecated
public final class ReconnectionManager
extends Manager

If the connection goes down, this class automatically reconnects, if the user was authenticated.

Reconnection is not performed, if the user got disconnected due to an <conflict/> stream error.

The default reconnection strategy is a so called truncated binary exponential back off (as proposed by the XMPP specification), which means that the first reconnection attempt is performed X seconds after the disconnect, where X is between 0 and 60.
The second attempt chooses a random number between 0 and 180.
The third attempt chooses a random number between 0 and 420.
The forth attempt chooses a random number between 0 and 900.
The fifth attempt chooses a random number between 0 and 1860.

Generally speaking it is 2^attempt * 60 seconds.

You can also set your own reconnection strategy.

Use getNextReconnectionAttempt() if you want to find out, when the next reconnection attempt will happen.

This class is unconditionally thread-safe.

See Also:

3.3. Reconnection

Method Summary

Modifier and Type	Method and Description
Instant	getNextReconnectionAttempt() Deprecated. Gets the date of the next reconnection attempt.
ReconnectionStrategy	getReconnectionStrategy() Deprecated. Gets the reconnection strategy.
void	setReconnectionStrategy(ReconnectionStrategy reconnectionStrategy) Deprecated. Use XmppSessionConfiguration.Builder.reconnectionStrategy(ReconnectionStrategy)

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled, setEnabled

Methods inherited from class java.lang.Object

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

Method Detail

getReconnectionStrategy

public final ReconnectionStrategy getReconnectionStrategy()

Deprecated.

Gets the reconnection strategy.

Returns:

The reconnection strategy.

setReconnectionStrategy

@Deprecated
public final void setReconnectionStrategy(ReconnectionStrategy reconnectionStrategy)

Deprecated. Use XmppSessionConfiguration.Builder.reconnectionStrategy(ReconnectionStrategy)

Sets the reconnection strategy.

Parameters:

reconnectionStrategy - The reconnection strategy.

getNextReconnectionAttempt

public final Instant getNextReconnectionAttempt()

Deprecated.

Gets the date of the next reconnection attempt.

Returns:

The next reconnection attempt or null if there is none.