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

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines