diff --git a/documentation/connections.html b/documentation/connections.html index 2539dda35..173edd6ac 100644 --- a/documentation/connections.html +++ b/documentation/connections.html @@ -55,14 +55,39 @@ Connect and Disconnect

+
+
+// Create the configuration for this new connection
+ConnectionConfiguration config = new ConnectionConfiguration("jabber.org", 5222);
+config.setCompressionEnabled(true);
+config.setSASLAuthenticationEnabled(true);
 
+XMPPConnection connection = new XMPPConnection(config);
+// Connect to the server
+connection.connect();
+// Log into the server
+connection.login("username", "password", "SomeResource");
+....
+// Disconnect from the server
+connection.disconnect();
+
- +

+By default Smack will try to reconnect the connection in case it was abruptly disconnected. Use +ConnectionConfiguration#setReconnectionAllowed(boolean) to turn on/off this feature. The reconnection +manager will try to immediately reconnect to the server and increase the delay between attempts as +successive reconnections keep failing. +
+In case you want to force a reconnection while the reconnetion manager is waiting for the next +reconnection, you can just use XMPPConnection#connect() and a new attempt will be made. +If the manual attempt also failed then the reconnection manager will still continue the +reconnection job. +