Properly sync PacketWriter's queue

by using a custom ArrayBlockingQueueWithShutdown. Fixes a race condition
where nextpacket() would wait for a notification that would never
arrive, because all all put(Packet) calls are still blocking.

SMACK-560

smack-tcp/src/test/java/org/jivesoftware/smack/PacketWriterTest.java

@@ -0,0 +1,112 @@
+/**
+ *
+ * Copyright 2014 Florian Schmaus
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.jivesoftware.smack;
+
+import java.io.IOException;
+import java.io.Writer;
+import java.util.concurrent.BrokenBarrierException;
+import java.util.concurrent.CyclicBarrier;
+
+import org.jivesoftware.smack.packet.Message;
+import org.junit.Test;
+
+import static org.junit.Assert.fail;
+
+public class PacketWriterTest {
+    volatile boolean shutdown;
+    volatile boolean prematureUnblocked;
+
+    /**
+     * Make sure that packet writer does block once the queue reaches
+     * {@link PacketWriter#QUEUE_SIZE} and that
+     * {@link PacketWriter#sendPacket(org.jivesoftware.smack.packet.Packet)} does unblock after the
+     * interrupt.
+     * 
+     * @throws InterruptedException
+     * @throws BrokenBarrierException
+     */
+    @SuppressWarnings("javadoc")
+    @Test
+    public void shouldBlockAndUnblockTest() throws InterruptedException, BrokenBarrierException {
+        XMPPTCPConnection connection = new XMPPTCPConnection("foobar.com");
+        final PacketWriter pw = new PacketWriter(connection);
+        pw.setWriter(new BlockingStringWriter());
+        pw.startup();
+
+        for (int i = 0; i < PacketWriter.QUEUE_SIZE; i++) {
+            pw.sendPacket(new Message());
+        }
+        
+        final CyclicBarrier barrier = new CyclicBarrier(2);
+        shutdown = false;
+        prematureUnblocked = false;
+        Thread t = new Thread(new Runnable() {
+            @Override
+            public void run() {
+                try {
+                    barrier.await();
+                }
+                catch (InterruptedException | BrokenBarrierException e1) {
+                }
+                pw.sendPacket(new Message());
+                // should only return after the pw was shutdown
+                if (!shutdown) {
+                    prematureUnblocked = true;
+                }
+                try {
+                    barrier.await();
+                }
+                catch (InterruptedException | BrokenBarrierException e) {
+                }
+            }
+        });
+        t.start();
+        // This barrier is not strictly necessary, but may increases the chances that the threat
+        // will block before we call shutdown. Otherwise we may get false positives (which is still
+        // better then false negatives).
+        barrier.await();
+        // Not really cool, but may increases the chances for 't' to block in sendPacket.
+        Thread.sleep(250);
+
+        // Shutdown the packetwriter
+        pw.shutdown();
+        shutdown = true;
+        barrier.await();
+        if (prematureUnblocked) {
+            fail("Should not unblock before the thread got shutdown");
+        }
+    }
+    
+    public class BlockingStringWriter extends Writer {
+        @Override
+        public void write(char[] cbuf, int off, int len) throws IOException {
+            try {
+                Thread.sleep(Integer.MAX_VALUE);
+            }
+            catch (InterruptedException e) {
+            }
+        }
+
+        @Override
+        public void flush() throws IOException {
+        }
+
+        @Override
+        public void close() throws IOException {
+        }
+    }
+}