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.3 by dl, Sun Sep 14 20:42:40 2003 UTC vs.
Revision 1.99 by jsr166, Wed Jan 27 01:57:24 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 junit.framework.*;
10 < import java.util.*;
11 < import java.util.concurrent.*;
12 < import java.io.*;
9 > import static java.util.concurrent.TimeUnit.MILLISECONDS;
10 >
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 >     * Returns a new queue of given size containing consecutive
66 >     * Items 0 ... n - 1.
67 >     */
68 >    static ArrayBlockingQueue<Item> populatedQueue(int n) {
69 >        return populatedQueue(n, n, n, false);
70      }
71  
72      /**
73 <     * Create a queue of given size containing consecutive
74 <     * Integers 0 ... n.
73 >     * Returns a new queue of given size containing consecutive
74 >     * Items 0 ... n - 1, with given capacity range and fairness.
75       */
76 <    private ArrayBlockingQueue populatedQueue(int n) {
77 <        ArrayBlockingQueue q = new ArrayBlockingQueue(n);
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 <
98 <    public void testConstructor1(){
99 <        assertEquals(SIZE, new ArrayBlockingQueue(SIZE).remainingCapacity());
97 >
98 >    /**
99 >     * A new queue has the indicated capacity
100 >     */
101 >    public void testConstructor1() {
102 >        mustEqual(SIZE, new ArrayBlockingQueue<Item>(SIZE).remainingCapacity());
103      }
104  
105 <    public void testConstructor2(){
106 <        try {
107 <            ArrayBlockingQueue q = new ArrayBlockingQueue(0);
108 <            fail("Cannot make zero-sized");
105 >    /**
106 >     * Constructor throws IllegalArgumentException if capacity argument nonpositive
107 >     */
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          }
47        catch (IllegalArgumentException success) {}
121      }
122  
123 <    public void testConstructor3(){
124 <
123 >    /**
124 >     * Initializing from null Collection throws NPE
125 >     */
126 >    public void testConstructor_nullCollection() {
127          try {
128 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1, true, null);
129 <            fail("Cannot make from null collection");
130 <        }
56 <        catch (NullPointerException success) {}
128 >            new ArrayBlockingQueue<Item>(1, true, null);
129 >            shouldThrow();
130 >        } catch (NullPointerException success) {}
131      }
132  
133 <    public void testConstructor4(){
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];
140 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE, false, Arrays.asList(ints));
141 <            fail("Cannot make with null elements");
64 <        }
65 <        catch (NullPointerException success) {}
139 >            new ArrayBlockingQueue<Item>(SIZE, false, elements);
140 >            shouldThrow();
141 >        } catch (NullPointerException success) {}
142      }
143  
144 <    public void testConstructor5(){
145 <        try {
146 <            Integer[] ints = new Integer[SIZE];
147 <            for (int i = 0; i < SIZE-1; ++i)
148 <                ints[i] = new Integer(i);
149 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE, false, Arrays.asList(ints));
150 <            fail("Cannot make with null elements");
151 <        }
152 <        catch (NullPointerException success) {}
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 >            new ArrayBlockingQueue<Item>(SIZE, false, elements);
152 >            shouldThrow();
153 >        } catch (NullPointerException success) {}
154      }
155  
156 <    public void testConstructor6(){
157 <        try {
158 <            Integer[] ints = new Integer[SIZE];
159 <            for (int i = 0; i < SIZE; ++i)
160 <                ints[i] = new Integer(i);
161 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1, false, Arrays.asList(ints));
162 <            fail("Cannot make with insufficient capacity");
163 <        }
164 <        catch (IllegalArgumentException success) {}
156 >    /**
157 >     * Initializing from too large collection throws IllegalArgumentException
158 >     */
159 >    public void testConstructor_collectionTooLarge() {
160 >        // just barely fits - succeeds
161 >        new ArrayBlockingQueue<Object>(SIZE, false,
162 >                                       Collections.nCopies(SIZE, ""));
163 >        try {
164 >            new ArrayBlockingQueue<Object>(SIZE - 1, false,
165 >                                   Collections.nCopies(SIZE, ""));
166 >            shouldThrow();
167 >        } catch (IllegalArgumentException success) {}
168      }
169  
170 <    public void testConstructor7(){
171 <        try {
172 <            Integer[] ints = new Integer[SIZE];
173 <            for (int i = 0; i < SIZE; ++i)
174 <                ints[i] = new Integer(i);
175 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE, true, Arrays.asList(ints));
176 <            for (int i = 0; i < SIZE; ++i)
177 <                assertEquals(ints[i], q.poll());
178 <        }
99 <        finally {}
170 >    /**
171 >     * Queue contains all elements of collection used to initialize
172 >     */
173 >    public void testConstructor7() {
174 >        Item[] items = defaultItems;
175 >        Collection<Item> elements = Arrays.asList(items);
176 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(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("should have room for 2", 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("queue should be full", 0, q.remainingCapacity());
193 <        assertFalse("offer should be rejected", q.offer(three));
192 >        mustEqual(0, q.remainingCapacity());
193 >        assertFalse(q.offer(three));
194      }
195  
196 <    public void testRemainingCapacity(){
197 <        ArrayBlockingQueue q = populatedQueue(SIZE);
198 <        for (int i = 0; i < SIZE; ++i) {
199 <            assertEquals(i, q.remainingCapacity());
200 <            assertEquals(SIZE-i, q.size());
201 <            q.remove();
202 <        }
203 <        for (int i = 0; i < SIZE; ++i) {
204 <            assertEquals(SIZE-i, q.remainingCapacity());
205 <            assertEquals(i, q.size());
206 <            q.add(new Integer(i));
196 >    /**
197 >     * remainingCapacity decreases on add, increases on remove
198 >     */
199 >    public void testRemainingCapacity() {
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          }
214      }
215  
216 <    public void testOfferNull(){
217 <        try {
218 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
219 <            q.offer(null);
220 <            fail("should throw NPE");
133 <        } catch (NullPointerException success) { }  
134 <    }
135 <
136 <    public void testOffer(){
137 <        ArrayBlockingQueue q = new ArrayBlockingQueue(1);
216 >    /**
217 >     * Offer succeeds if not full; fails if full
218 >     */
219 >    public void testOffer() {
220 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(1);
221          assertTrue(q.offer(zero));
222          assertFalse(q.offer(one));
223      }
224  
225 <    public void testAdd(){
226 <        try {
227 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
228 <            for (int i = 0; i < SIZE; ++i) {
229 <                assertTrue(q.add(new Integer(i)));
230 <            }
231 <            assertEquals(0, q.remainingCapacity());
232 <            q.add(new Integer(SIZE));
233 <        } catch (IllegalStateException success){
234 <        }  
235 <    }
153 <
154 <    public void testAddAll1(){
155 <        try {
156 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
157 <            q.addAll(null);
158 <            fail("Cannot add null collection");
159 <        }
160 <        catch (NullPointerException success) {}
161 <    }
162 <    public void testAddAll2(){
163 <        try {
164 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
165 <            Integer[] ints = new Integer[SIZE];
166 <            q.addAll(Arrays.asList(ints));
167 <            fail("Cannot add null elements");
168 <        }
169 <        catch (NullPointerException success) {}
170 <    }
171 <    public void testAddAll3(){
172 <        try {
173 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
174 <            Integer[] ints = new Integer[SIZE];
175 <            for (int i = 0; i < SIZE-1; ++i)
176 <                ints[i] = new Integer(i);
177 <            q.addAll(Arrays.asList(ints));
178 <            fail("Cannot add null elements");
179 <        }
180 <        catch (NullPointerException success) {}
181 <    }
182 <    public void testAddAll4(){
183 <        try {
184 <            ArrayBlockingQueue q = new ArrayBlockingQueue(1);
185 <            Integer[] ints = new Integer[SIZE];
186 <            for (int i = 0; i < SIZE; ++i)
187 <                ints[i] = new Integer(i);
188 <            q.addAll(Arrays.asList(ints));
189 <            fail("Cannot add with insufficient capacity");
190 <        }
191 <        catch (IllegalStateException success) {}
192 <    }
193 <    public void testAddAll5(){
194 <        try {
195 <            Integer[] empty = new Integer[0];
196 <            Integer[] ints = new Integer[SIZE];
197 <            for (int i = 0; i < SIZE; ++i)
198 <                ints[i] = new Integer(i);
199 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
200 <            assertFalse(q.addAll(Arrays.asList(empty)));
201 <            assertTrue(q.addAll(Arrays.asList(ints)));
202 <            for (int i = 0; i < SIZE; ++i)
203 <                assertEquals(ints[i], q.poll());
204 <        }
205 <        finally {}
206 <    }
207 <
208 <     public void testPutNull() {
209 <        try {
210 <            ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
211 <            q.put(null);
212 <            fail("put should throw NPE");
213 <        }
214 <        catch (NullPointerException success){
215 <        }  
216 <        catch (InterruptedException ie) {
217 <            fail("Unexpected exception");
218 <        }
219 <     }
220 <
221 <     public void testPut() {
222 <         try {
223 <             ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
224 <             for (int i = 0; i < SIZE; ++i) {
225 <                 Integer I = new Integer(i);
226 <                 q.put(I);
227 <                 assertTrue(q.contains(I));
228 <             }
229 <             assertEquals(0, q.remainingCapacity());
230 <         }
231 <        catch (InterruptedException ie) {
232 <            fail("Unexpected exception");
233 <        }
234 <    }
235 <
236 <    public void testBlockingPut(){
237 <        Thread t = new Thread(new Runnable() {
238 <                public void run() {
239 <                    int added = 0;
240 <                    try {
241 <                        ArrayBlockingQueue q = new ArrayBlockingQueue(SIZE);
242 <                        for (int i = 0; i < SIZE; ++i) {
243 <                            q.put(new Integer(i));
244 <                            ++added;
245 <                        }
246 <                        q.put(new Integer(SIZE));
247 <                        threadFail("put should block");
248 <                    } catch (InterruptedException ie){
249 <                        threadAssertEquals(added, SIZE);
250 <                    }  
251 <                }});
252 <        try {
253 <            t.start();
254 <           Thread.sleep(SHORT_DELAY_MS);
255 <           t.interrupt();
256 <           t.join();
257 <        }
258 <        catch (InterruptedException ie) {
259 <            fail("Unexpected exception");
260 <        }
225 >    /**
226 >     * add succeeds if not full; throws IllegalStateException if full
227 >     */
228 >    public void testAdd() {
229 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(SIZE);
230 >        for (int i = 0; i < SIZE; i++) assertTrue(q.add(itemFor(i)));
231 >        mustEqual(0, q.remainingCapacity());
232 >        try {
233 >            q.add(itemFor(SIZE));
234 >            shouldThrow();
235 >        } catch (IllegalStateException success) {}
236      }
237  
238 <    public void testPutWithTake() {
239 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
240 <        Thread t = new Thread(new Runnable() {
241 <                public void run(){
242 <                    int added = 0;
243 <                    try {
244 <                        q.put(new Object());
245 <                        ++added;
246 <                        q.put(new Object());
272 <                        ++added;
273 <                        q.put(new Object());
274 <                        ++added;
275 <                        q.put(new Object());
276 <                        ++added;
277 <                        threadFail("Should block");
278 <                    } catch (InterruptedException e){
279 <                        threadAssertTrue(added >= 2);
280 <                    }
281 <                }
282 <            });
283 <        try {
284 <            t.start();
285 <            Thread.sleep(SHORT_DELAY_MS);
286 <            q.take();
287 <            t.interrupt();
288 <            t.join();
289 <        } catch (Exception e){
290 <            fail("Unexpected exception");
291 <        }
238 >    /**
239 >     * addAll(this) throws IllegalArgumentException
240 >     */
241 >    public void testAddAllSelf() {
242 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
243 >        try {
244 >            q.addAll(q);
245 >            shouldThrow();
246 >        } catch (IllegalArgumentException success) {}
247      }
248  
249 <    public void testTimedOffer() {
250 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
251 <        Thread t = new Thread(new Runnable() {
252 <                public void run(){
253 <                    try {
254 <                        q.put(new Object());
255 <                        q.put(new Object());
256 <                        threadAssertFalse(q.offer(new Object(), SHORT_DELAY_MS/2, TimeUnit.MILLISECONDS));
257 <                        q.offer(new Object(), LONG_DELAY_MS, TimeUnit.MILLISECONDS);
258 <                        threadFail("Should block");
259 <                    } catch (InterruptedException success){}
305 <                }
306 <            });
307 <        
308 <        try {
309 <            t.start();
310 <            Thread.sleep(SHORT_DELAY_MS);
311 <            t.interrupt();
312 <            t.join();
313 <        } catch (Exception e){
314 <            fail("Unexpected exception");
315 <        }
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<>(SIZE);
255 >        Item[] items = new Item[2]; items[0] = zero;
256 >        try {
257 >            q.addAll(Arrays.asList(items));
258 >            shouldThrow();
259 >        } catch (NullPointerException success) {}
260      }
261  
262 <    public void testTake(){
263 <        try {
264 <            ArrayBlockingQueue q = populatedQueue(SIZE);
265 <            for (int i = 0; i < SIZE; ++i) {
266 <                assertEquals(i, ((Integer)q.take()).intValue());
267 <            }
268 <        } catch (InterruptedException e){
269 <            fail("Unexpected exception");
270 <        }  
271 <    }
272 <
273 <    public void testTakeFromEmpty() {
274 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
275 <        Thread t = new Thread(new Runnable() {
276 <                public void run(){
277 <                    try {
334 <                        q.take();
335 <                        threadFail("Should block");
336 <                    } catch (InterruptedException success){ }                
337 <                }
338 <            });
339 <        try {
340 <            t.start();
341 <            Thread.sleep(SHORT_DELAY_MS);
342 <            t.interrupt();
343 <            t.join();
344 <        } catch (Exception e){
345 <            fail("Unexpected exception");
346 <        }
262 >    /**
263 >     * addAll throws IllegalStateException if not enough room
264 >     */
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 >            q = populatedQueue(0, size, size, false);
275 >            q.addAll(Collections.nCopies(size + 1, fortytwo));
276 >            shouldThrow();
277 >        } catch (IllegalStateException success) {}
278      }
279  
280 <    public void testBlockingTake(){
281 <        Thread t = new Thread(new Runnable() {
282 <                public void run() {
283 <                    try {
284 <                        ArrayBlockingQueue q = populatedQueue(SIZE);
285 <                        for (int i = 0; i < SIZE; ++i) {
286 <                            threadAssertEquals(i, ((Integer)q.take()).intValue());
287 <                        }
288 <                        q.take();
289 <                        threadFail("take should block");
290 <                    } catch (InterruptedException success){
291 <                    }  
292 <                }});
293 <        try {
294 <            t.start();
295 <            Thread.sleep(SHORT_DELAY_MS);
296 <            t.interrupt();
297 <            t.join();
298 <        }
299 <        catch (InterruptedException ie) {
300 <            fail("Unexpected exception");
280 >    /**
281 >     * Queue contains all elements, in traversal order, of successful addAll
282 >     */
283 >    public void testAddAll5() {
284 >        Item[] empty = new Item[0];
285 >        Item[] items = defaultItems;
286 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(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 >    /**
294 >     * all elements successfully put are contained
295 >     */
296 >    public void testPut() throws InterruptedException {
297 >        ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(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() throws InterruptedException {
310 +        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(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 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<>(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<Item> q = new ArrayBlockingQueue<>(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 <    public void testPoll(){
419 <        ArrayBlockingQueue q = populatedQueue(SIZE);
418 >    /**
419 >     * take retrieves elements in FIFO order
420 >     */
421 >    public void testTake() throws InterruptedException {
422 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
423          for (int i = 0; i < SIZE; ++i) {
424 <            assertEquals(i, ((Integer)q.poll()).intValue());
424 >            mustEqual(i, q.take());
425          }
379        assertNull(q.poll());
426      }
427  
428 <    public void testTimedPoll0() {
429 <        try {
430 <            ArrayBlockingQueue q = populatedQueue(SIZE);
431 <            for (int i = 0; i < SIZE; ++i) {
432 <                assertEquals(i, ((Integer)q.poll(0, TimeUnit.MILLISECONDS)).intValue());
433 <            }
434 <            assertNull(q.poll(0, TimeUnit.MILLISECONDS));
435 <        } catch (InterruptedException e){
436 <            fail("Unexpected exception");
437 <        }  
428 >    /**
429 >     * Take removes existing elements until empty, then blocks interruptibly
430 >     */
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 <    public void testTimedPoll() {
460 <        try {
461 <            ArrayBlockingQueue q = populatedQueue(SIZE);
462 <            for (int i = 0; i < SIZE; ++i) {
463 <                assertEquals(i, ((Integer)q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS)).intValue());
464 <            }
465 <            assertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
401 <        } catch (InterruptedException e){
402 <            fail("Unexpected exception");
403 <        }  
404 <    }
405 <
406 <    public void testInterruptedTimedPoll(){
407 <        Thread t = new Thread(new Runnable() {
408 <                public void run() {
409 <                    try {
410 <                        ArrayBlockingQueue q = populatedQueue(SIZE);
411 <                        for (int i = 0; i < SIZE; ++i) {
412 <                            threadAssertEquals(i, ((Integer)q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS)).intValue());
413 <                        }
414 <                        threadAssertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
415 <                    } catch (InterruptedException success){
416 <                    }  
417 <                }});
418 <        try {
419 <            t.start();
420 <            Thread.sleep(SHORT_DELAY_MS);
421 <            t.interrupt();
422 <            t.join();
423 <        }
424 <        catch (InterruptedException ie) {
425 <            fail("Unexpected exception");
459 >    /**
460 >     * poll succeeds unless empty
461 >     */
462 >    public void testPoll() {
463 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
464 >        for (int i = 0; i < SIZE; ++i) {
465 >            mustEqual(i, q.poll());
466          }
467 +        assertNull(q.poll());
468      }
469  
470 <    public void testTimedPollWithOffer(){
471 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
472 <        Thread t = new Thread(new Runnable() {
473 <                public void run(){
474 <                    try {
475 <                        threadAssertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
476 <                        q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS);
436 <                        q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS);
437 <                        threadFail("Should block");
438 <                    } catch (InterruptedException success) { }                
439 <                }
440 <            });
441 <        try {
442 <            t.start();
443 <            Thread.sleep(SMALL_DELAY_MS);
444 <            assertTrue(q.offer(zero, SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
445 <            t.interrupt();
446 <            t.join();
447 <        } catch (Exception e){
448 <            fail("Unexpected exception");
470 >    /**
471 >     * timed poll with zero timeout succeeds when non-empty, else times out
472 >     */
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 <    }  
478 >        assertNull(q.poll(0, MILLISECONDS));
479 >        checkEmpty(q);
480 >    }
481 >
482 >    /**
483 >     * timed poll with nonzero timeout succeeds when non-empty, else times out
484 >     */
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() 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 +                Thread.currentThread().interrupt();
511 +                try {
512 +                    q.poll(randomTimeout(), randomTimeUnit());
513 +                    shouldThrow();
514 +                } catch (InterruptedException success) {}
515 +                assertFalse(Thread.interrupted());
516  
517 <    public void testPeek(){
518 <        ArrayBlockingQueue q = populatedQueue(SIZE);
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<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 <    public void testElement(){
547 <        ArrayBlockingQueue q = populatedQueue(SIZE);
546 >    /**
547 >     * element returns next element, or throws NSEE if empty
548 >     */
549 >    public void testElement() {
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 <            fail("no such element");
558 <        }
474 <        catch (NoSuchElementException success) {}
557 >            shouldThrow();
558 >        } catch (NoSuchElementException success) {}
559      }
560  
561 <    public void testRemove(){
562 <        ArrayBlockingQueue q = populatedQueue(SIZE);
561 >    /**
562 >     * remove removes next element, or throws NSEE if empty
563 >     */
564 >    public void testRemove() {
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 <            fail("remove should throw");
572 <        } catch (NoSuchElementException success){
486 <        }  
571 >            shouldThrow();
572 >        } catch (NoSuchElementException success) {}
573      }
574  
575 <    public void testRemoveElement(){
576 <        ArrayBlockingQueue q = populatedQueue(SIZE);
577 <        for (int i = 1; i < SIZE; i+=2) {
578 <            assertTrue(q.remove(new Integer(i)));
579 <        }
580 <        for (int i = 0; i < SIZE; i+=2) {
581 <            assertTrue(q.remove(new Integer(i)));
582 <            assertFalse(q.remove(new Integer(i+1)));
583 <        }
584 <        assertTrue(q.isEmpty());
585 <    }
500 <        
501 <    public void testContains(){
502 <        ArrayBlockingQueue q = populatedQueue(SIZE);
503 <        for (int i = 0; i < SIZE; ++i) {
504 <            assertTrue(q.contains(new Integer(i)));
505 <            q.poll();
506 <            assertFalse(q.contains(new Integer(i)));
575 >    /**
576 >     * contains(x) reports true when elements added but not yet removed
577 >     */
578 >    public void testContains() {
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  
589 <    public void testClear(){
590 <        ArrayBlockingQueue q = populatedQueue(SIZE);
589 >    /**
590 >     * clear removes all elements
591 >     */
592 >    public void testClear() {
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      }
606  
607 <    public void testContainsAll(){
608 <        ArrayBlockingQueue q = populatedQueue(SIZE);
609 <        ArrayBlockingQueue p = new ArrayBlockingQueue(SIZE);
607 >    /**
608 >     * containsAll(c) is true when c contains a subset of elements
609 >     */
610 >    public void testContainsAll() {
611 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
612 >        ArrayBlockingQueue<Item> p = new ArrayBlockingQueue<>(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      }
620  
621 <    public void testRetainAll(){
622 <        ArrayBlockingQueue q = populatedQueue(SIZE);
623 <        ArrayBlockingQueue p = populatedQueue(SIZE);
621 >    /**
622 >     * retainAll(c) retains only those elements of c and reports true if changed
623 >     */
624 >    public void testRetainAll() {
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 541 | 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      }
639  
640 <    public void testRemoveAll(){
640 >    /**
641 >     * removeAll(c) removes only those elements of c and reports true if changed
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 +    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 <    public void testToArray(){
688 <        ArrayBlockingQueue q = populatedQueue(SIZE);
689 <        Object[] o = q.toArray();
690 <        try {
691 <        for(int i = 0; i < o.length; i++)
692 <            assertEquals(o[i], q.take());
693 <        } catch (InterruptedException e){
694 <            fail("Unexpected exception");
695 <        }    
696 <    }
697 <
698 <    public void testToArray2(){
699 <        ArrayBlockingQueue q = populatedQueue(SIZE);
700 <        Integer[] ints = new Integer[SIZE];
701 <        ints = (Integer[])q.toArray(ints);
702 <        try {
703 <            for(int i = 0; i < ints.length; i++)
704 <                assertEquals(ints[i], q.take());
705 <        } catch (InterruptedException e){
706 <            fail("Unexpected exception");
707 <        }    
708 <    }
709 <    
586 <    public void testIterator(){
587 <        ArrayBlockingQueue q = populatedQueue(SIZE);
588 <        Iterator it = q.iterator();
589 <        try {
590 <            while(it.hasNext()){
591 <                assertEquals(it.next(), q.take());
592 <            }
593 <        } catch (InterruptedException e){
594 <            fail("Unexpected exception");
595 <        }    
687 >    /**
688 >     * toArray() and toArray(a) contain all elements in FIFO order
689 >     */
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 <    public void testIteratorOrdering() {
712 >    /**
713 >     * toArray(incompatible array type) throws ArrayStoreException
714 >     */
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 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(3);
727 >    /**
728 >     * iterator iterates through all elements
729 >     */
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 >
746 >    /**
747 >     * iterator of empty collection has no elements
748 >     */
749 >    public void testEmptyIterator() {
750 >        assertIteratorExhausted(new ArrayBlockingQueue<>(SIZE).iterator());
751 >    }
752  
753 +    /**
754 +     * iterator.remove removes current element
755 +     */
756 +    public void testIteratorRemove() {
757 +        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(3);
758 +        q.add(two);
759 +        q.add(one);
760 +        q.add(three);
761 +
762 +        Iterator<? extends Item> it = q.iterator();
763 +        it.next();
764 +        it.remove();
765 +
766 +        it = q.iterator();
767 +        assertSame(it.next(), one);
768 +        assertSame(it.next(), three);
769 +        assertFalse(it.hasNext());
770 +    }
771 +
772 +    /**
773 +     * iterator ordering is FIFO
774 +     */
775 +    public void testIteratorOrdering() {
776 +        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(3);
777          q.add(one);
778          q.add(two);
779          q.add(three);
# Line 606 | 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();
611 <            assertEquals("items should come out in order", ++k, i);
784 >        for (Iterator<? extends Item> it = q.iterator(); it.hasNext();) {
785 >            mustEqual(++k, it.next());
786          }
787 <
614 <        assertEquals("should go through 3 elements", 3, k);
787 >        mustEqual(3, k);
788      }
789  
790 <    public void testWeaklyConsistentIteration () {
791 <
792 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(3);
793 <
790 >    /**
791 >     * Modifications do not cause iterators to fail
792 >     */
793 >    public void testWeaklyConsistentIteration() {
794 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(3);
795          q.add(one);
796          q.add(two);
797          q.add(three);
798 <
799 <        try {
800 <            for (Iterator it = q.iterator(); it.hasNext();) {
627 <                q.remove();
628 <                it.next();
629 <            }
630 <        }
631 <        catch (ConcurrentModificationException e) {
632 <            fail("weakly consistent iterator; should not get CME");
798 >        for (Iterator<? extends Item> it = q.iterator(); it.hasNext();) {
799 >            q.remove();
800 >            it.next();
801          }
802 <
635 <        assertEquals("queue should be empty again", 0, q.size());
802 >        mustEqual(0, q.size());
803      }
804  
805 <
806 <    public void testToString(){
807 <        ArrayBlockingQueue q = populatedQueue(SIZE);
805 >    /**
806 >     * toString contains toStrings of elements
807 >     */
808 >    public void testToString() {
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 <    }        
646 <
814 >    }
815  
816 +    /**
817 +     * offer transfers elements across Executor tasks
818 +     */
819      public void testOfferInExecutor() {
820 <
650 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
651 <
820 >        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(2);
821          q.add(one);
822          q.add(two);
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 <        ExecutorService executor = Executors.newFixedThreadPool(2);
835 <
836 <        executor.execute(new Runnable() {
837 <            public void run() {
838 <                threadAssertFalse(q.offer(three));
839 <                try {
840 <                    threadAssertTrue(q.offer(three, MEDIUM_DELAY_MS, TimeUnit.MILLISECONDS));
662 <                    threadAssertEquals(0, q.remainingCapacity());
663 <                }
664 <                catch (InterruptedException e) {
665 <                    threadFail("should not be interrupted");
666 <                }
667 <            }
668 <        });
669 <
670 <        executor.execute(new Runnable() {
671 <            public void run() {
672 <                try {
673 <                    Thread.sleep(SMALL_DELAY_MS);
674 <                    threadAssertEquals(one, q.take());
675 <                }
676 <                catch (InterruptedException e) {
677 <                    threadFail("should not be interrupted");
678 <                }
679 <            }
680 <        });
681 <        
682 <        joinPool(executor);
683 <
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 +     * timed poll retrieves elements across Executor threads
845 +     */
846      public void testPollInExecutor() {
847 +        final ArrayBlockingQueue<Item> q = new ArrayBlockingQueue<>(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 <        final ArrayBlockingQueue q = new ArrayBlockingQueue(2);
860 <
861 <        ExecutorService executor = Executors.newFixedThreadPool(2);
691 <
692 <        executor.execute(new Runnable() {
693 <            public void run() {
694 <                threadAssertNull(q.poll());
695 <                try {
696 <                    threadAssertTrue(null != q.poll(MEDIUM_DELAY_MS, TimeUnit.MILLISECONDS));
697 <                    threadAssertTrue(q.isEmpty());
698 <                }
699 <                catch (InterruptedException e) {
700 <                    threadFail("should not be interrupted");
701 <                }
702 <            }
703 <        });
704 <
705 <        executor.execute(new Runnable() {
706 <            public void run() {
707 <                try {
708 <                    Thread.sleep(SMALL_DELAY_MS);
859 >            executor.execute(new CheckedRunnable() {
860 >                public void realRun() throws InterruptedException {
861 >                    threadsStarted.await();
862                      q.put(one);
863 <                }
864 <                catch (InterruptedException e) {
865 <                    threadFail("should not be interrupted");
713 <                }
714 <            }
715 <        });
716 <        
717 <        joinPool(executor);
863 >                }});
864 >        }
865 >    }
866  
867 +    /**
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 <    public void testSerialization() {
886 <        ArrayBlockingQueue q = populatedQueue(SIZE);
885 >    /**
886 >     * drainTo(c) empties queue into another collection c
887 >     */
888 >    public void testDrainTo() {
889 >        ArrayBlockingQueue<Item> q = populatedQueue(SIZE);
890 >        ArrayList<Item> l = new ArrayList<>();
891 >        q.drainTo(l);
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 <        try {
910 <            ByteArrayOutputStream bout = new ByteArrayOutputStream(10000);
911 <            ObjectOutputStream out = new ObjectOutputStream(new BufferedOutputStream(bout));
912 <            out.writeObject(q);
913 <            out.close();
909 >    /**
910 >     * drainTo empties full queue, unblocking a waiting put.
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 >        t.start();
920 >        ArrayList<Item> l = new ArrayList<>();
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 <            ByteArrayInputStream bin = new ByteArrayInputStream(bout.toByteArray());
930 <            ObjectInputStream in = new ObjectInputStream(new BufferedInputStream(bin));
931 <            ArrayBlockingQueue r = (ArrayBlockingQueue)in.readObject();
932 <            assertEquals(q.size(), r.size());
933 <            while (!q.isEmpty())
934 <                assertEquals(q.remove(), r.remove());
935 <        } catch(Exception e){
936 <            fail("unexpected exception");
929 >    /**
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<>(SIZE * 2);
934 >        for (int i = 0; i < SIZE + 2; ++i) {
935 >            for (int j = 0; j < SIZE; j++)
936 >                mustOffer(q, j);
937 >            ArrayList<Item> l = new ArrayList<>();
938 >            q.drainTo(l, i);
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 <
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