Improve handling of InterruptedException

InterruptedExceptions should be treated as the users intention to
'cancel' the current thread's task. There is no such thing as a
spurious interrupt (not to be confused with "spurious wakeups").

smack-core/src/main/java/org/jivesoftware/smack/ReconnectionManager.java

@@ -156,13 +156,15 @@ public class ReconnectionManager {
                             }
                         }
                         catch (InterruptedException e) {
-                            // We don't need to handle spurious interrupts, in the worst case, this will cause to
+                            LOGGER.log(Level.FINE, "waiting for reconnection interrupted", e);
-                            // reconnect a few seconds earlier, depending on how many (spurious) interrupts arrive while
+                            break;
-                            // sleep() is called.
-                            LOGGER.log(Level.FINE, "Supurious interrupt", e);
                         }
                     }
 
+                    for (ConnectionListener listener : connection.connectionListeners) {
+                        listener.reconnectingIn(0);
+                    }
+
                     // Makes a reconnection attempt
                     try {
                         if (isReconnectionPossible(connection)) {

smack-core/src/main/java/org/jivesoftware/smack/Roster.java

@@ -248,7 +248,8 @@ public class Roster {
                 }
             }
             catch (InterruptedException e) {
-                LOGGER.log(Level.FINE, "spurious interrupt", e);
+                LOGGER.log(Level.FINE, "interrupted", e);
+                break;
             }
             long now = System.currentTimeMillis();
             waitTime -= now - start;

smack-core/src/test/java/org/jivesoftware/smack/DummyConnection.java

@@ -201,7 +201,6 @@ public class DummyConnection extends AbstractXMPPConnection {
             return (P) queue.poll(wait, TimeUnit.SECONDS);
         }
         catch (InterruptedException e) {
-            // TODO handle spurious interrupts
             throw new IllegalStateException(e);
         }
     }

smack-core/src/test/java/org/jivesoftware/smack/test/util/WaitForPacketListener.java

@@ -49,7 +49,6 @@ public class WaitForPacketListener implements PacketListener {
             }
         }
         catch (InterruptedException e) {
-            // TODO better handling of spurious interrupts
             throw new IllegalStateException(e);
         }
     }

smack-tcp/src/main/java/org/jivesoftware/smack/tcp/XMPPTCPConnection.java

@@ -1216,9 +1216,11 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
                 }
                 catch (InterruptedException e) {
                     throwNotConnectedExceptionIfDoneAndResumptionNotPossible();
-                    // If the method above did not throw, we have a spurious interrupt and we should try to enqueue the
+                    // If the method above did not throw, then the sending thread was interrupted
-                    // element again
+                    // TODO in a later version of Smack the InterruptedException should be thrown to
-                    LOGGER.log(Level.FINE, "Spurious interrupt", e);
+                    // allow users to interrupt a sending thread that is currently blocking because
+                    // the queue is full.
+                    LOGGER.log(Level.WARNING, "Sending thread was interrupted", e);
                 }
             }
         }
@@ -1253,7 +1255,8 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
             }
             catch (InterruptedException e) {
                 if (!queue.isShutdown()) {
-                    LOGGER.log(Level.FINER, "Spurious interrupt", e);
+                    // Users shouldn't try to interrupt the packet writer thread
+                    LOGGER.log(Level.WARNING, "Packet writer thread was interrupted. Don't do that. Use disconnect() instead.", e);
                 }
             }
             return packet;