ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/jsr166/jsr166/src/test/tck/ArrayBlockingQueueTest.java
(Generate patch)

Comparing jsr166/src/test/tck/ArrayBlockingQueueTest.java (file contents):
Revision 1.6 by dl, Sun Oct 5 23:00:39 2003 UTC vs.
Revision 1.98 by dl, Tue Jan 26 13:33:05 2021 UTC

# Line 1 | Line 1
1   /*
2 < * Written by members of JCP JSR-166 Expert Group and released to the
3 < * public domain. Use, modify, and redistribute this code in any way
4 < * without acknowledgement. Other contributors include Andrew Wright,
5 < * Jeffrey Hayes, Pat Fischer, Mike Judd.
2 > * Written by Doug Lea with assistance from members of JCP JSR-166
3 > * Expert Group and released to the public domain, as explained at
4 > * http://creativecommons.org/publicdomain/zero/1.0/
5 > * Other contributors include Andrew Wright, Jeffrey Hayes,
6 > * Pat Fisher, Mike Judd.
7   */
8  
9 + import static java.util.concurrent.TimeUnit.MILLISECONDS;
10  
11 < import junit.framework.*;
12 < import java.util.*;
13 < import java.util.concurrent.*;
14 < import java.io.*;
11 > import java.util.ArrayList;
12 > import java.util.Arrays;
13 > import java.util.Collection;
14 > import java.util.Collections;
15 > import java.util.Iterator;
16 > import java.util.NoSuchElementException;
17 > import java.util.Queue;
18 > import java.util.concurrent.ArrayBlockingQueue;
19 > import java.util.concurrent.BlockingQueue;
20 > import java.util.concurrent.CountDownLatch;
21 > import java.util.concurrent.Executors;
22 > import java.util.concurrent.ExecutorService;
23 > import java.util.concurrent.ThreadLocalRandom;
24 >
25 > import junit.framework.Test;
26  
27   public class ArrayBlockingQueueTest extends JSR166TestCase {
28 +
29      public static void main(String[] args) {
30 <        junit.textui.TestRunner.run (suite());  
30 >        main(suite(), args);
31      }
32 +
33      public static Test suite() {
34 <        return new TestSuite(ArrayBlockingQueueTest.class);
34 >        class Implementation implements CollectionImplementation {
35 >            public Class<?> klazz() { return ArrayBlockingQueue.class; }
36 >            public Collection emptyCollection() {
37 >                boolean fair = randomBoolean();
38 >                return populatedQueue(0, SIZE, 2 * SIZE, fair);
39 >            }
40 >            public Object makeElement(int i) { return JSR166TestCase.itemFor(i); }
41 >            public boolean isConcurrent() { return true; }
42 >            public boolean permitsNulls() { return false; }
43 >        }
44 >
45 >        return newTestSuite(
46 >            ArrayBlockingQueueTest.class,
47 >            new Fair().testSuite(),
48 >            new NonFair().testSuite(),
49 >            CollectionTest.testSuite(new Implementation()));
50 >    }
51 >
52 >    public static class Fair extends BlockingQueueTest {
53 >        protected BlockingQueue<Item> emptyCollection() {
54 >            return populatedQueue(0, SIZE, 2 * SIZE, true);
55 >        }
56 >    }
57 >
58 >    public static class NonFair extends BlockingQueueTest {
59 >        protected BlockingQueue<Item> emptyCollection() {
60 >            return populatedQueue(0, SIZE, 2 * SIZE, false);
61 >        }
62      }
63  
64      /**
65 <     * Create a queue of given size containing consecutive
66 <     * Integers 0 ... n.
65 >     * Returns a new queue of given size containing consecutive
66 >     * Items 0 ... n - 1.
67       */
68 <    private ArrayBlockingQueue populatedQueue(int n) {
69 <        ArrayBlockingQueue q = new ArrayBlockingQueue(n);
68 >    static ArrayBlockingQueue<Item> populatedQueue(int n) {
69 >        return populatedQueue(n, n, n, false);
70 >    }
71 >
72 >    /**
73 >     * Returns a new queue of given size containing consecutive
74 >     * Items 0 ... n - 1, with given capacity range and fairness.
75 >     */
76 >    static ArrayBlockingQueue<Item> populatedQueue(
77 >        int size, int minCapacity, int maxCapacity, boolean fair) {
78 >        ThreadLocalRandom rnd = ThreadLocalRandom.current();
79 >        int capacity = rnd.nextInt(minCapacity, maxCapacity + 1);
80 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(capacity);
81          assertTrue(q.isEmpty());
82 <        for(int i = 0; i < n; i++)
83 <            assertTrue(q.offer(new Integer(i)));
84 <        assertFalse(q.isEmpty());
85 <        assertEquals(0, q.remainingCapacity());
86 <        assertEquals(n, q.size());
82 >        // shuffle circular array elements so they wrap
83 >        {
84 >            int n = rnd.nextInt(capacity);
85 >            for (int i = 0; i < n; i++) q.add(fortytwo);
86 >            for (int i = 0; i < n; i++) q.remove();
87 >        }
88 >        for (int i = 0; i < size; i++)
89 >            mustOffer(q, i);
90 >        mustEqual(size == 0, q.isEmpty());
91 >        mustEqual(capacity - size, q.remainingCapacity());
92 >        mustEqual(size, q.size());
93 >        if (size > 0)
94 >            mustEqual(0, q.peek());
95          return q;
96      }
97 <
97 >
98      /**
99       * A new queue has the indicated capacity
100       */
101      public void testConstructor1() {
102 <        assertEquals(SIZE, new ArrayBlockingQueue(SIZE).remainingCapacity());
102 >        mustEqual(SIZE, new ArrayBlockingQueue<Item>(SIZE).remainingCapacity());
103      }
104  
105      /**
106 <     * Constructor throws IAE if  capacity argument nonpositive
106 >     * Constructor throws IllegalArgumentException if capacity argument nonpositive
107       */
108 <    public void testConstructor2() {
109 <        try {
110 <            ArrayBlockingQueue q = new ArrayBlockingQueue(0);
111 <            shouldThrow();
108 >    public void testConstructor_nonPositiveCapacity() {
109 >        for (int i : new int[] { 0, -1, Integer.MIN_VALUE }) {
110 >            try {
111 >                new ArrayBlockingQueue<Item>(i);
112 >                shouldThrow();
113 >            } catch (IllegalArgumentException success) {}
114 >            for (boolean fair : new boolean[] { true, false }) {
115 >                try {
116 >                    new ArrayBlockingQueue<Item>(i, fair);
117 >                    shouldThrow();
118 >                } catch (IllegalArgumentException success) {}
119 >            }
120          }
52        catch (IllegalArgumentException success) {}
121      }
122  
123      /**
124       * Initializing from null Collection throws NPE
125       */
126 <    public void testConstructor3() {
126 >    public void testConstructor_nullCollection() {
127          try {
128 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1, true, null);
128 >            new ArrayBlockingQueue<Item>(1, true, null);
129              shouldThrow();
130 <        }
63 <        catch (NullPointerException success) {}
130 >        } catch (NullPointerException success) {}
131      }
132  
133      /**
134       * Initializing from Collection of null elements throws NPE
135       */
136      public void testConstructor4() {
137 +        Collection<Item> elements = Arrays.asList(new Item[SIZE]);
138          try {
139 <            Integer[] ints = new Integer[SIZE];
72 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE, false, Arrays.asList(ints));
139 >            new ArrayBlockingQueue<Item>(SIZE, false, elements);
140              shouldThrow();
141 <        }
75 <        catch (NullPointerException success) {}
141 >        } catch (NullPointerException success) {}
142      }
143  
144      /**
145       * Initializing from Collection with some null elements throws NPE
146       */
147      public void testConstructor5() {
148 +        Item[] items = new Item[2]; items[0] = zero;
149 +        Collection<Item> elements = Arrays.asList(items);
150          try {
151 <            Integer[] ints = new Integer[SIZE];
84 <            for (int i = 0; i < SIZE-1; ++i)
85 <                ints[i] = new Integer(i);
86 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE, false, Arrays.asList(ints));
151 >            new ArrayBlockingQueue<Item>(SIZE, false, elements);
152              shouldThrow();
153 <        }
89 <        catch (NullPointerException success) {}
153 >        } catch (NullPointerException success) {}
154      }
155  
156      /**
157 <     * Initializing from too large collection throws IAE
157 >     * Initializing from too large collection throws IllegalArgumentException
158       */
159 <    public void testConstructor6() {
159 >    public void testConstructor_collectionTooLarge() {
160 >        // just barely fits - succeeds
161 >        new ArrayBlockingQueue<Object>(SIZE, false,
162 >                                       Collections.nCopies(SIZE, ""));
163          try {
164 <            Integer[] ints = new Integer[SIZE];
165 <            for (int i = 0; i < SIZE; ++i)
99 <                ints[i] = new Integer(i);
100 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1, false, Arrays.asList(ints));
164 >            new ArrayBlockingQueue<Object>(SIZE - 1, false,
165 >                                   Collections.nCopies(SIZE, ""));
166              shouldThrow();
167 <        }
103 <        catch (IllegalArgumentException success) {}
167 >        } catch (IllegalArgumentException success) {}
168      }
169  
170      /**
171       * Queue contains all elements of collection used to initialize
172       */
173      public void testConstructor7() {
174 <        try {
175 <            Integer[] ints = new Integer[SIZE];
176 <            for (int i = 0; i < SIZE; ++i)
177 <                ints[i] = new Integer(i);
178 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE, true, Arrays.asList(ints));
115 <            for (int i = 0; i < SIZE; ++i)
116 <                assertEquals(ints[i], q.poll());
117 <        }
118 <        finally {}
174 >        Item[] items = defaultItems;
175 >        Collection<Item> elements = Arrays.asList(items);
176 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE, true, elements);
177 >        for (int i = 0; i < SIZE; ++i)
178 >            mustEqual(items[i], q.poll());
179      }
180  
181      /**
182       * Queue transitions from empty to full when elements added
183       */
184      public void testEmptyFull() {
185 <        ArrayBlockingQueue q = new ArrayBlockingQueue(2);
185 >        BlockingQueue<Item> q = populatedQueue(0, 2, 2, false);
186          assertTrue(q.isEmpty());
187 <        assertEquals(2, q.remainingCapacity());
187 >        mustEqual(2, q.remainingCapacity());
188          q.add(one);
189          assertFalse(q.isEmpty());
190 <        q.add(two);
190 >        assertTrue(q.offer(two));
191          assertFalse(q.isEmpty());
192 <        assertEquals(0, q.remainingCapacity());
192 >        mustEqual(0, q.remainingCapacity());
193          assertFalse(q.offer(three));
194      }
195  
# Line 137 | Line 197 | public class ArrayBlockingQueueTest exte
197       * remainingCapacity decreases on add, increases on remove
198       */
199      public void testRemainingCapacity() {
200 <        ArrayBlockingQueue q = populatedQueue(SIZE);
201 <        for (int i = 0; i < SIZE; ++i) {
202 <            assertEquals(i, q.remainingCapacity());
203 <            assertEquals(SIZE-i, q.size());
204 <            q.remove();
200 >        int size = ThreadLocalRandom.current().nextInt(1, SIZE);
201 >        BlockingQueue<Item> q = populatedQueue(size, size, 2 * size, false);
202 >        int spare = q.remainingCapacity();
203 >        int capacity = spare + size;
204 >        for (int i = 0; i < size; i++) {
205 >            mustEqual(spare + i, q.remainingCapacity());
206 >            mustEqual(capacity, q.size() + q.remainingCapacity());
207 >            mustEqual(i, q.remove());
208 >        }
209 >        for (int i = 0; i < size; i++) {
210 >            mustEqual(capacity - i, q.remainingCapacity());
211 >            mustEqual(capacity, q.size() + q.remainingCapacity());
212 >            mustAdd(q, i);
213          }
146        for (int i = 0; i < SIZE; ++i) {
147            assertEquals(SIZE-i, q.remainingCapacity());
148            assertEquals(i, q.size());
149            q.add(new Integer(i));
150        }
151    }
152
153    /**
154     *  offer(null) throws NPE
155     */
156    public void testOfferNull() {
157        try {
158            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
159            q.offer(null);
160            shouldThrow();
161        } catch (NullPointerException success) { }  
162    }
163
164    /**
165     *  add(null) throws NPE
166     */
167    public void testAddNull() {
168        try {
169            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
170            q.add(null);
171            shouldThrow();
172        } catch (NullPointerException success) { }  
214      }
215  
216      /**
217       * Offer succeeds if not full; fails if full
218       */
219      public void testOffer() {
220 <        ArrayBlockingQueue q = new ArrayBlockingQueue(1);
220 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(1);
221          assertTrue(q.offer(zero));
222          assertFalse(q.offer(one));
223      }
224  
225      /**
226 <     * add succeeds if not full; throws ISE if full
226 >     * add succeeds if not full; throws IllegalStateException if full
227       */
228      public void testAdd() {
229 <        try {
230 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
231 <            for (int i = 0; i < SIZE; ++i) {
191 <                assertTrue(q.add(new Integer(i)));
192 <            }
193 <            assertEquals(0, q.remainingCapacity());
194 <            q.add(new Integer(SIZE));
195 <        } catch (IllegalStateException success){
196 <        }  
197 <    }
198 <
199 <    /**
200 <     *  addAll(null) throws NPE
201 <     */
202 <    public void testAddAll1() {
229 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE);
230 >        for (int i = 0; i < SIZE; i++) assertTrue(q.add(itemFor(i)));
231 >        mustEqual(0, q.remainingCapacity());
232          try {
233 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
205 <            q.addAll(null);
233 >            q.add(itemFor(SIZE));
234              shouldThrow();
235 <        }
208 <        catch (NullPointerException success) {}
235 >        } catch (IllegalStateException success) {}
236      }
237  
238      /**
239 <     * addAll(this) throws IAE
239 >     * addAll(this) throws IllegalArgumentException
240       */
241      public void testAddAllSelf() {
242 +        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
243          try {
216            ArrayBlockingQueue q = populatedQueue(SIZE);
244              q.addAll(q);
245              shouldThrow();
246 <        }
220 <        catch (IllegalArgumentException success) {}
246 >        } catch (IllegalArgumentException success) {}
247      }
248  
223
224    /**
225     *  addAll of a collection with null elements throws NPE
226     */
227    public void testAddAll2() {
228        try {
229            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
230            Integer[] ints = new Integer[SIZE];
231            q.addAll(Arrays.asList(ints));
232            shouldThrow();
233        }
234        catch (NullPointerException success) {}
235    }
249      /**
250       * addAll of a collection with any null elements throws NPE after
251       * possibly adding some elements
252       */
253      public void testAddAll3() {
254 +        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE);
255 +        Item[] items = new Item[2]; items[0] = zero;
256          try {
257 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
243 <            Integer[] ints = new Integer[SIZE];
244 <            for (int i = 0; i < SIZE-1; ++i)
245 <                ints[i] = new Integer(i);
246 <            q.addAll(Arrays.asList(ints));
257 >            q.addAll(Arrays.asList(items));
258              shouldThrow();
259 <        }
249 <        catch (NullPointerException success) {}
259 >        } catch (NullPointerException success) {}
260      }
261 +
262      /**
263 <     * addAll throws ISE if not enough room
263 >     * addAll throws IllegalStateException if not enough room
264       */
265 <    public void testAddAll4() {
265 >    public void testAddAll_insufficientSpace() {
266 >        int size = ThreadLocalRandom.current().nextInt(1, SIZE);
267 >        ArrayBlockingQueue<Item> q = populatedQueue(0, size, size, false);
268 >        // Just fits:
269 >        q.addAll(populatedQueue(size, size, 2 * size, false));
270 >        mustEqual(0, q.remainingCapacity());
271 >        mustEqual(size, q.size());
272 >        mustEqual(0, q.peek());
273          try {
274 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
275 <            Integer[] ints = new Integer[SIZE];
258 <            for (int i = 0; i < SIZE; ++i)
259 <                ints[i] = new Integer(i);
260 <            q.addAll(Arrays.asList(ints));
274 >            q = populatedQueue(0, size, size, false);
275 >            q.addAll(Collections.nCopies(size + 1, fortytwo));
276              shouldThrow();
277 <        }
263 <        catch (IllegalStateException success) {}
277 >        } catch (IllegalStateException success) {}
278      }
279 +
280      /**
281       * Queue contains all elements, in traversal order, of successful addAll
282       */
283      public void testAddAll5() {
284 <        try {
285 <            Integer[] empty = new Integer[0];
286 <            Integer[] ints = new Integer[SIZE];
287 <            for (int i = 0; i < SIZE; ++i)
288 <                ints[i] = new Integer(i);
289 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
290 <            assertFalse(q.addAll(Arrays.asList(empty)));
276 <            assertTrue(q.addAll(Arrays.asList(ints)));
277 <            for (int i = 0; i < SIZE; ++i)
278 <                assertEquals(ints[i], q.poll());
279 <        }
280 <        finally {}
284 >        Item[] empty = new Item[0];
285 >        Item[] items = defaultItems;
286 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE);
287 >        assertFalse(q.addAll(Arrays.asList(empty)));
288 >        assertTrue(q.addAll(Arrays.asList(items)));
289 >        for (int i = 0; i < SIZE; ++i)
290 >            mustEqual(items[i], q.poll());
291      }
292  
293      /**
284     *  put(null) throws NPE
285     */
286     public void testPutNull() {
287        try {
288            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
289            q.put(null);
290            shouldThrow();
291        }
292        catch (NullPointerException success){
293        }  
294        catch (InterruptedException ie) {
295            unexpectedException();
296        }
297     }
298
299    /**
294       * all elements successfully put are contained
295       */
296 <     public void testPut() {
297 <         try {
298 <             ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
299 <             for (int i = 0; i < SIZE; ++i) {
300 <                 Integer I = new Integer(i);
301 <                 q.put(I);
308 <                 assertTrue(q.contains(I));
309 <             }
310 <             assertEquals(0, q.remainingCapacity());
311 <         }
312 <        catch (InterruptedException ie) {
313 <            unexpectedException();
296 >    public void testPut() throws InterruptedException {
297 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE);
298 >        for (int i = 0; i < SIZE; ++i) {
299 >            Item x = itemFor(i);
300 >            q.put(x);
301 >            mustContain(q, x);
302          }
303 +        mustEqual(0, q.remainingCapacity());
304      }
305  
306      /**
307       * put blocks interruptibly if full
308       */
309 <    public void testBlockingPut() {
310 <        Thread t = new Thread(new Runnable() {
311 <                public void run() {
312 <                    int added = 0;
313 <                    try {
314 <                        ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
315 <                        for (int i = 0; i < SIZE; ++i) {
316 <                            q.put(new Integer(i));
317 <                            ++added;
318 <                        }
319 <                        q.put(new Integer(SIZE));
320 <                        threadShouldThrow();
321 <                    } catch (InterruptedException ie){
322 <                        threadAssertEquals(added, SIZE);
323 <                    }  
324 <                }});
325 <        try {
326 <            t.start();
327 <           Thread.sleep(SHORT_DELAY_MS);
328 <           t.interrupt();
329 <           t.join();
330 <        }
331 <        catch (InterruptedException ie) {
332 <            unexpectedException();
333 <        }
309 >    public void testBlockingPut() throws InterruptedException {
310 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE);
311 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
312 >        Thread t = newStartedThread(new CheckedRunnable() {
313 >            public void realRun() throws InterruptedException {
314 >                for (int i = 0; i < SIZE; ++i)
315 >                    q.put(itemFor(i));
316 >                mustEqual(SIZE, q.size());
317 >                mustEqual(0, q.remainingCapacity());
318 >
319 >                Thread.currentThread().interrupt();
320 >                try {
321 >                    q.put(ninetynine);
322 >                    shouldThrow();
323 >                } catch (InterruptedException success) {}
324 >                assertFalse(Thread.interrupted());
325 >
326 >                pleaseInterrupt.countDown();
327 >                try {
328 >                    q.put(ninetynine);
329 >                    shouldThrow();
330 >                } catch (InterruptedException success) {}
331 >                assertFalse(Thread.interrupted());
332 >            }});
333 >
334 >        await(pleaseInterrupt);
335 >        if (randomBoolean()) assertThreadBlocks(t, Thread.State.WAITING);
336 >        t.interrupt();
337 >        awaitTermination(t);
338 >        mustEqual(SIZE, q.size());
339 >        mustEqual(0, q.remainingCapacity());
340      }
341  
342      /**
343 <     * put blocks waiting for take when full
344 <     */
345 <    public void testPutWithTake() {
346 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
347 <        Thread t = new Thread(new Runnable() {
348 <                public void run() {
349 <                    int added = 0;
350 <                    try {
351 <                        q.put(new Object());
352 <                        ++added;
353 <                        q.put(new Object());
354 <                        ++added;
355 <                        q.put(new Object());
356 <                        ++added;
357 <                        q.put(new Object());
358 <                        ++added;
359 <                        threadShouldThrow();
360 <                    } catch (InterruptedException e){
361 <                        threadAssertTrue(added >= 2);
362 <                    }
363 <                }
364 <            });
365 <        try {
366 <            t.start();
367 <            Thread.sleep(SHORT_DELAY_MS);
368 <            q.take();
369 <            t.interrupt();
370 <            t.join();
371 <        } catch (Exception e){
372 <            unexpectedException();
373 <        }
343 >     * put blocks interruptibly waiting for take when full
344 >     */
345 >    public void testPutWithTake() throws InterruptedException {
346 >        final int capacity = 2;
347 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(capacity);
348 >        final CountDownLatch pleaseTake = new CountDownLatch(1);
349 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
350 >        Thread t = newStartedThread(new CheckedRunnable() {
351 >            public void realRun() throws InterruptedException {
352 >                for (int i = 0; i < capacity; i++)
353 >                    q.put(itemFor(i));
354 >                pleaseTake.countDown();
355 >                q.put(eightysix);
356 >
357 >                Thread.currentThread().interrupt();
358 >                try {
359 >                    q.put(ninetynine);
360 >                    shouldThrow();
361 >                } catch (InterruptedException success) {}
362 >                assertFalse(Thread.interrupted());
363 >
364 >                pleaseInterrupt.countDown();
365 >                try {
366 >                    q.put(ninetynine);
367 >                    shouldThrow();
368 >                } catch (InterruptedException success) {}
369 >                assertFalse(Thread.interrupted());
370 >            }});
371 >
372 >        await(pleaseTake);
373 >        mustEqual(0, q.remainingCapacity());
374 >        mustEqual(0, q.take());
375 >
376 >        await(pleaseInterrupt);
377 >        if (randomBoolean()) assertThreadBlocks(t, Thread.State.WAITING);
378 >        t.interrupt();
379 >        awaitTermination(t);
380 >        mustEqual(0, q.remainingCapacity());
381      }
382  
383      /**
384       * timed offer times out if full and elements not taken
385       */
386      public void testTimedOffer() {
387 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
388 <        Thread t = new Thread(new Runnable() {
389 <                public void run() {
390 <                    try {
391 <                        q.put(new Object());
392 <                        q.put(new Object());
393 <                        threadAssertFalse(q.offer(new Object(), SHORT_DELAY_MS/2, TimeUnit.MILLISECONDS));
394 <                        q.offer(new Object(), LONG_DELAY_MS, TimeUnit.MILLISECONDS);
395 <                        threadShouldThrow();
396 <                    } catch (InterruptedException success){}
397 <                }
398 <            });
399 <        
400 <        try {
401 <            t.start();
402 <            Thread.sleep(SHORT_DELAY_MS);
403 <            t.interrupt();
404 <            t.join();
405 <        } catch (Exception e){
406 <            unexpectedException();
407 <        }
387 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(2);
388 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
389 >        Thread t = newStartedThread(new CheckedRunnable() {
390 >            public void realRun() throws InterruptedException {
391 >                q.put(one);
392 >                q.put(two);
393 >                long startTime = System.nanoTime();
394 >                assertFalse(q.offer(zero, timeoutMillis(), MILLISECONDS));
395 >                assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
396 >
397 >                Thread.currentThread().interrupt();
398 >                try {
399 >                    q.offer(three, randomTimeout(), randomTimeUnit());
400 >                    shouldThrow();
401 >                } catch (InterruptedException success) {}
402 >                assertFalse(Thread.interrupted());
403 >
404 >                pleaseInterrupt.countDown();
405 >                try {
406 >                    q.offer(four, LONGER_DELAY_MS, MILLISECONDS);
407 >                    shouldThrow();
408 >                } catch (InterruptedException success) {}
409 >                assertFalse(Thread.interrupted());
410 >            }});
411 >
412 >        await(pleaseInterrupt);
413 >        if (randomBoolean()) assertThreadBlocks(t, Thread.State.TIMED_WAITING);
414 >        t.interrupt();
415 >        awaitTermination(t);
416      }
417  
418      /**
419       * take retrieves elements in FIFO order
420       */
421 <    public void testTake() {
422 <        try {
423 <            ArrayBlockingQueue q = populatedQueue(SIZE);
424 <            for (int i = 0; i < SIZE; ++i) {
415 <                assertEquals(i, ((Integer)q.take()).intValue());
416 <            }
417 <        } catch (InterruptedException e){
418 <            unexpectedException();
419 <        }  
420 <    }
421 <
422 <    /**
423 <     * take blocks interruptibly when empty
424 <     */
425 <    public void testTakeFromEmpty() {
426 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
427 <        Thread t = new Thread(new Runnable() {
428 <                public void run() {
429 <                    try {
430 <                        q.take();
431 <                        threadShouldThrow();
432 <                    } catch (InterruptedException success){ }                
433 <                }
434 <            });
435 <        try {
436 <            t.start();
437 <            Thread.sleep(SHORT_DELAY_MS);
438 <            t.interrupt();
439 <            t.join();
440 <        } catch (Exception e){
441 <            unexpectedException();
421 >    public void testTake() throws InterruptedException {
422 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
423 >        for (int i = 0; i < SIZE; ++i) {
424 >            mustEqual(i, q.take());
425          }
426      }
427  
428      /**
429       * Take removes existing elements until empty, then blocks interruptibly
430       */
431 <    public void testBlockingTake() {
432 <        Thread t = new Thread(new Runnable() {
433 <                public void run() {
434 <                    try {
435 <                        ArrayBlockingQueue q = populatedQueue(SIZE);
436 <                        for (int i = 0; i < SIZE; ++i) {
437 <                            threadAssertEquals(i, ((Integer)q.take()).intValue());
438 <                        }
439 <                        q.take();
440 <                        threadShouldThrow();
441 <                    } catch (InterruptedException success){
442 <                    }  
443 <                }});
461 <        try {
462 <            t.start();
463 <            Thread.sleep(SHORT_DELAY_MS);
464 <            t.interrupt();
465 <            t.join();
466 <        }
467 <        catch (InterruptedException ie) {
468 <            unexpectedException();
469 <        }
470 <    }
431 >    public void testBlockingTake() throws InterruptedException {
432 >        final ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
433 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
434 >        Thread t = newStartedThread(new CheckedRunnable() {
435 >            public void realRun() throws InterruptedException {
436 >                for (int i = 0; i < SIZE; i++) mustEqual(i, q.take());
437 >
438 >                Thread.currentThread().interrupt();
439 >                try {
440 >                    q.take();
441 >                    shouldThrow();
442 >                } catch (InterruptedException success) {}
443 >                assertFalse(Thread.interrupted());
444  
445 +                pleaseInterrupt.countDown();
446 +                try {
447 +                    q.take();
448 +                    shouldThrow();
449 +                } catch (InterruptedException success) {}
450 +                assertFalse(Thread.interrupted());
451 +            }});
452 +
453 +        await(pleaseInterrupt);
454 +        if (randomBoolean()) assertThreadBlocks(t, Thread.State.WAITING);
455 +        t.interrupt();
456 +        awaitTermination(t);
457 +    }
458  
459      /**
460       * poll succeeds unless empty
461       */
462      public void testPoll() {
463 <        ArrayBlockingQueue q = populatedQueue(SIZE);
463 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
464          for (int i = 0; i < SIZE; ++i) {
465 <            assertEquals(i, ((Integer)q.poll()).intValue());
465 >            mustEqual(i, q.poll());
466          }
467 <        assertNull(q.poll());
467 >        assertNull(q.poll());
468      }
469  
470      /**
471 <     * timed pool with zero timeout succeeds when non-empty, else times out
471 >     * timed poll with zero timeout succeeds when non-empty, else times out
472       */
473 <    public void testTimedPoll0() {
474 <        try {
475 <            ArrayBlockingQueue q = populatedQueue(SIZE);
476 <            for (int i = 0; i < SIZE; ++i) {
477 <                assertEquals(i, ((Integer)q.poll(0, TimeUnit.MILLISECONDS)).intValue());
478 <            }
479 <            assertNull(q.poll(0, TimeUnit.MILLISECONDS));
494 <        } catch (InterruptedException e){
495 <            unexpectedException();
496 <        }  
473 >    public void testTimedPoll0() throws InterruptedException {
474 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
475 >        for (int i = 0; i < SIZE; ++i) {
476 >            mustEqual(i, q.poll(0, MILLISECONDS));
477 >        }
478 >        assertNull(q.poll(0, MILLISECONDS));
479 >        checkEmpty(q);
480      }
481  
482      /**
483 <     * timed pool with nonzero timeout succeeds when non-empty, else times out
483 >     * timed poll with nonzero timeout succeeds when non-empty, else times out
484       */
485 <    public void testTimedPoll() {
486 <        try {
487 <            ArrayBlockingQueue q = populatedQueue(SIZE);
488 <            for (int i = 0; i < SIZE; ++i) {
489 <                assertEquals(i, ((Integer)q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS)).intValue());
490 <            }
491 <            assertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
492 <        } catch (InterruptedException e){
493 <            unexpectedException();
494 <        }  
485 >    public void testTimedPoll() throws InterruptedException {
486 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
487 >        for (int i = 0; i < SIZE; ++i) {
488 >            long startTime = System.nanoTime();
489 >            mustEqual(i, q.poll(LONG_DELAY_MS, MILLISECONDS));
490 >            assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
491 >        }
492 >        long startTime = System.nanoTime();
493 >        assertNull(q.poll(timeoutMillis(), MILLISECONDS));
494 >        assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
495 >        checkEmpty(q);
496      }
497  
498      /**
499       * Interrupted timed poll throws InterruptedException instead of
500       * returning timeout status
501       */
502 <    public void testInterruptedTimedPoll() {
503 <        Thread t = new Thread(new Runnable() {
504 <                public void run() {
505 <                    try {
506 <                        ArrayBlockingQueue q = populatedQueue(SIZE);
507 <                        for (int i = 0; i < SIZE; ++i) {
508 <                            threadAssertEquals(i, ((Integer)q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS)).intValue());
525 <                        }
526 <                        threadAssertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
527 <                    } catch (InterruptedException success){
528 <                    }  
529 <                }});
530 <        try {
531 <            t.start();
532 <            Thread.sleep(SHORT_DELAY_MS);
533 <            t.interrupt();
534 <            t.join();
535 <        }
536 <        catch (InterruptedException ie) {
537 <            unexpectedException();
538 <        }
539 <    }
502 >    public void testInterruptedTimedPoll() throws InterruptedException {
503 >        final BlockingQueue<Item> q = populatedQueue(SIZE);
504 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
505 >        Thread t = newStartedThread(new CheckedRunnable() {
506 >            public void realRun() throws InterruptedException {
507 >                for (int i = 0; i < SIZE; i++)
508 >                    mustEqual(i, q.poll(LONG_DELAY_MS, MILLISECONDS));
509  
510 <    /**
511 <     *  timed poll before a delayed offer fails; after offer succeeds;
512 <     *  on interruption throws
513 <     */
514 <    public void testTimedPollWithOffer() {
515 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
547 <        Thread t = new Thread(new Runnable() {
548 <                public void run() {
549 <                    try {
550 <                        threadAssertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
551 <                        q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS);
552 <                        q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS);
553 <                        threadShouldThrow();
554 <                    } catch (InterruptedException success) { }                
555 <                }
556 <            });
557 <        try {
558 <            t.start();
559 <            Thread.sleep(SMALL_DELAY_MS);
560 <            assertTrue(q.offer(zero, SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
561 <            t.interrupt();
562 <            t.join();
563 <        } catch (Exception e){
564 <            unexpectedException();
565 <        }
566 <    }  
510 >                Thread.currentThread().interrupt();
511 >                try {
512 >                    q.poll(randomTimeout(), randomTimeUnit());
513 >                    shouldThrow();
514 >                } catch (InterruptedException success) {}
515 >                assertFalse(Thread.interrupted());
516  
517 +                pleaseInterrupt.countDown();
518 +                try {
519 +                    q.poll(LONGER_DELAY_MS, MILLISECONDS);
520 +                    shouldThrow();
521 +                } catch (InterruptedException success) {}
522 +                assertFalse(Thread.interrupted());
523 +            }});
524 +
525 +        await(pleaseInterrupt);
526 +        if (randomBoolean()) assertThreadBlocks(t, Thread.State.TIMED_WAITING);
527 +        t.interrupt();
528 +        awaitTermination(t);
529 +        checkEmpty(q);
530 +    }
531  
532      /**
533       * peek returns next element, or null if empty
534       */
535      public void testPeek() {
536 <        ArrayBlockingQueue q = populatedQueue(SIZE);
536 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
537          for (int i = 0; i < SIZE; ++i) {
538 <            assertEquals(i, ((Integer)q.peek()).intValue());
539 <            q.poll();
538 >            mustEqual(i, q.peek());
539 >            mustEqual(i, q.poll());
540              assertTrue(q.peek() == null ||
541 <                       i != ((Integer)q.peek()).intValue());
541 >                       !q.peek().equals(i));
542          }
543 <        assertNull(q.peek());
543 >        assertNull(q.peek());
544      }
545  
546      /**
547       * element returns next element, or throws NSEE if empty
548       */
549      public void testElement() {
550 <        ArrayBlockingQueue q = populatedQueue(SIZE);
550 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
551          for (int i = 0; i < SIZE; ++i) {
552 <            assertEquals(i, ((Integer)q.element()).intValue());
553 <            q.poll();
552 >            mustEqual(i, q.element());
553 >            mustEqual(i, q.poll());
554          }
555          try {
556              q.element();
557              shouldThrow();
558 <        }
596 <        catch (NoSuchElementException success) {}
558 >        } catch (NoSuchElementException success) {}
559      }
560  
561      /**
562       * remove removes next element, or throws NSEE if empty
563       */
564      public void testRemove() {
565 <        ArrayBlockingQueue q = populatedQueue(SIZE);
565 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
566          for (int i = 0; i < SIZE; ++i) {
567 <            assertEquals(i, ((Integer)q.remove()).intValue());
567 >            mustEqual(i, q.remove());
568          }
569          try {
570              q.remove();
571              shouldThrow();
572 <        } catch (NoSuchElementException success){
611 <        }  
572 >        } catch (NoSuchElementException success) {}
573      }
574  
575      /**
615     * remove(x) removes x and returns true if present
616     */
617    public void testRemoveElement() {
618        ArrayBlockingQueue q = populatedQueue(SIZE);
619        for (int i = 1; i < SIZE; i+=2) {
620            assertTrue(q.remove(new Integer(i)));
621        }
622        for (int i = 0; i < SIZE; i+=2) {
623            assertTrue(q.remove(new Integer(i)));
624            assertFalse(q.remove(new Integer(i+1)));
625        }
626        assertTrue(q.isEmpty());
627    }
628        
629    /**
576       * contains(x) reports true when elements added but not yet removed
577       */
578      public void testContains() {
579 <        ArrayBlockingQueue q = populatedQueue(SIZE);
580 <        for (int i = 0; i < SIZE; ++i) {
581 <            assertTrue(q.contains(new Integer(i)));
582 <            q.poll();
583 <            assertFalse(q.contains(new Integer(i)));
579 >        int size = ThreadLocalRandom.current().nextInt(1, SIZE);
580 >        ArrayBlockingQueue<Item> q = populatedQueue(size, size, 2 * size, false);
581 >        assertFalse(q.contains(null));
582 >        for (int i = 0; i < size; ++i) {
583 >            mustContain(q, i);
584 >            mustEqual(i, q.poll());
585 >            mustNotContain(q, i);
586          }
587      }
588  
# Line 642 | Line 590 | public class ArrayBlockingQueueTest exte
590       * clear removes all elements
591       */
592      public void testClear() {
593 <        ArrayBlockingQueue q = populatedQueue(SIZE);
593 >        int size = ThreadLocalRandom.current().nextInt(1, 5);
594 >        ArrayBlockingQueue<Item> q = populatedQueue(size, size, 2 * size, false);
595 >        int capacity = size + q.remainingCapacity();
596          q.clear();
597          assertTrue(q.isEmpty());
598 <        assertEquals(0, q.size());
599 <        assertEquals(SIZE, q.remainingCapacity());
598 >        mustEqual(0, q.size());
599 >        mustEqual(capacity, q.remainingCapacity());
600          q.add(one);
601          assertFalse(q.isEmpty());
602 +        mustContain(q, one);
603          q.clear();
604          assertTrue(q.isEmpty());
605      }
# Line 657 | Line 608 | public class ArrayBlockingQueueTest exte
608       * containsAll(c) is true when c contains a subset of elements
609       */
610      public void testContainsAll() {
611 <        ArrayBlockingQueue q = populatedQueue(SIZE);
612 <        ArrayBlockingQueue p = new ArrayBlockingQueue(SIZE);
611 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
612 >        ArrayBlockingQueue<Item> p = new ArrayBlockingQueue<Item>(SIZE);
613          for (int i = 0; i < SIZE; ++i) {
614              assertTrue(q.containsAll(p));
615              assertFalse(p.containsAll(q));
616 <            p.add(new Integer(i));
616 >            mustAdd(p, i);
617          }
618          assertTrue(p.containsAll(q));
619      }
# Line 671 | Line 622 | public class ArrayBlockingQueueTest exte
622       * retainAll(c) retains only those elements of c and reports true if changed
623       */
624      public void testRetainAll() {
625 <        ArrayBlockingQueue q = populatedQueue(SIZE);
626 <        ArrayBlockingQueue p = populatedQueue(SIZE);
625 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
626 >        ArrayBlockingQueue<Item> p = populatedQueue(SIZE);
627          for (int i = 0; i < SIZE; ++i) {
628              boolean changed = q.retainAll(p);
629              if (i == 0)
# Line 681 | Line 632 | public class ArrayBlockingQueueTest exte
632                  assertTrue(changed);
633  
634              assertTrue(q.containsAll(p));
635 <            assertEquals(SIZE-i, q.size());
635 >            mustEqual(SIZE - i, q.size());
636              p.remove();
637          }
638      }
# Line 691 | Line 642 | public class ArrayBlockingQueueTest exte
642       */
643      public void testRemoveAll() {
644          for (int i = 1; i < SIZE; ++i) {
645 <            ArrayBlockingQueue q = populatedQueue(SIZE);
646 <            ArrayBlockingQueue p = populatedQueue(i);
645 >            ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
646 >            ArrayBlockingQueue<Item> p = populatedQueue(i);
647              assertTrue(q.removeAll(p));
648 <            assertEquals(SIZE-i, q.size());
648 >            mustEqual(SIZE - i, q.size());
649              for (int j = 0; j < i; ++j) {
650 <                Integer I = (Integer)(p.remove());
651 <                assertFalse(q.contains(I));
650 >                Item x = p.remove();
651 >                mustNotContain(q, x);
652              }
653          }
654      }
655  
656 <    /**
657 <     *  toArray contains all elements
658 <     */
659 <    public void testToArray() {
660 <        ArrayBlockingQueue q = populatedQueue(SIZE);
661 <        Object[] o = q.toArray();
662 <        try {
663 <        for(int i = 0; i < o.length; i++)
664 <            assertEquals(o[i], q.take());
665 <        } catch (InterruptedException e){
666 <            unexpectedException();
667 <        }    
656 >    void checkToArray(ArrayBlockingQueue<Item> q) {
657 >        int size = q.size();
658 >        Object[] a1 = q.toArray();
659 >        mustEqual(size, a1.length);
660 >        Item[] a2 = q.toArray(new Item[0]);
661 >        mustEqual(size, a2.length);
662 >        Item[] a3 = q.toArray(new Item[Math.max(0, size - 1)]);
663 >        mustEqual(size, a3.length);
664 >        Item[] a4 = new Item[size];
665 >        assertSame(a4, q.toArray(a4));
666 >        Item[] a5 = new Item[size + 1];
667 >        Arrays.fill(a5, fortytwo);
668 >        assertSame(a5, q.toArray(a5));
669 >        Item[] a6 = new Item[size + 2];
670 >        Arrays.fill(a6, fortytwo);
671 >        assertSame(a6, q.toArray(a6));
672 >        Object[][] as = { a1, a2, a3, a4, a5, a6 };
673 >        for (Object[] a : as) {
674 >            if (a.length > size) assertNull(a[size]);
675 >            if (a.length > size + 1) mustEqual(fortytwo, a[size + 1]);
676 >        }
677 >        Iterator<? extends Item> it = q.iterator();
678 >        Item s = q.peek();
679 >        for (int i = 0; i < size; i++) {
680 >            Item x = (Item) it.next();
681 >            mustEqual(s.value + i, x);
682 >            for (Object[] a : as)
683 >                mustEqual(a[i], x);
684 >        }
685      }
686  
687      /**
688 <     * toArray(a) contains all elements
688 >     * toArray() and toArray(a) contain all elements in FIFO order
689       */
690 <    public void testToArray2() {
691 <        ArrayBlockingQueue q = populatedQueue(SIZE);
692 <        Integer[] ints = new Integer[SIZE];
693 <        ints = (Integer[])q.toArray(ints);
694 <        try {
695 <            for(int i = 0; i < ints.length; i++)
696 <                assertEquals(ints[i], q.take());
697 <        } catch (InterruptedException e){
698 <            unexpectedException();
699 <        }    
690 >    public void testToArray() {
691 >        final ThreadLocalRandom rnd = ThreadLocalRandom.current();
692 >        final int size = rnd.nextInt(6);
693 >        final int capacity = Math.max(1, size + rnd.nextInt(size + 1));
694 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(capacity);
695 >        for (int i = 0; i < size; i++) {
696 >            checkToArray(q);
697 >            mustAdd(q, i);
698 >        }
699 >        // Provoke wraparound
700 >        int added = size * 2;
701 >        for (int i = 0; i < added; i++) {
702 >            checkToArray(q);
703 >            mustEqual(i, q.poll());
704 >            q.add(new Item(size + i));
705 >        }
706 >        for (int i = 0; i < size; i++) {
707 >            checkToArray(q);
708 >            mustEqual((added + i), q.poll());
709 >        }
710      }
711  
712      /**
713 <     * toArray(null) throws NPE
713 >     * toArray(incompatible array type) throws ArrayStoreException
714       */
715 <    public void testToArray_BadArg() {
716 <        try {
717 <            ArrayBlockingQueue q = populatedQueue(SIZE);
718 <            Object o[] = q.toArray(null);
719 <            shouldThrow();
720 <        } catch(NullPointerException success){}
715 >    public void testToArray_incompatibleArrayType() {
716 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
717 >        try {
718 >            q.toArray(new String[10]);
719 >            shouldThrow();
720 >        } catch (ArrayStoreException success) {}
721 >        try {
722 >            q.toArray(new String[0]);
723 >            shouldThrow();
724 >        } catch (ArrayStoreException success) {}
725      }
726  
727      /**
728 <     * toArray with incompatable array type throws CCE
728 >     * iterator iterates through all elements
729       */
730 <    public void testToArray1_BadArg() {
731 <        try {
732 <            ArrayBlockingQueue q = populatedQueue(SIZE);
733 <            Object o[] = q.toArray(new String[10] );
734 <            shouldThrow();
735 <        } catch(ArrayStoreException  success){}
730 >    public void testIterator() throws InterruptedException {
731 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
732 >        Iterator<? extends Item> it = q.iterator();
733 >        int i;
734 >        for (i = 0; it.hasNext(); i++)
735 >            mustContain(q, it.next());
736 >        mustEqual(i, SIZE);
737 >        assertIteratorExhausted(it);
738 >
739 >        it = q.iterator();
740 >        for (i = 0; it.hasNext(); i++)
741 >            mustEqual(it.next(), q.take());
742 >        mustEqual(i, SIZE);
743 >        assertIteratorExhausted(it);
744      }
745  
756    
746      /**
747 <     * iterator iterates through all elements
747 >     * iterator of empty collection has no elements
748       */
749 <    public void testIterator() {
750 <        ArrayBlockingQueue q = populatedQueue(SIZE);
762 <        Iterator it = q.iterator();
763 <        try {
764 <            while(it.hasNext()){
765 <                assertEquals(it.next(), q.take());
766 <            }
767 <        } catch (InterruptedException e){
768 <            unexpectedException();
769 <        }    
749 >    public void testEmptyIterator() {
750 >        assertIteratorExhausted(new ArrayBlockingQueue<Item>(SIZE).iterator());
751      }
752  
753      /**
754       * iterator.remove removes current element
755       */
756 <    public void testIteratorRemove () {
757 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(3);
756 >    public void testIteratorRemove() {
757 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(3);
758          q.add(two);
759          q.add(one);
760          q.add(three);
761  
762 <        Iterator it = q.iterator();
762 >        Iterator<? extends Item> it = q.iterator();
763          it.next();
764          it.remove();
765 <        
765 >
766          it = q.iterator();
767 <        assertEquals(it.next(), one);
768 <        assertEquals(it.next(), three);
767 >        assertSame(it.next(), one);
768 >        assertSame(it.next(), three);
769          assertFalse(it.hasNext());
770      }
771  
# Line 792 | Line 773 | public class ArrayBlockingQueueTest exte
773       * iterator ordering is FIFO
774       */
775      public void testIteratorOrdering() {
776 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(3);
776 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(3);
777          q.add(one);
778          q.add(two);
779          q.add(three);
# Line 800 | Line 781 | public class ArrayBlockingQueueTest exte
781          assertEquals("queue should be full", 0, q.remainingCapacity());
782  
783          int k = 0;
784 <        for (Iterator it = q.iterator(); it.hasNext();) {
785 <            int i = ((Integer)(it.next())).intValue();
805 <            assertEquals(++k, i);
784 >        for (Iterator<? extends Item> it = q.iterator(); it.hasNext();) {
785 >            mustEqual(++k, it.next());
786          }
787 <        assertEquals(3, k);
787 >        mustEqual(3, k);
788      }
789  
790      /**
791       * Modifications do not cause iterators to fail
792       */
793 <    public void testWeaklyConsistentIteration () {
794 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(3);
793 >    public void testWeaklyConsistentIteration() {
794 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(3);
795          q.add(one);
796          q.add(two);
797          q.add(three);
798 <        try {
799 <            for (Iterator it = q.iterator(); it.hasNext();) {
800 <                q.remove();
821 <                it.next();
822 <            }
823 <        }
824 <        catch (ConcurrentModificationException e) {
825 <            unexpectedException();
798 >        for (Iterator<? extends Item> it = q.iterator(); it.hasNext();) {
799 >            q.remove();
800 >            it.next();
801          }
802 <        assertEquals(0, q.size());
802 >        mustEqual(0, q.size());
803      }
804  
830
805      /**
806       * toString contains toStrings of elements
807       */
808      public void testToString() {
809 <        ArrayBlockingQueue q = populatedQueue(SIZE);
809 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
810          String s = q.toString();
811          for (int i = 0; i < SIZE; ++i) {
812 <            assertTrue(s.indexOf(String.valueOf(i)) >= 0);
812 >            assertTrue(s.contains(String.valueOf(i)));
813          }
814 <    }        
841 <
814 >    }
815  
816      /**
817       * offer transfers elements across Executor tasks
818       */
819      public void testOfferInExecutor() {
820 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
820 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(2);
821          q.add(one);
822          q.add(two);
823 <        ExecutorService executor = Executors.newFixedThreadPool(2);
824 <        executor.execute(new Runnable() {
825 <            public void run() {
826 <                threadAssertFalse(q.offer(three));
827 <                try {
828 <                    threadAssertTrue(q.offer(three, MEDIUM_DELAY_MS, TimeUnit.MILLISECONDS));
829 <                    threadAssertEquals(0, q.remainingCapacity());
830 <                }
831 <                catch (InterruptedException e) {
832 <                    threadUnexpectedException();
860 <                }
861 <            }
862 <        });
863 <
864 <        executor.execute(new Runnable() {
865 <            public void run() {
866 <                try {
867 <                    Thread.sleep(SMALL_DELAY_MS);
868 <                    threadAssertEquals(one, q.take());
869 <                }
870 <                catch (InterruptedException e) {
871 <                    threadUnexpectedException();
872 <                }
873 <            }
874 <        });
875 <        
876 <        joinPool(executor);
823 >        final CheckedBarrier threadsStarted = new CheckedBarrier(2);
824 >        final ExecutorService executor = Executors.newFixedThreadPool(2);
825 >        try (PoolCleaner cleaner = cleaner(executor)) {
826 >            executor.execute(new CheckedRunnable() {
827 >                public void realRun() throws InterruptedException {
828 >                    assertFalse(q.offer(three));
829 >                    threadsStarted.await();
830 >                    assertTrue(q.offer(three, LONG_DELAY_MS, MILLISECONDS));
831 >                    mustEqual(0, q.remainingCapacity());
832 >                }});
833  
834 +            executor.execute(new CheckedRunnable() {
835 +                public void realRun() throws InterruptedException {
836 +                    threadsStarted.await();
837 +                    mustEqual(0, q.remainingCapacity());
838 +                    assertSame(one, q.take());
839 +                }});
840 +        }
841      }
842  
843      /**
844 <     * poll retrieves elements across Executor threads
844 >     * timed poll retrieves elements across Executor threads
845       */
846      public void testPollInExecutor() {
847 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
848 <        ExecutorService executor = Executors.newFixedThreadPool(2);
849 <        executor.execute(new Runnable() {
850 <            public void run() {
851 <                threadAssertNull(q.poll());
852 <                try {
853 <                    threadAssertTrue(null != q.poll(MEDIUM_DELAY_MS, TimeUnit.MILLISECONDS));
854 <                    threadAssertTrue(q.isEmpty());
855 <                }
856 <                catch (InterruptedException e) {
857 <                    threadUnexpectedException();
895 <                }
896 <            }
897 <        });
847 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(2);
848 >        final CheckedBarrier threadsStarted = new CheckedBarrier(2);
849 >        final ExecutorService executor = Executors.newFixedThreadPool(2);
850 >        try (PoolCleaner cleaner = cleaner(executor)) {
851 >            executor.execute(new CheckedRunnable() {
852 >                public void realRun() throws InterruptedException {
853 >                    assertNull(q.poll());
854 >                    threadsStarted.await();
855 >                    assertSame(one, q.poll(LONG_DELAY_MS, MILLISECONDS));
856 >                    checkEmpty(q);
857 >                }});
858  
859 <        executor.execute(new Runnable() {
860 <            public void run() {
861 <                try {
902 <                    Thread.sleep(SMALL_DELAY_MS);
859 >            executor.execute(new CheckedRunnable() {
860 >                public void realRun() throws InterruptedException {
861 >                    threadsStarted.await();
862                      q.put(one);
863 <                }
905 <                catch (InterruptedException e) {
906 <                    threadUnexpectedException();
907 <                }
908 <            }
909 <        });
910 <        
911 <        joinPool(executor);
912 <    }
913 <
914 <    /**
915 <     * A deserialized serialized queue has same elements in same order
916 <     */
917 <    public void testSerialization() {
918 <        ArrayBlockingQueue q = populatedQueue(SIZE);
919 <
920 <        try {
921 <            ByteArrayOutputStream bout = new ByteArrayOutputStream(10000);
922 <            ObjectOutputStream out = new ObjectOutputStream(new BufferedOutputStream(bout));
923 <            out.writeObject(q);
924 <            out.close();
925 <
926 <            ByteArrayInputStream bin = new ByteArrayInputStream(bout.toByteArray());
927 <            ObjectInputStream in = new ObjectInputStream(new BufferedInputStream(bin));
928 <            ArrayBlockingQueue r = (ArrayBlockingQueue)in.readObject();
929 <            assertEquals(q.size(), r.size());
930 <            while (!q.isEmpty())
931 <                assertEquals(q.remove(), r.remove());
932 <        } catch(Exception e){
933 <            unexpectedException();
934 <        }
935 <    }
936 <
937 <    /**
938 <     * drainTo(null) throws NPE
939 <     */
940 <    public void testDrainToNull() {
941 <        ArrayBlockingQueue q = populatedQueue(SIZE);
942 <        try {
943 <            q.drainTo(null);
944 <            shouldThrow();
945 <        } catch(NullPointerException success) {
863 >                }});
864          }
865      }
866  
867      /**
868 <     * drainTo(this) throws IAE
869 <     */
870 <    public void testDrainToSelf() {
871 <        ArrayBlockingQueue q = populatedQueue(SIZE);
872 <        try {
873 <            q.drainTo(q);
874 <            shouldThrow();
875 <        } catch(IllegalArgumentException success) {
868 >     * A deserialized/reserialized queue has same elements in same order
869 >     */
870 >    public void testSerialization() throws Exception {
871 >        Queue<Item> x = populatedQueue(SIZE);
872 >        Queue<Item> y = serialClone(x);
873 >
874 >        assertNotSame(x, y);
875 >        mustEqual(x.size(), y.size());
876 >        mustEqual(x.toString(), y.toString());
877 >        assertTrue(Arrays.equals(x.toArray(), y.toArray()));
878 >        while (!x.isEmpty()) {
879 >            assertFalse(y.isEmpty());
880 >            mustEqual(x.remove(), y.remove());
881          }
882 +        assertTrue(y.isEmpty());
883      }
884  
885      /**
886       * drainTo(c) empties queue into another collection c
887 <     */
887 >     */
888      public void testDrainTo() {
889 <        ArrayBlockingQueue q = populatedQueue(SIZE);
890 <        ArrayList l = new ArrayList();
889 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
890 >        ArrayList<Item> l = new ArrayList<Item>();
891          q.drainTo(l);
892 <        assertEquals(q.size(), 0);
893 <        assertEquals(l.size(), SIZE);
894 <        for (int i = 0; i < SIZE; ++i)
895 <            assertEquals(l.get(i), new Integer(i));
892 >        mustEqual(0, q.size());
893 >        mustEqual(SIZE, l.size());
894 >        for (int i = 0; i < SIZE; ++i)
895 >            mustEqual(l.get(i), i);
896 >        q.add(zero);
897 >        q.add(one);
898 >        assertFalse(q.isEmpty());
899 >        mustContain(q, zero);
900 >        mustContain(q, one);
901 >        l.clear();
902 >        q.drainTo(l);
903 >        mustEqual(0, q.size());
904 >        mustEqual(2, l.size());
905 >        for (int i = 0; i < 2; ++i)
906 >            mustEqual(l.get(i), i);
907      }
908  
909      /**
910       * drainTo empties full queue, unblocking a waiting put.
911 <     */
912 <    public void testDrainToWithActivePut() {
913 <        final ArrayBlockingQueue q = populatedQueue(SIZE);
914 <        Thread t = new Thread(new Runnable() {
915 <                public void run() {
916 <                    try {
917 <                        q.put(new Integer(SIZE+1));
983 <                    } catch (InterruptedException ie){
984 <                        threadUnexpectedException();
985 <                    }
986 <                }
987 <            });
988 <        try {
989 <            t.start();
990 <            ArrayList l = new ArrayList();
991 <            q.drainTo(l);
992 <            assertTrue(l.size() >= SIZE);
993 <            for (int i = 0; i < SIZE; ++i)
994 <                assertEquals(l.get(i), new Integer(i));
995 <            t.join();
996 <            assertTrue(q.size() + l.size() == SIZE+1);
997 <        } catch(Exception e){
998 <            unexpectedException();
999 <        }
1000 <    }
1001 <
1002 <    /**
1003 <     * drainTo(null, n) throws NPE
1004 <     */
1005 <    public void testDrainToNullN() {
1006 <        ArrayBlockingQueue q = populatedQueue(SIZE);
1007 <        try {
1008 <            q.drainTo(null, 0);
1009 <            shouldThrow();
1010 <        } catch(NullPointerException success) {
1011 <        }
1012 <    }
911 >     */
912 >    public void testDrainToWithActivePut() throws InterruptedException {
913 >        final ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
914 >        Thread t = new Thread(new CheckedRunnable() {
915 >            public void realRun() throws InterruptedException {
916 >                q.put(new Item(SIZE + 1));
917 >            }});
918  
919 <    /**
920 <     * drainTo(this, n) throws IAE
921 <     */
922 <    public void testDrainToSelfN() {
923 <        ArrayBlockingQueue q = populatedQueue(SIZE);
924 <        try {
925 <            q.drainTo(q, 0);
926 <            shouldThrow();
1022 <        } catch(IllegalArgumentException success) {
1023 <        }
919 >        t.start();
920 >        ArrayList<Item> l = new ArrayList<Item>();
921 >        q.drainTo(l);
922 >        assertTrue(l.size() >= SIZE);
923 >        for (int i = 0; i < SIZE; ++i)
924 >            mustEqual(l.get(i), i);
925 >        t.join();
926 >        assertTrue(q.size() + l.size() >= SIZE);
927      }
928  
929      /**
930 <     * drainTo(c, n) empties first max {n, size} elements of queue into c
931 <     */
930 >     * drainTo(c, n) empties first min(n, size) elements of queue into c
931 >     */
932      public void testDrainToN() {
933 +        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<Item>(SIZE * 2);
934          for (int i = 0; i < SIZE + 2; ++i) {
935 <            ArrayBlockingQueue q = populatedQueue(SIZE);
936 <            ArrayList l = new ArrayList();
935 >            for (int j = 0; j < SIZE; j++)
936 >                mustOffer(q, j);
937 >            ArrayList<Item> l = new ArrayList<Item>();
938              q.drainTo(l, i);
939 <            int k = (i < SIZE)? i : SIZE;
940 <            assertEquals(q.size(), SIZE-k);
941 <            assertEquals(l.size(), k);
942 <            for (int j = 0; j < k; ++j)
943 <                assertEquals(l.get(j), new Integer(j));
939 >            int k = (i < SIZE) ? i : SIZE;
940 >            mustEqual(k, l.size());
941 >            mustEqual(SIZE - k, q.size());
942 >            for (int j = 0; j < k; ++j)
943 >                mustEqual(l.get(j), j);
944 >            do {} while (q.poll() != null);
945          }
946      }
947  
948 +    /**
949 +     * remove(null), contains(null) always return false
950 +     */
951 +    public void testNeverContainsNull() {
952 +        Collection<?>[] qs = {
953 +            populatedQueue(0, 1, 10, false),
954 +            populatedQueue(2, 2, 10, true),
955 +        };
956  
957 +        for (Collection<?> q : qs) {
958 +            assertFalse(q.contains(null));
959 +            assertFalse(q.remove(null));
960 +        }
961 +    }
962   }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines