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

Comparing jsr166/src/test/tck/LinkedTransferQueueTest.java (file contents):
Revision 1.2 by jsr166, Fri Jul 31 23:37:31 2009 UTC vs.
Revision 1.86 by dl, Tue Jan 26 13:33:06 2021 UTC

# Line 1 | Line 1
1
1   /*
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/licenses/publicdomain
4 > * http://creativecommons.org/publicdomain/zero/1.0/
5   * Other contributors include John Vint
6   */
7  
8 < import java.io.BufferedInputStream;
9 < import java.io.BufferedOutputStream;
11 < import java.io.ByteArrayInputStream;
12 < import java.io.ByteArrayOutputStream;
13 < import java.io.ObjectInputStream;
14 < import java.io.ObjectOutputStream;
8 > import static java.util.concurrent.TimeUnit.MILLISECONDS;
9 >
10   import java.util.ArrayList;
11   import java.util.Arrays;
12 < import java.util.ConcurrentModificationException;
12 > import java.util.Collection;
13   import java.util.Iterator;
14 + import java.util.List;
15   import java.util.NoSuchElementException;
16 < import java.util.concurrent.*;
16 > import java.util.Queue;
17 > import java.util.concurrent.BlockingQueue;
18 > import java.util.concurrent.Callable;
19 > import java.util.concurrent.CountDownLatch;
20 > import java.util.concurrent.Executors;
21 > import java.util.concurrent.ExecutorService;
22 > import java.util.concurrent.LinkedTransferQueue;
23 >
24   import junit.framework.Test;
22 import junit.framework.TestSuite;
25  
26 + @SuppressWarnings({"unchecked", "rawtypes"})
27   public class LinkedTransferQueueTest extends JSR166TestCase {
28 +    public static class Generic extends BlockingQueueTest {
29 +        protected BlockingQueue emptyCollection() {
30 +            return new LinkedTransferQueue();
31 +        }
32 +    }
33  
34      public static void main(String[] args) {
35 <        junit.textui.TestRunner.run(suite());
35 >        main(suite(), args);
36      }
37  
38      public static Test suite() {
39 <        return new TestSuite(LinkedTransferQueueTest.class);
39 >        class Implementation implements CollectionImplementation {
40 >            public Class<?> klazz() { return LinkedTransferQueue.class; }
41 >            public Collection emptyCollection() { return new LinkedTransferQueue(); }
42 >            public Object makeElement(int i) { return JSR166TestCase.itemFor(i); }
43 >            public boolean isConcurrent() { return true; }
44 >            public boolean permitsNulls() { return false; }
45 >        }
46 >        return newTestSuite(LinkedTransferQueueTest.class,
47 >                            new Generic().testSuite(),
48 >                            CollectionTest.testSuite(new Implementation()));
49      }
50  
51 <    /*
52 <     *Constructor builds new queue with size being zero and empty being true
51 >    /**
52 >     * Constructor builds new queue with size being zero and empty
53 >     * being true
54       */
55      public void testConstructor1() {
56 <        assertEquals(0, new LinkedTransferQueue().size());
56 >        mustEqual(0, new LinkedTransferQueue().size());
57          assertTrue(new LinkedTransferQueue().isEmpty());
58      }
59  
60 <    /*
61 <     * Initizialing constructor with null collection throws NPE
60 >    /**
61 >     * Initializing constructor with null collection throws
62 >     * NullPointerException
63       */
64      public void testConstructor2() {
65          try {
66              new LinkedTransferQueue(null);
67              shouldThrow();
68 <        } catch (NullPointerException success) {
50 <        }
68 >        } catch (NullPointerException success) {}
69      }
70  
71      /**
72 <     * Initializing from Collection of null elements throws NPE
72 >     * Initializing from Collection of null elements throws
73 >     * NullPointerException
74       */
75      public void testConstructor3() {
76 +        Collection<Item> elements = Arrays.asList(new Item[SIZE]);
77          try {
78 <            Integer[] ints = new Integer[SIZE];
59 <            LinkedTransferQueue q = new LinkedTransferQueue(Arrays.asList(ints));
78 >            new LinkedTransferQueue(elements);
79              shouldThrow();
80 <        } catch (NullPointerException success) {
62 <        }
80 >        } catch (NullPointerException success) {}
81      }
82 <    /*
82 >
83 >    /**
84       * Initializing constructor with a collection containing some null elements
85 <     * throws NPE
85 >     * throws NullPointerException
86       */
68
87      public void testConstructor4() {
88 +        Item[] items = new Item[2];
89 +        items[0] = zero;
90 +        Collection<Item> elements = Arrays.asList(items);
91          try {
92 <            Integer[] ints = new Integer[SIZE];
72 <            for (int i = 0; i < SIZE - 1; ++i) {
73 <                ints[i] = new Integer(i);
74 <            }
75 <            LinkedTransferQueue q = new LinkedTransferQueue(Arrays.asList(ints));
92 >            new LinkedTransferQueue(elements);
93              shouldThrow();
94 <        } catch (NullPointerException success) {
78 <        }
94 >        } catch (NullPointerException success) {}
95      }
96  
97 <    /*
97 >    /**
98       * Queue contains all elements of the collection it is initialized by
99       */
100      public void testConstructor5() {
101 <        try {
102 <            Integer[] ints = new Integer[SIZE];
103 <            for (int i = 0; i < SIZE; ++i) {
104 <                ints[i] = new Integer(i);
105 <            }
106 <            LinkedTransferQueue q = new LinkedTransferQueue(Arrays.asList(ints));
107 <            for (int i = 0; i < SIZE; ++i) {
108 <                assertEquals(ints[i], q.poll());
109 <            }
110 <        } finally {
101 >        Item[] items = defaultItems;
102 >        List<Item> intList = Arrays.asList(items);
103 >        LinkedTransferQueue<Item> q
104 >            = new LinkedTransferQueue<Item>(intList);
105 >        mustEqual(q.size(), intList.size());
106 >        mustEqual(q.toString(), intList.toString());
107 >        assertTrue(Arrays.equals(q.toArray(),
108 >                                     intList.toArray()));
109 >        assertTrue(Arrays.equals(q.toArray(new Object[0]),
110 >                                 intList.toArray(new Object[0])));
111 >        assertTrue(Arrays.equals(q.toArray(new Object[SIZE]),
112 >                                 intList.toArray(new Object[SIZE])));
113 >        for (int i = 0; i < SIZE; ++i) {
114 >            mustEqual(items[i], q.poll());
115          }
116      }
117  
118      /**
119 <     * Remaining capacity never decrease nor increase on add or remove
119 >     * remainingCapacity() always returns Integer.MAX_VALUE
120       */
121      public void testRemainingCapacity() {
122 <        LinkedTransferQueue q = populatedQueue(SIZE);
103 <        int remainingCapacity = q.remainingCapacity();
122 >        BlockingQueue<Item> q = populatedQueue(SIZE);
123          for (int i = 0; i < SIZE; ++i) {
124 <            assertEquals(remainingCapacity, q.remainingCapacity());
125 <            assertEquals(SIZE - i, q.size());
126 <            q.remove();
124 >            mustEqual(Integer.MAX_VALUE, q.remainingCapacity());
125 >            mustEqual(SIZE - i, q.size());
126 >            mustEqual(i, q.remove());
127          }
128          for (int i = 0; i < SIZE; ++i) {
129 <            assertEquals(remainingCapacity, q.remainingCapacity());
130 <            assertEquals(i, q.size());
131 <            q.add(new Integer(i));
113 <        }
114 <    }
115 <
116 <    /**
117 <     * offer(null) throws NPE
118 <     */
119 <    public void testOfferNull() {
120 <        try {
121 <            LinkedTransferQueue q = new LinkedTransferQueue();
122 <            q.offer(null);
123 <            shouldThrow();
124 <        } catch (NullPointerException success) {
129 >            mustEqual(Integer.MAX_VALUE, q.remainingCapacity());
130 >            mustEqual(i, q.size());
131 >            mustAdd(q, i);
132          }
133      }
134  
135      /**
136 <     * add(null) throws NPE
130 <     */
131 <    public void testAddNull() {
132 <        try {
133 <            LinkedTransferQueue q = new LinkedTransferQueue();
134 <            q.add(null);
135 <            shouldThrow();
136 <        } catch (NullPointerException success) {
137 <        }
138 <    }
139 <
140 <    /**
141 <     * addAll(null) throws NPE
142 <     */
143 <    public void testAddAll1() {
144 <        try {
145 <            LinkedTransferQueue q = new LinkedTransferQueue();
146 <            q.addAll(null);
147 <            shouldThrow();
148 <        } catch (NullPointerException success) {
149 <        }
150 <    }
151 <
152 <    /**
153 <     * addAll(this) throws IAE
136 >     * addAll(this) throws IllegalArgumentException
137       */
138      public void testAddAllSelf() {
139 +        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
140          try {
157            LinkedTransferQueue q = populatedQueue(SIZE);
141              q.addAll(q);
142              shouldThrow();
143 <        } catch (IllegalArgumentException success) {
161 <        }
162 <    }
163 <
164 <    /**
165 <     * addAll of a collection with null elements throws NPE
166 <     */
167 <    public void testAddAll2() {
168 <        try {
169 <            LinkedTransferQueue q = new LinkedTransferQueue();
170 <            Integer[] ints = new Integer[SIZE];
171 <            q.addAll(Arrays.asList(ints));
172 <            shouldThrow();
173 <        } catch (NullPointerException success) {
174 <        }
143 >        } catch (IllegalArgumentException success) {}
144      }
145  
146      /**
147 <     * addAll of a collection with any null elements throws NPE after
148 <     * possibly adding some elements
147 >     * addAll of a collection with any null elements throws
148 >     * NullPointerException after possibly adding some elements
149       */
150      public void testAddAll3() {
151 +        LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
152 +        Item[] items = new Item[2]; items[0] = zero;
153          try {
154 <            LinkedTransferQueue q = new LinkedTransferQueue();
184 <            Integer[] ints = new Integer[SIZE];
185 <            for (int i = 0; i < SIZE - 1; ++i) {
186 <                ints[i] = new Integer(i);
187 <            }
188 <            q.addAll(Arrays.asList(ints));
154 >            q.addAll(Arrays.asList(items));
155              shouldThrow();
156 <        } catch (NullPointerException success) {
191 <        }
156 >        } catch (NullPointerException success) {}
157      }
158  
159      /**
160       * Queue contains all elements, in traversal order, of successful addAll
161       */
162      public void testAddAll5() {
163 <        try {
164 <            Integer[] empty = new Integer[0];
165 <            Integer[] ints = new Integer[SIZE];
166 <            for (int i = 0; i < SIZE; ++i) {
167 <                ints[i] = new Integer(i);
168 <            }
169 <            LinkedTransferQueue q = new LinkedTransferQueue();
205 <            assertFalse(q.addAll(Arrays.asList(empty)));
206 <            assertTrue(q.addAll(Arrays.asList(ints)));
207 <            for (int i = 0; i < SIZE; ++i) {
208 <                assertEquals(ints[i], q.poll());
209 <            }
210 <        } finally {
211 <        }
212 <    }
213 <
214 <    /**
215 <     * put(null) throws NPE
216 <     */
217 <    public void testPutNull() {
218 <        try {
219 <            LinkedTransferQueue q = new LinkedTransferQueue();
220 <            q.put(null);
221 <            shouldThrow();
222 <        } catch (NullPointerException success) {
223 <        } catch (Exception ie) {
224 <            unexpectedException();
163 >        Item[] empty = new Item[0];
164 >        Item[] items = defaultItems;
165 >        LinkedTransferQueue q = new LinkedTransferQueue();
166 >        assertFalse(q.addAll(Arrays.asList(empty)));
167 >        assertTrue(q.addAll(Arrays.asList(items)));
168 >        for (int i = 0; i < SIZE; ++i) {
169 >            mustEqual(items[i], q.poll());
170          }
171      }
172  
# Line 229 | Line 174 | public class LinkedTransferQueueTest ext
174       * all elements successfully put are contained
175       */
176      public void testPut() {
177 <        try {
178 <            LinkedTransferQueue q = new LinkedTransferQueue();
179 <            for (int i = 0; i < SIZE; ++i) {
180 <                Integer I = new Integer(i);
181 <                q.put(I);
182 <                assertTrue(q.contains(I));
238 <            }
239 <        } catch (Exception ie) {
240 <            unexpectedException();
177 >        LinkedTransferQueue<Item> q = new LinkedTransferQueue<>();
178 >        Item[] items = defaultItems;
179 >        for (int i = 0; i < SIZE; ++i) {
180 >            mustEqual(i, q.size());
181 >            q.put(items[i]);
182 >            mustContain(q, items[i]);
183          }
184      }
185  
186      /**
187       * take retrieves elements in FIFO order
188       */
189 <    public void testTake() {
190 <        try {
191 <            LinkedTransferQueue q = populatedQueue(SIZE);
192 <            for (int i = 0; i < SIZE; ++i) {
251 <                assertEquals(i, ((Integer) q.take()).intValue());
252 <            }
253 <        } catch (InterruptedException e) {
254 <            unexpectedException();
189 >    public void testTake() throws InterruptedException {
190 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
191 >        for (int i = 0; i < SIZE; ++i) {
192 >            mustEqual(i, q.take());
193          }
194      }
195  
196      /**
197 <     * take blocks interruptibly when empty
197 >     * take removes existing elements until empty, then blocks interruptibly
198       */
199 <    public void testTakeFromEmpty() {
200 <        final LinkedTransferQueue q = new LinkedTransferQueue();
201 <        Thread t = new Thread(new Runnable() {
199 >    public void testBlockingTake() throws InterruptedException {
200 >        final BlockingQueue<Item> q = populatedQueue(SIZE);
201 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
202 >        Thread t = newStartedThread(new CheckedRunnable() {
203 >            public void realRun() throws InterruptedException {
204 >                for (int i = 0; i < SIZE; i++) mustEqual(i, q.take());
205  
206 <            public void run() {
206 >                Thread.currentThread().interrupt();
207                  try {
208                      q.take();
209 <                    threadShouldThrow();
210 <                } catch (InterruptedException success) {
211 <                }
271 <            }
272 <        });
273 <        try {
274 <            t.start();
275 <            Thread.sleep(SHORT_DELAY_MS);
276 <            t.interrupt();
277 <            t.join();
278 <        } catch (Exception e) {
279 <            unexpectedException();
280 <        }
281 <    }
282 <    /*
283 <     * Take removes existing elements until empty, then blocks interruptibly
284 <     */
285 <
286 <    public void testBlockingTake() {
287 <        Thread t = new Thread(new Runnable() {
209 >                    shouldThrow();
210 >                } catch (InterruptedException success) {}
211 >                assertFalse(Thread.interrupted());
212  
213 <            public void run() {
213 >                pleaseInterrupt.countDown();
214                  try {
291                    LinkedTransferQueue q = populatedQueue(SIZE);
292                    for (int i = 0; i < SIZE; ++i) {
293                        assertEquals(i, ((Integer) q.take()).intValue());
294                    }
215                      q.take();
216 <                    threadShouldThrow();
217 <                } catch (InterruptedException success) {
218 <                }
219 <            }
220 <        });
221 <        t.start();
222 <        try {
223 <            Thread.sleep(SHORT_DELAY_MS);
224 <            t.interrupt();
305 <            t.join();
306 <        } catch (InterruptedException ie) {
307 <            unexpectedException();
308 <        }
216 >                    shouldThrow();
217 >                } catch (InterruptedException success) {}
218 >                assertFalse(Thread.interrupted());
219 >            }});
220 >
221 >        await(pleaseInterrupt);
222 >        if (randomBoolean()) assertThreadBlocks(t, Thread.State.WAITING);
223 >        t.interrupt();
224 >        awaitTermination(t);
225      }
226  
227      /**
228       * poll succeeds unless empty
229       */
230 <    public void testPoll() {
231 <        LinkedTransferQueue q = populatedQueue(SIZE);
230 >    public void testPoll() throws InterruptedException {
231 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
232          for (int i = 0; i < SIZE; ++i) {
233 <            assertEquals(i, ((Integer) q.poll()).intValue());
233 >            mustEqual(i, q.poll());
234          }
235          assertNull(q.poll());
236 +        checkEmpty(q);
237      }
238  
239      /**
240 <     * timed pool with zero timeout succeeds when non-empty, else times out
240 >     * timed poll with zero timeout succeeds when non-empty, else times out
241       */
242 <    public void testTimedPoll0() {
243 <        try {
244 <            LinkedTransferQueue q = populatedQueue(SIZE);
245 <            for (int i = 0; i < SIZE; ++i) {
329 <                assertEquals(i, ((Integer) q.poll(0, TimeUnit.MILLISECONDS)).intValue());
330 <            }
331 <            assertNull(q.poll(0, TimeUnit.MILLISECONDS));
332 <        } catch (InterruptedException e) {
333 <            unexpectedException();
242 >    public void testTimedPoll0() throws InterruptedException {
243 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
244 >        for (int i = 0; i < SIZE; ++i) {
245 >            mustEqual(i, q.poll(0, MILLISECONDS));
246          }
247 +        assertNull(q.poll(0, MILLISECONDS));
248 +        checkEmpty(q);
249      }
250  
251      /**
252 <     * timed pool with nonzero timeout succeeds when non-empty, else times out
252 >     * timed poll with nonzero timeout succeeds when non-empty, else times out
253       */
254 <    public void testTimedPoll() {
255 <        try {
256 <            LinkedTransferQueue q = populatedQueue(SIZE);
257 <            for (int i = 0; i < SIZE; ++i) {
258 <                assertEquals(i, ((Integer) q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS)).intValue());
259 <            }
260 <            assertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
261 <        } catch (InterruptedException e) {
262 <            unexpectedException();
263 <        }
254 >    public void testTimedPoll() throws InterruptedException {
255 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
256 >        long startTime = System.nanoTime();
257 >        for (int i = 0; i < SIZE; ++i)
258 >            mustEqual(i, q.poll(LONG_DELAY_MS, MILLISECONDS));
259 >        assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
260 >
261 >        startTime = System.nanoTime();
262 >        assertNull(q.poll(timeoutMillis(), MILLISECONDS));
263 >        assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
264 >        checkEmpty(q);
265      }
266  
267      /**
268       * Interrupted timed poll throws InterruptedException instead of
269       * returning timeout status
270       */
271 <    public void testInterruptedTimedPoll() {
272 <        Thread t = new Thread(new Runnable() {
271 >    public void testInterruptedTimedPoll() throws InterruptedException {
272 >        final BlockingQueue<Item> q = populatedQueue(SIZE);
273 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
274 >        Thread t = newStartedThread(new CheckedRunnable() {
275 >            public void realRun() throws InterruptedException {
276 >                for (int i = 0; i < SIZE; i++)
277 >                    mustEqual(i, q.poll(LONG_DELAY_MS, MILLISECONDS));
278  
279 <            public void run() {
279 >                Thread.currentThread().interrupt();
280                  try {
281 <                    LinkedTransferQueue q = populatedQueue(SIZE);
282 <                    for (int i = 0; i < SIZE; ++i) {
283 <                        threadAssertEquals(i, ((Integer) q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS)).intValue());
284 <                    }
285 <                    threadAssertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
286 <                } catch (InterruptedException success) {
287 <                }
288 <            }
289 <        });
290 <        t.start();
291 <        try {
292 <            Thread.sleep(SHORT_DELAY_MS);
293 <            t.interrupt();
294 <            t.join();
295 <        } catch (InterruptedException ie) {
296 <            unexpectedException();
297 <        }
281 >                    q.poll(randomTimeout(), randomTimeUnit());
282 >                    shouldThrow();
283 >                } catch (InterruptedException success) {}
284 >                assertFalse(Thread.interrupted());
285 >
286 >                pleaseInterrupt.countDown();
287 >                try {
288 >                    q.poll(LONGER_DELAY_MS, MILLISECONDS);
289 >                    shouldThrow();
290 >                } catch (InterruptedException success) {}
291 >                assertFalse(Thread.interrupted());
292 >            }});
293 >
294 >        await(pleaseInterrupt);
295 >        if (randomBoolean()) assertThreadBlocks(t, Thread.State.TIMED_WAITING);
296 >        t.interrupt();
297 >        awaitTermination(t);
298 >        checkEmpty(q);
299      }
300  
301      /**
302 <     *  timed poll before a delayed offer fails; after offer succeeds;
303 <     *  on interruption throws
304 <     */
305 <    public void testTimedPollWithOffer() {
306 <        final LinkedTransferQueue q = new LinkedTransferQueue();
307 <        Thread t = new Thread(new Runnable() {
308 <
309 <            public void run() {
302 >     * timed poll after thread interrupted throws InterruptedException
303 >     * instead of returning timeout status
304 >     */
305 >    public void testTimedPollAfterInterrupt() throws InterruptedException {
306 >        final BlockingQueue<Item> q = populatedQueue(SIZE);
307 >        Thread t = newStartedThread(new CheckedRunnable() {
308 >            public void realRun() throws InterruptedException {
309 >                Thread.currentThread().interrupt();
310 >                for (int i = 0; i < SIZE; ++i)
311 >                    mustEqual(i, q.poll(randomTimeout(), randomTimeUnit()));
312                  try {
313 <                    threadAssertNull(q.poll(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
314 <                    q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS);
315 <                    q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS);
316 <                    threadShouldThrow();
317 <                } catch (InterruptedException success) {
318 <                }
319 <            }
320 <        });
398 <        try {
399 <            t.start();
400 <            Thread.sleep(SMALL_DELAY_MS);
401 <            assertTrue(q.offer(zero, SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
402 <            t.interrupt();
403 <            t.join();
404 <        } catch (Exception e) {
405 <            unexpectedException();
406 <        }
313 >                    q.poll(randomTimeout(), randomTimeUnit());
314 >                    shouldThrow();
315 >                } catch (InterruptedException success) {}
316 >                assertFalse(Thread.interrupted());
317 >            }});
318 >
319 >        awaitTermination(t);
320 >        checkEmpty(q);
321      }
322  
323      /**
324       * peek returns next element, or null if empty
325       */
326 <    public void testPeek() {
327 <        LinkedTransferQueue q = populatedQueue(SIZE);
326 >    public void testPeek() throws InterruptedException {
327 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
328          for (int i = 0; i < SIZE; ++i) {
329 <            assertEquals(i, ((Integer) q.peek()).intValue());
330 <            q.poll();
329 >            mustEqual(i, q.peek());
330 >            mustEqual(i, q.poll());
331              assertTrue(q.peek() == null ||
332 <                    i != ((Integer) q.peek()).intValue());
332 >                       i != q.peek().value);
333          }
334          assertNull(q.peek());
335 +        checkEmpty(q);
336      }
337  
338      /**
339 <     * element returns next element, or throws NSEE if empty
339 >     * element returns next element, or throws NoSuchElementException if empty
340       */
341 <    public void testElement() {
342 <        LinkedTransferQueue q = populatedQueue(SIZE);
341 >    public void testElement() throws InterruptedException {
342 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
343          for (int i = 0; i < SIZE; ++i) {
344 <            assertEquals(i, ((Integer) q.element()).intValue());
345 <            q.poll();
344 >            mustEqual(i, q.element());
345 >            mustEqual(i, q.poll());
346          }
347          try {
348              q.element();
349              shouldThrow();
350 <        } catch (NoSuchElementException success) {
351 <        }
350 >        } catch (NoSuchElementException success) {}
351 >        checkEmpty(q);
352      }
353  
354      /**
355 <     * remove removes next element, or throws NSEE if empty
355 >     * remove removes next element, or throws NoSuchElementException if empty
356       */
357 <    public void testRemove() {
358 <        LinkedTransferQueue q = populatedQueue(SIZE);
357 >    public void testRemove() throws InterruptedException {
358 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
359          for (int i = 0; i < SIZE; ++i) {
360 <            assertEquals(i, ((Integer) q.remove()).intValue());
360 >            mustEqual(i, q.remove());
361          }
362          try {
363              q.remove();
364              shouldThrow();
365 <        } catch (NoSuchElementException success) {
366 <        }
452 <    }
453 <
454 <    /**
455 <     * remove(x) removes x and returns true if present
456 <     */
457 <    public void testRemoveElement() {
458 <        LinkedTransferQueue q = populatedQueue(SIZE);
459 <        for (int i = 1; i < SIZE; i += 2) {
460 <            assertTrue(q.remove(new Integer(i)));
461 <        }
462 <        for (int i = 0; i < SIZE; i += 2) {
463 <            assertTrue(q.remove(new Integer(i)));
464 <            assertFalse(q.remove(new Integer(i + 1)));
465 <        }
466 <        assertTrue(q.isEmpty());
365 >        } catch (NoSuchElementException success) {}
366 >        checkEmpty(q);
367      }
368  
369      /**
370       * An add following remove(x) succeeds
371       */
372 <    public void testRemoveElementAndAdd() {
373 <        try {
374 <            LinkedTransferQueue q = new LinkedTransferQueue();
375 <            assertTrue(q.add(new Integer(1)));
376 <            assertTrue(q.add(new Integer(2)));
377 <            assertTrue(q.remove(new Integer(1)));
378 <            assertTrue(q.remove(new Integer(2)));
379 <            assertTrue(q.add(new Integer(3)));
480 <            assertTrue(q.take() != null);
481 <        } catch (Exception e) {
482 <            unexpectedException();
483 <        }
372 >    public void testRemoveElementAndAdd() throws InterruptedException {
373 >        LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
374 >        mustAdd(q, one);
375 >        mustAdd(q, two);
376 >        mustRemove(q, one);
377 >        mustRemove(q, two);
378 >        mustAdd(q, three);
379 >        mustEqual(q.take(), three);
380      }
381  
382      /**
383       * contains(x) reports true when elements added but not yet removed
384       */
385      public void testContains() {
386 <        LinkedTransferQueue q = populatedQueue(SIZE);
386 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
387          for (int i = 0; i < SIZE; ++i) {
388 <            assertTrue(q.contains(new Integer(i)));
389 <            q.poll();
390 <            assertFalse(q.contains(new Integer(i)));
388 >            mustContain(q, i);
389 >            mustEqual(i, q.poll());
390 >            mustNotContain(q, i);
391          }
392      }
393  
394      /**
395       * clear removes all elements
396       */
397 <    public void testClear() {
398 <        LinkedTransferQueue q = populatedQueue(SIZE);
503 <        int remainingCapacity = q.remainingCapacity();
397 >    public void testClear() throws InterruptedException {
398 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
399          q.clear();
400 <        assertTrue(q.isEmpty());
401 <        assertEquals(0, q.size());
507 <        assertEquals(remainingCapacity, q.remainingCapacity());
400 >        checkEmpty(q);
401 >        mustEqual(Integer.MAX_VALUE, q.remainingCapacity());
402          q.add(one);
403          assertFalse(q.isEmpty());
404 <        assertTrue(q.contains(one));
404 >        mustEqual(1, q.size());
405 >        mustContain(q, one);
406          q.clear();
407 <        assertTrue(q.isEmpty());
407 >        checkEmpty(q);
408      }
409  
410      /**
411       * containsAll(c) is true when c contains a subset of elements
412       */
413      public void testContainsAll() {
414 <        LinkedTransferQueue q = populatedQueue(SIZE);
415 <        LinkedTransferQueue p = new LinkedTransferQueue();
414 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
415 >        LinkedTransferQueue<Item> p = new LinkedTransferQueue<>();
416          for (int i = 0; i < SIZE; ++i) {
417              assertTrue(q.containsAll(p));
418              assertFalse(p.containsAll(q));
419 <            p.add(new Integer(i));
419 >            mustAdd(p, i);
420          }
421          assertTrue(p.containsAll(q));
422      }
423  
424      /**
425 <     * retainAll(c) retains only those elements of c and reports true if changed
425 >     * retainAll(c) retains only those elements of c and reports true
426 >     * if changed
427       */
428      public void testRetainAll() {
429 <        LinkedTransferQueue q = populatedQueue(SIZE);
430 <        LinkedTransferQueue p = populatedQueue(SIZE);
429 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
430 >        LinkedTransferQueue<Item> p = populatedQueue(SIZE);
431          for (int i = 0; i < SIZE; ++i) {
432              boolean changed = q.retainAll(p);
433              if (i == 0) {
# Line 540 | Line 436 | public class LinkedTransferQueueTest ext
436                  assertTrue(changed);
437              }
438              assertTrue(q.containsAll(p));
439 <            assertEquals(SIZE - i, q.size());
439 >            mustEqual(SIZE - i, q.size());
440              p.remove();
441          }
442      }
443  
444      /**
445 <     * removeAll(c) removes only those elements of c and reports true if changed
445 >     * removeAll(c) removes only those elements of c and reports true
446 >     * if changed
447       */
448      public void testRemoveAll() {
449          for (int i = 1; i < SIZE; ++i) {
450 <            LinkedTransferQueue q = populatedQueue(SIZE);
451 <            LinkedTransferQueue p = populatedQueue(i);
450 >            LinkedTransferQueue<Item> q = populatedQueue(SIZE);
451 >            LinkedTransferQueue<Item> p = populatedQueue(i);
452              assertTrue(q.removeAll(p));
453 <            assertEquals(SIZE - i, q.size());
453 >            mustEqual(SIZE - i, q.size());
454              for (int j = 0; j < i; ++j) {
455 <                Integer I = (Integer) (p.remove());
559 <                assertFalse(q.contains(I));
455 >                mustNotContain(q, p.remove());
456              }
457          }
458      }
459  
460      /**
461 <     * toArray contains all elements
461 >     * toArray() contains all elements in FIFO order
462       */
463      public void testToArray() {
464 <        LinkedTransferQueue q = populatedQueue(SIZE);
465 <        Object[] o = q.toArray();
466 <        try {
467 <            for (int i = 0; i < o.length; i++) {
468 <                assertEquals(o[i], q.take());
469 <            }
574 <        } catch (InterruptedException e) {
575 <            unexpectedException();
576 <        }
464 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
465 >        Object[] a = q.toArray();
466 >        assertSame(Object[].class, a.getClass());
467 >        for (Object o : a)
468 >            assertSame(o, q.poll());
469 >        assertTrue(q.isEmpty());
470      }
471  
472      /**
473 <     * toArray(a) contains all elements
473 >     * toArray(a) contains all elements in FIFO order
474       */
475      public void testToArray2() {
476 <        LinkedTransferQueue q = populatedQueue(SIZE);
477 <        Integer[] ints = new Integer[SIZE];
478 <        ints = (Integer[]) q.toArray(ints);
479 <        try {
480 <            for (int i = 0; i < ints.length; i++) {
481 <                assertEquals(ints[i], q.take());
482 <            }
590 <        } catch (InterruptedException e) {
591 <            unexpectedException();
592 <        }
476 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
477 >        Item[] items = new Item[SIZE];
478 >        Item[] array = q.toArray(items);
479 >        assertSame(items, array);
480 >        for (Item o : items)
481 >            assertSame(o, q.poll());
482 >        assertTrue(q.isEmpty());
483      }
484  
485      /**
486 <     * toArray(null) throws NPE
486 >     * toArray(incompatible array type) throws ArrayStoreException
487       */
488 <    public void testToArray_BadArg() {
488 >    public void testToArray1_BadArg() {
489 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
490          try {
491 <            LinkedTransferQueue q = populatedQueue(SIZE);
601 <            Object o[] = q.toArray(null);
491 >            q.toArray(new String[10]);
492              shouldThrow();
493 <        } catch (NullPointerException success) {
604 <        }
493 >        } catch (ArrayStoreException success) {}
494      }
495  
496      /**
497 <     * toArray with incompatible array type throws CCE
497 >     * iterator iterates through all elements
498       */
499 <    public void testToArray1_BadArg() {
500 <        try {
501 <            LinkedTransferQueue q = populatedQueue(SIZE);
502 <            Object o[] = q.toArray(new String[10]);
503 <            shouldThrow();
504 <        } catch (ArrayStoreException success) {
505 <        }
499 >    public void testIterator() throws InterruptedException {
500 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
501 >        Iterator<? extends Item> it = q.iterator();
502 >        int i;
503 >        for (i = 0; it.hasNext(); i++)
504 >            mustContain(q, it.next());
505 >        mustEqual(i, SIZE);
506 >        assertIteratorExhausted(it);
507 >
508 >        it = q.iterator();
509 >        for (i = 0; it.hasNext(); i++)
510 >            mustEqual(it.next(), q.take());
511 >        mustEqual(i, SIZE);
512 >        assertIteratorExhausted(it);
513      }
514  
515      /**
516 <     * iterator iterates through all elements
516 >     * iterator of empty collection has no elements
517       */
518 <    public void testIterator() {
519 <        LinkedTransferQueue q = populatedQueue(SIZE);
624 <        Iterator it = q.iterator();
625 <        try {
626 <            while (it.hasNext()) {
627 <                assertEquals(it.next(), q.take());
628 <            }
629 <        } catch (InterruptedException e) {
630 <            unexpectedException();
631 <        }
518 >    public void testEmptyIterator() {
519 >        assertIteratorExhausted(new LinkedTransferQueue().iterator());
520      }
521  
522      /**
523 <     * iterator.remove removes current element
523 >     * iterator.remove() removes current element
524       */
525      public void testIteratorRemove() {
526 <        final LinkedTransferQueue q = new LinkedTransferQueue();
526 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
527          q.add(two);
528          q.add(one);
529          q.add(three);
530  
531 <        Iterator it = q.iterator();
531 >        Iterator<? extends Item> it = q.iterator();
532          it.next();
533          it.remove();
534  
535          it = q.iterator();
536 <        assertEquals(it.next(), one);
537 <        assertEquals(it.next(), three);
536 >        assertSame(it.next(), one);
537 >        assertSame(it.next(), three);
538          assertFalse(it.hasNext());
539      }
540  
# Line 654 | Line 542 | public class LinkedTransferQueueTest ext
542       * iterator ordering is FIFO
543       */
544      public void testIteratorOrdering() {
545 <        final LinkedTransferQueue q = new LinkedTransferQueue();
546 <        int remainingCapacity = q.remainingCapacity();
545 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<>();
546 >        mustEqual(Integer.MAX_VALUE, q.remainingCapacity());
547          q.add(one);
548          q.add(two);
549          q.add(three);
550 <        assertEquals(remainingCapacity, q.remainingCapacity());
550 >        mustEqual(Integer.MAX_VALUE, q.remainingCapacity());
551          int k = 0;
552 <        for (Iterator it = q.iterator(); it.hasNext();) {
553 <            int i = ((Integer) (it.next())).intValue();
666 <            assertEquals(++k, i);
552 >        for (Item n : q) {
553 >            mustEqual(++k, n);
554          }
555 <        assertEquals(3, k);
555 >        mustEqual(3, k);
556      }
557  
558      /**
559       * Modifications do not cause iterators to fail
560       */
561      public void testWeaklyConsistentIteration() {
562 <        final LinkedTransferQueue q = new LinkedTransferQueue();
562 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
563          q.add(one);
564          q.add(two);
565          q.add(three);
566 <        try {
567 <            for (Iterator it = q.iterator(); it.hasNext();) {
568 <                q.remove();
682 <                it.next();
683 <            }
684 <        } catch (ConcurrentModificationException e) {
685 <            unexpectedException();
566 >        for (Iterator<? extends Item> it = q.iterator(); it.hasNext();) {
567 >            q.remove();
568 >            it.next();
569          }
570 <        assertEquals(0, q.size());
570 >        mustEqual(0, q.size());
571      }
572  
573      /**
574       * toString contains toStrings of elements
575       */
576      public void testToString() {
577 <        LinkedTransferQueue q = populatedQueue(SIZE);
577 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
578          String s = q.toString();
579          for (int i = 0; i < SIZE; ++i) {
580 <            assertTrue(s.indexOf(String.valueOf(i)) >= 0);
580 >            assertTrue(s.contains(String.valueOf(i)));
581          }
582      }
583  
# Line 702 | Line 585 | public class LinkedTransferQueueTest ext
585       * offer transfers elements across Executor tasks
586       */
587      public void testOfferInExecutor() {
588 <        final LinkedTransferQueue q = new LinkedTransferQueue();
589 <        q.add(one);
590 <        q.add(two);
591 <        ExecutorService executor = Executors.newFixedThreadPool(2);
592 <        executor.execute(new Runnable() {
593 <
594 <            public void run() {
595 <                try {
596 <                    threadAssertTrue(q.offer(three, MEDIUM_DELAY_MS, TimeUnit.MILLISECONDS));
597 <                } catch (Exception e) {
598 <                    threadUnexpectedException();
599 <                }
600 <            }
601 <        });
602 <
603 <        executor.execute(new Runnable() {
604 <
605 <            public void run() {
606 <                try {
607 <                    Thread.sleep(SMALL_DELAY_MS);
725 <                    threadAssertEquals(one, q.take());
726 <                } catch (InterruptedException e) {
727 <                    threadUnexpectedException();
728 <                }
729 <            }
730 <        });
731 <
732 <        joinPool(executor);
588 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
589 >        final CheckedBarrier threadsStarted = new CheckedBarrier(2);
590 >        final ExecutorService executor = Executors.newFixedThreadPool(2);
591 >        try (PoolCleaner cleaner = cleaner(executor)) {
592 >
593 >            executor.execute(new CheckedRunnable() {
594 >                public void realRun() throws InterruptedException {
595 >                    threadsStarted.await();
596 >                    long startTime = System.nanoTime();
597 >                    assertTrue(q.offer(one, LONG_DELAY_MS, MILLISECONDS));
598 >                    assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
599 >                }});
600 >
601 >            executor.execute(new CheckedRunnable() {
602 >                public void realRun() throws InterruptedException {
603 >                    threadsStarted.await();
604 >                    assertSame(one, q.take());
605 >                    checkEmpty(q);
606 >                }});
607 >        }
608      }
609  
610      /**
611 <     * poll retrieves elements across Executor threads
611 >     * timed poll retrieves elements across Executor threads
612       */
613      public void testPollInExecutor() {
614 <        final LinkedTransferQueue q = new LinkedTransferQueue();
615 <        ExecutorService executor = Executors.newFixedThreadPool(2);
616 <        executor.execute(new Runnable() {
617 <
618 <            public void run() {
619 <                threadAssertNull(q.poll());
620 <                try {
621 <                    threadAssertTrue(null != q.poll(MEDIUM_DELAY_MS, TimeUnit.MILLISECONDS));
622 <                    threadAssertTrue(q.isEmpty());
623 <                } catch (InterruptedException e) {
624 <                    threadUnexpectedException();
625 <                }
626 <            }
627 <        });
628 <
629 <        executor.execute(new Runnable() {
630 <
631 <            public void run() {
757 <                try {
758 <                    Thread.sleep(SMALL_DELAY_MS);
614 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
615 >        final CheckedBarrier threadsStarted = new CheckedBarrier(2);
616 >        final ExecutorService executor = Executors.newFixedThreadPool(2);
617 >        try (PoolCleaner cleaner = cleaner(executor)) {
618 >
619 >            executor.execute(new CheckedRunnable() {
620 >                public void realRun() throws InterruptedException {
621 >                    assertNull(q.poll());
622 >                    threadsStarted.await();
623 >                    long startTime = System.nanoTime();
624 >                    assertSame(one, q.poll(LONG_DELAY_MS, MILLISECONDS));
625 >                    assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
626 >                    checkEmpty(q);
627 >                }});
628 >
629 >            executor.execute(new CheckedRunnable() {
630 >                public void realRun() throws InterruptedException {
631 >                    threadsStarted.await();
632                      q.put(one);
633 <                } catch (InterruptedException e) {
761 <                    threadUnexpectedException();
762 <                }
763 <            }
764 <        });
765 <
766 <        joinPool(executor);
767 <    }
768 <
769 <    /**
770 <     * A deserialized serialized queue has same elements in same order
771 <     */
772 <    public void testSerialization() {
773 <        LinkedTransferQueue q = populatedQueue(SIZE);
774 <
775 <        try {
776 <            ByteArrayOutputStream bout = new ByteArrayOutputStream(10000);
777 <            ObjectOutputStream out = new ObjectOutputStream(new BufferedOutputStream(bout));
778 <            out.writeObject(q);
779 <            out.close();
780 <
781 <            ByteArrayInputStream bin = new ByteArrayInputStream(bout.toByteArray());
782 <            ObjectInputStream in = new ObjectInputStream(new BufferedInputStream(bin));
783 <            LinkedTransferQueue r = (LinkedTransferQueue) in.readObject();
784 <
785 <            assertEquals(q.size(), r.size());
786 <            while (!q.isEmpty()) {
787 <                assertEquals(q.remove(), r.remove());
788 <            }
789 <        } catch (Exception e) {
790 <            unexpectedException();
633 >                }});
634          }
635      }
636  
637      /**
638 <     * drainTo(null) throws NPE
638 >     * A deserialized/reserialized queue has same elements in same order
639       */
640 <    public void testDrainToNull() {
641 <        LinkedTransferQueue q = populatedQueue(SIZE);
642 <        try {
800 <            q.drainTo(null);
801 <            shouldThrow();
802 <        } catch (NullPointerException success) {
803 <        }
804 <    }
640 >    public void testSerialization() throws Exception {
641 >        Queue<Item> x = populatedQueue(SIZE);
642 >        Queue<Item> y = serialClone(x);
643  
644 <    /**
645 <     * drainTo(this) throws IAE
646 <     */
647 <    public void testDrainToSelf() {
648 <        LinkedTransferQueue q = populatedQueue(SIZE);
649 <        try {
650 <            q.drainTo(q);
813 <            shouldThrow();
814 <        } catch (IllegalArgumentException success) {
644 >        assertNotSame(y, x);
645 >        mustEqual(x.size(), y.size());
646 >        mustEqual(x.toString(), y.toString());
647 >        assertTrue(Arrays.equals(x.toArray(), y.toArray()));
648 >        while (!x.isEmpty()) {
649 >            assertFalse(y.isEmpty());
650 >            mustEqual(x.remove(), y.remove());
651          }
652 +        assertTrue(y.isEmpty());
653      }
654  
655      /**
656       * drainTo(c) empties queue into another collection c
657       */
658      public void testDrainTo() {
659 <        LinkedTransferQueue q = populatedQueue(SIZE);
659 >        LinkedTransferQueue<Item> q = populatedQueue(SIZE);
660          ArrayList l = new ArrayList();
661          q.drainTo(l);
662 <        assertEquals(q.size(), 0);
663 <        assertEquals(l.size(), SIZE);
662 >        mustEqual(0, q.size());
663 >        mustEqual(SIZE, l.size());
664          for (int i = 0; i < SIZE; ++i) {
665 <            assertEquals(l.get(i), new Integer(i));
665 >            mustEqual(i, l.get(i));
666          }
667          q.add(zero);
668          q.add(one);
669          assertFalse(q.isEmpty());
670 <        assertTrue(q.contains(zero));
671 <        assertTrue(q.contains(one));
670 >        mustContain(q, zero);
671 >        mustContain(q, one);
672          l.clear();
673          q.drainTo(l);
674 <        assertEquals(q.size(), 0);
675 <        assertEquals(l.size(), 2);
674 >        mustEqual(0, q.size());
675 >        mustEqual(2, l.size());
676          for (int i = 0; i < 2; ++i) {
677 <            assertEquals(l.get(i), new Integer(i));
677 >            mustEqual(i, l.get(i));
678          }
679      }
680  
681      /**
682 <     * drainTo empties full queue, unblocking a waiting put.
682 >     * drainTo(c) empties full queue, unblocking a waiting put.
683       */
684 <    public void testDrainToWithActivePut() {
685 <        final LinkedTransferQueue q = populatedQueue(SIZE);
686 <        Thread t = new Thread(new Runnable() {
684 >    public void testDrainToWithActivePut() throws InterruptedException {
685 >        final LinkedTransferQueue<Item> q = populatedQueue(SIZE);
686 >        Thread t = newStartedThread(new CheckedRunnable() {
687 >            public void realRun() {
688 >                q.put(new Item(SIZE + 1));
689 >            }});
690 >        ArrayList l = new ArrayList();
691 >        q.drainTo(l);
692 >        assertTrue(l.size() >= SIZE);
693 >        for (int i = 0; i < SIZE; ++i)
694 >            mustEqual(i, l.get(i));
695 >        awaitTermination(t);
696 >        assertTrue(q.size() + l.size() >= SIZE);
697 >    }
698  
699 <            public void run() {
700 <                try {
701 <                    q.put(new Integer(SIZE + 1));
702 <                } catch (Exception ie) {
703 <                    threadUnexpectedException();
704 <                }
699 >    /**
700 >     * drainTo(c, n) empties first min(n, size) elements of queue into c
701 >     */
702 >    public void testDrainToN() {
703 >        LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
704 >        for (int i = 0; i < SIZE + 2; ++i) {
705 >            for (int j = 0; j < SIZE; j++) {
706 >                mustOffer(q, j);
707              }
858        });
859        try {
860            t.start();
708              ArrayList l = new ArrayList();
709 <            q.drainTo(l);
710 <            assertTrue(l.size() >= SIZE);
711 <            for (int i = 0; i < SIZE; ++i) {
712 <                assertEquals(l.get(i), new Integer(i));
713 <            }
714 <            t.join();
715 <            assertTrue(q.size() + l.size() >= SIZE);
869 <        } catch (Exception e) {
870 <            unexpectedException();
709 >            q.drainTo(l, i);
710 >            int k = (i < SIZE) ? i : SIZE;
711 >            mustEqual(k, l.size());
712 >            mustEqual(SIZE - k, q.size());
713 >            for (int j = 0; j < k; ++j)
714 >                mustEqual(j, l.get(j));
715 >            do {} while (q.poll() != null);
716          }
717      }
718  
719      /**
720 <     * drainTo(null, n) throws NPE
720 >     * timed poll() or take() increments the waiting consumer count;
721 >     * offer(e) decrements the waiting consumer count
722       */
723 <    public void testDrainToNullN() {
724 <        LinkedTransferQueue q = populatedQueue(SIZE);
725 <        try {
726 <            q.drainTo(null, 0);
727 <            shouldThrow();
728 <        } catch (NullPointerException success) {
729 <        }
723 >    public void testWaitingConsumer() throws InterruptedException {
724 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
725 >        mustEqual(0, q.getWaitingConsumerCount());
726 >        assertFalse(q.hasWaitingConsumer());
727 >        final CountDownLatch threadStarted = new CountDownLatch(1);
728 >
729 >        Thread t = newStartedThread(new CheckedRunnable() {
730 >            public void realRun() throws InterruptedException {
731 >                threadStarted.countDown();
732 >                long startTime = System.nanoTime();
733 >                assertSame(one, q.poll(LONG_DELAY_MS, MILLISECONDS));
734 >                mustEqual(0, q.getWaitingConsumerCount());
735 >                assertFalse(q.hasWaitingConsumer());
736 >                assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
737 >            }});
738 >
739 >        threadStarted.await();
740 >        Callable<Boolean> oneConsumer
741 >            = new Callable<Boolean>() { public Boolean call() {
742 >                return q.hasWaitingConsumer()
743 >                && q.getWaitingConsumerCount() == 1; }};
744 >        waitForThreadToEnterWaitState(t, oneConsumer);
745 >
746 >        assertTrue(q.offer(one));
747 >        mustEqual(0, q.getWaitingConsumerCount());
748 >        assertFalse(q.hasWaitingConsumer());
749 >
750 >        awaitTermination(t);
751      }
752  
753      /**
754 <     * drainTo(this, n) throws IAE
754 >     * transfer(null) throws NullPointerException
755       */
756 <    public void testDrainToSelfN() {
890 <        LinkedTransferQueue q = populatedQueue(SIZE);
756 >    public void testTransfer1() throws InterruptedException {
757          try {
758 <            q.drainTo(q, 0);
758 >            LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
759 >            q.transfer(null);
760              shouldThrow();
761 <        } catch (IllegalArgumentException success) {
895 <        }
761 >        } catch (NullPointerException success) {}
762      }
763  
764      /**
765 <     * drainTo(c, n) empties first max {n, size} elements of queue into c
765 >     * transfer waits until a poll occurs. The transferred element
766 >     * is returned by the associated poll.
767       */
768 <    public void testDrainToN() {
769 <        LinkedTransferQueue q = new LinkedTransferQueue();
770 <        for (int i = 0; i < SIZE + 2; ++i) {
904 <            for (int j = 0; j < SIZE; j++) {
905 <                assertTrue(q.offer(new Integer(j)));
906 <            }
907 <            ArrayList l = new ArrayList();
908 <            q.drainTo(l, i);
909 <            int k = (i < SIZE) ? i : SIZE;
910 <            assertEquals(l.size(), k);
911 <            assertEquals(q.size(), SIZE - k);
912 <            for (int j = 0; j < k; ++j) {
913 <                assertEquals(l.get(j), new Integer(j));
914 <            }
915 <            while (q.poll() != null);
916 <        }
917 <    }
768 >    public void testTransfer2() throws InterruptedException {
769 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<>();
770 >        final CountDownLatch threadStarted = new CountDownLatch(1);
771  
772 <    /*
773 <     * poll and take should decrement the waiting consumer count
774 <     */
775 <    public void testWaitingConsumer() {
776 <        try {
777 <            final LinkedTransferQueue q = new LinkedTransferQueue();
778 <            final ConsumerObserver waiting = new ConsumerObserver();
779 <            new Thread(new Runnable() {
780 <
781 <                public void run() {
782 <                    try {
783 <                        threadAssertTrue(q.hasWaitingConsumer());
784 <                        waiting.setWaitingConsumer(q.getWaitingConsumerCount());
785 <                        threadAssertTrue(q.offer(new Object()));
786 <                    } catch (Exception ex) {
787 <                        threadUnexpectedException();
935 <                    }
936 <
937 <                }
938 <            }).start();
939 <            assertTrue(q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS) != null);
940 <            assertTrue(q.getWaitingConsumerCount() < waiting.getWaitingConsumers());
941 <        } catch (Exception ex) {
942 <            this.unexpectedException();
943 <        }
772 >        Thread t = newStartedThread(new CheckedRunnable() {
773 >            public void realRun() throws InterruptedException {
774 >                threadStarted.countDown();
775 >                q.transfer(five);
776 >                checkEmpty(q);
777 >            }});
778 >
779 >        threadStarted.await();
780 >        Callable<Boolean> oneElement
781 >            = new Callable<Boolean>() { public Boolean call() {
782 >                return !q.isEmpty() && q.size() == 1; }};
783 >        waitForThreadToEnterWaitState(t, oneElement);
784 >
785 >        assertSame(five, q.poll());
786 >        checkEmpty(q);
787 >        awaitTermination(t);
788      }
789 <    /*
790 <     * Inserts null into transfer throws NPE
789 >
790 >    /**
791 >     * transfer waits until a poll occurs, and then transfers in fifo order
792       */
793 +    public void testTransfer3() throws InterruptedException {
794 +        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<>();
795  
796 <    public void testTransfer1() {
797 <        try {
798 <            LinkedTransferQueue q = new LinkedTransferQueue();
799 <            q.transfer(null);
800 <            shouldThrow();
801 <        } catch (NullPointerException ex) {
802 <        } catch (Exception ex) {
803 <            this.unexpectedException();
804 <        }
796 >        Thread first = newStartedThread(new CheckedRunnable() {
797 >            public void realRun() throws InterruptedException {
798 >                q.transfer(four);
799 >                mustNotContain(q, four);
800 >                mustEqual(1, q.size());
801 >            }});
802 >
803 >        Thread interruptedThread = newStartedThread(
804 >            new CheckedInterruptedRunnable() {
805 >                public void realRun() throws InterruptedException {
806 >                    while (q.isEmpty())
807 >                        Thread.yield();
808 >                    q.transfer(five);
809 >                }});
810 >
811 >        while (q.size() < 2)
812 >            Thread.yield();
813 >        mustEqual(2, q.size());
814 >        assertSame(four, q.poll());
815 >        first.join();
816 >        mustEqual(1, q.size());
817 >        interruptedThread.interrupt();
818 >        interruptedThread.join();
819 >        checkEmpty(q);
820      }
821  
822 <    /*
823 <     * transfer attempts to insert into the queue then wait until that
824 <     * object is removed via take or poll.
822 >    /**
823 >     * transfer waits until a poll occurs, at which point the polling
824 >     * thread returns the element
825       */
826 <    public void testTransfer2() {
827 <        final LinkedTransferQueue<Integer> q = new LinkedTransferQueue<Integer>();
966 <        new Thread(new Runnable() {
826 >    public void testTransfer4() throws InterruptedException {
827 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
828  
829 <            public void run() {
830 <                try {
831 <                    q.transfer(new Integer(SIZE));
832 <                    threadAssertTrue(q.isEmpty());
833 <                } catch (Exception ex) {
834 <                    threadUnexpectedException();
974 <                }
975 <            }
976 <        }).start();
829 >        Thread t = newStartedThread(new CheckedRunnable() {
830 >            public void realRun() throws InterruptedException {
831 >                q.transfer(four);
832 >                mustNotContain(q, four);
833 >                assertSame(three, q.poll());
834 >            }});
835  
836 <        try {
837 <            Thread.sleep(SHORT_DELAY_MS);
838 <            assertEquals(1, q.size());
839 <            q.poll();
840 <            assertTrue(q.isEmpty());
841 <        } catch (Exception ex) {
842 <            this.unexpectedException();
985 <        }
986 <    }
987 <    /*
988 <     * transfer will attempt to transfer in fifo order and continue waiting if
989 <     * the element being transfered is not polled or taken
990 <     */
991 <
992 <    public void testTransfer3() {
993 <        final LinkedTransferQueue<Integer> q = new LinkedTransferQueue<Integer>();
994 <        new Thread(new Runnable() {
995 <                public void run() {
996 <                    try {
997 <                        Integer i;
998 <                        q.transfer((i = new Integer(SIZE + 1)));
999 <                        threadAssertTrue(!q.contains(i));
1000 <                        threadAssertEquals(1, q.size());
1001 <                    } catch (Exception ex) {
1002 <                        threadUnexpectedException();
1003 <                    }
1004 <                }
1005 <            }).start();
1006 <        Thread interruptedThread =
1007 <            new Thread(new Runnable() {
1008 <                    public void run() {
1009 <                        try {
1010 <                            q.transfer(new Integer(SIZE));
1011 <                            threadShouldThrow();
1012 <                        } catch (InterruptedException ex) {
1013 <                        }
1014 <                    }
1015 <                });
1016 <        interruptedThread.start();
1017 <        try {
1018 <            Thread.sleep(LONG_DELAY_MS);
1019 <            assertEquals(2, q.size());
1020 <            q.poll();
1021 <            Thread.sleep(LONG_DELAY_MS);
1022 <            interruptedThread.interrupt();
1023 <            assertEquals(1, q.size());
1024 <        } catch (Exception ex) {
1025 <            this.unexpectedException();
1026 <        }
836 >        while (q.isEmpty())
837 >            Thread.yield();
838 >        assertFalse(q.isEmpty());
839 >        mustEqual(1, q.size());
840 >        assertTrue(q.offer(three));
841 >        assertSame(four, q.poll());
842 >        awaitTermination(t);
843      }
844  
845      /**
846 <     * transfer will wait as long as a poll or take occurs if one does occur
847 <     * the waiting is finished and the thread that tries to poll/take
1032 <     * wins in retrieving the element
846 >     * transfer waits until a take occurs. The transferred element
847 >     * is returned by the associated take.
848       */
849 <    public void testTransfer4() {
850 <        final LinkedTransferQueue q = new LinkedTransferQueue();
1036 <        new Thread(new Runnable() {
849 >    public void testTransfer5() throws InterruptedException {
850 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<>();
851  
852 <            public void run() {
853 <                try {
854 <                    q.transfer(new Integer(four));
855 <                    threadAssertFalse(q.contains(new Integer(four)));
856 <                    threadAssertEquals(new Integer(three), q.poll());
857 <                } catch (Exception ex) {
858 <                    threadUnexpectedException();
859 <                }
860 <            }
861 <        }).start();
862 <        try {
863 <            Thread.sleep(MEDIUM_DELAY_MS);
864 <            assertTrue(q.offer(three));
1051 <            assertEquals(new Integer(four), q.poll());
1052 <        } catch (Exception ex) {
1053 <            this.unexpectedException();
1054 <        }
852 >        Thread t = newStartedThread(new CheckedRunnable() {
853 >            public void realRun() throws InterruptedException {
854 >                q.transfer(four);
855 >                checkEmpty(q);
856 >            }});
857 >
858 >        while (q.isEmpty())
859 >            Thread.yield();
860 >        assertFalse(q.isEmpty());
861 >        mustEqual(1, q.size());
862 >        assertSame(four, q.take());
863 >        checkEmpty(q);
864 >        awaitTermination(t);
865      }
1056    /*
1057     * Insert null into trTransfer throws NPE
1058     */
866  
867 +    /**
868 +     * tryTransfer(null) throws NullPointerException
869 +     */
870      public void testTryTransfer1() {
871 +        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
872          try {
1062            final LinkedTransferQueue q = new LinkedTransferQueue();
873              q.tryTransfer(null);
874 <            this.shouldThrow();
875 <        } catch (NullPointerException ex) {
1066 <        } catch (Exception ex) {
1067 <            this.unexpectedException();
1068 <        }
874 >            shouldThrow();
875 >        } catch (NullPointerException success) {}
876      }
877 <    /*
878 <     * tryTransfer returns false and does not enqueue if there are no consumers
879 <     * waiting to poll or take.
877 >
878 >    /**
879 >     * tryTransfer returns false and does not enqueue if there are no
880 >     * consumers waiting to poll or take.
881       */
882 +    public void testTryTransfer2() throws InterruptedException {
883 +        final LinkedTransferQueue<Object> q = new LinkedTransferQueue<Object>();
884 +        assertFalse(q.tryTransfer(new Object()));
885 +        assertFalse(q.hasWaitingConsumer());
886 +        checkEmpty(q);
887 +    }
888  
889 <    public void testTryTransfer2() {
890 <        try {
891 <            final LinkedTransferQueue q = new LinkedTransferQueue();
892 <            assertFalse(q.tryTransfer(new Object()));
893 <            assertEquals(0, q.size());
894 <        } catch (Exception ex) {
895 <            this.unexpectedException();
896 <        }
889 >    /**
890 >     * If there is a consumer waiting in timed poll, tryTransfer
891 >     * returns true while successfully transfering object.
892 >     */
893 >    public void testTryTransfer3() throws InterruptedException {
894 >        final Object hotPotato = new Object();
895 >        final LinkedTransferQueue<Object> q = new LinkedTransferQueue<Object>();
896 >
897 >        Thread t = newStartedThread(new CheckedRunnable() {
898 >            public void realRun() {
899 >                while (! q.hasWaitingConsumer())
900 >                    Thread.yield();
901 >                assertTrue(q.hasWaitingConsumer());
902 >                checkEmpty(q);
903 >                assertTrue(q.tryTransfer(hotPotato));
904 >            }});
905 >
906 >        long startTime = System.nanoTime();
907 >        assertSame(hotPotato, q.poll(LONG_DELAY_MS, MILLISECONDS));
908 >        assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
909 >        checkEmpty(q);
910 >        awaitTermination(t);
911      }
912 <    /*
913 <     * if there is a consumer waiting poll or take tryTransfer returns
914 <     * true while enqueueing object
912 >
913 >    /**
914 >     * If there is a consumer waiting in take, tryTransfer returns
915 >     * true while successfully transfering object.
916       */
917 +    public void testTryTransfer4() throws InterruptedException {
918 +        final Object hotPotato = new Object();
919 +        final LinkedTransferQueue<Object> q = new LinkedTransferQueue<Object>();
920  
921 <    public void testTryTransfer3() {
922 <        try {
923 <            final LinkedTransferQueue q = new LinkedTransferQueue();
924 <            new Thread(new Runnable() {
921 >        Thread t = newStartedThread(new CheckedRunnable() {
922 >            public void realRun() {
923 >                while (! q.hasWaitingConsumer())
924 >                    Thread.yield();
925 >                assertTrue(q.hasWaitingConsumer());
926 >                checkEmpty(q);
927 >                assertTrue(q.tryTransfer(hotPotato));
928 >            }});
929  
930 <                public void run() {
931 <                    try {
932 <                        threadAssertTrue(q.hasWaitingConsumer());
1097 <                        threadAssertTrue(q.tryTransfer(new Object()));
1098 <                    } catch (Exception ex) {
1099 <                        threadUnexpectedException();
1100 <                    }
1101 <
1102 <                }
1103 <            }).start();
1104 <            assertTrue(q.poll(LONG_DELAY_MS, TimeUnit.MILLISECONDS) != null);
1105 <            assertTrue(q.isEmpty());
1106 <        } catch (Exception ex) {
1107 <            this.unexpectedException();
1108 <        }
930 >        assertSame(q.take(), hotPotato);
931 >        checkEmpty(q);
932 >        awaitTermination(t);
933      }
934  
935 <    /*
936 <     * tryTransfer waits the amount given if interrupted, show an
937 <     * interrupted exception
938 <     */
939 <    public void testTryTransfer4() {
940 <        final LinkedTransferQueue q = new LinkedTransferQueue();
941 <        Thread toInterrupt = new Thread(new Runnable() {
935 >    /**
936 >     * tryTransfer blocks interruptibly if no takers
937 >     */
938 >    public void testTryTransfer5() throws InterruptedException {
939 >        final LinkedTransferQueue<Object> q = new LinkedTransferQueue<Object>();
940 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
941 >        assertTrue(q.isEmpty());
942 >
943 >        Thread t = newStartedThread(new CheckedRunnable() {
944 >            public void realRun() throws InterruptedException {
945 >                Thread.currentThread().interrupt();
946 >                try {
947 >                    q.tryTransfer(new Object(), randomTimeout(), randomTimeUnit());
948 >                    shouldThrow();
949 >                } catch (InterruptedException success) {}
950 >                assertFalse(Thread.interrupted());
951  
952 <            public void run() {
952 >                pleaseInterrupt.countDown();
953                  try {
954 <                    q.tryTransfer(new Object(), LONG_DELAY_MS, TimeUnit.MILLISECONDS);
955 <                    threadShouldThrow();
956 <                } catch (InterruptedException ex) {
957 <                }
958 <            }
959 <        });
960 <        try {
961 <            toInterrupt.start();
962 <            Thread.sleep(SMALL_DELAY_MS);
963 <            toInterrupt.interrupt();
964 <        } catch (Exception ex) {
1132 <            this.unexpectedException();
1133 <        }
954 >                    q.tryTransfer(new Object(), LONGER_DELAY_MS, MILLISECONDS);
955 >                    shouldThrow();
956 >                } catch (InterruptedException success) {}
957 >                assertFalse(Thread.interrupted());
958 >            }});
959 >
960 >        await(pleaseInterrupt);
961 >        if (randomBoolean()) assertThreadBlocks(t, Thread.State.TIMED_WAITING);
962 >        t.interrupt();
963 >        awaitTermination(t);
964 >        checkEmpty(q);
965      }
966  
967 <    /*
968 <     * tryTransfer gives up after the timeout and return false
969 <     */
970 <    public void testTryTransfer5() {
971 <        final LinkedTransferQueue q = new LinkedTransferQueue();
972 <        try {
973 <            new Thread(new Runnable() {
967 >    /**
968 >     * tryTransfer gives up after the timeout and returns false
969 >     */
970 >    public void testTryTransfer6() throws InterruptedException {
971 >        final LinkedTransferQueue<Object> q = new LinkedTransferQueue<Object>();
972 >
973 >        Thread t = newStartedThread(new CheckedRunnable() {
974 >            public void realRun() throws InterruptedException {
975 >                long startTime = System.nanoTime();
976 >                assertFalse(q.tryTransfer(new Object(),
977 >                                          timeoutMillis(), MILLISECONDS));
978 >                assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
979 >                checkEmpty(q);
980 >            }});
981  
982 <                public void run() {
983 <                    try {
1146 <                        threadAssertFalse(q.tryTransfer(new Object(), SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
1147 <                    } catch (InterruptedException ex) {
1148 <                        threadUnexpectedException();
1149 <                    }
1150 <                }
1151 <            }).start();
1152 <            Thread.sleep(LONG_DELAY_MS);
1153 <            assertTrue(q.isEmpty());
1154 <        } catch (Exception ex) {
1155 <            this.unexpectedException();
1156 <        }
982 >        awaitTermination(t);
983 >        checkEmpty(q);
984      }
985  
986 <    /*
986 >    /**
987       * tryTransfer waits for any elements previously in to be removed
988       * before transfering to a poll or take
989       */
990 <    public void testTryTransfer6() {
991 <        final LinkedTransferQueue q = new LinkedTransferQueue();
992 <        q.offer(new Integer(four));
993 <        new Thread(new Runnable() {
994 <
995 <            public void run() {
996 <                try {
997 <                    threadAssertTrue(q.tryTransfer(new Integer(five), LONG_DELAY_MS, TimeUnit.MILLISECONDS));
998 <                    threadAssertTrue(q.isEmpty());
999 <                } catch (InterruptedException ex) {
1000 <                    threadUnexpectedException();
1001 <                }
1002 <            }
1003 <        }).start();
1004 <        try {
1005 <            Thread.sleep(SHORT_DELAY_MS);
1006 <            assertEquals(2, q.size());
1007 <            assertEquals(new Integer(four), q.poll());
1008 <            assertEquals(new Integer(five), q.poll());
1182 <            assertTrue(q.isEmpty());
1183 <        } catch (Exception ex) {
1184 <            this.unexpectedException();
1185 <        }
990 >    public void testTryTransfer7() throws InterruptedException {
991 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
992 >        assertTrue(q.offer(four));
993 >
994 >        Thread t = newStartedThread(new CheckedRunnable() {
995 >            public void realRun() throws InterruptedException {
996 >                long startTime = System.nanoTime();
997 >                assertTrue(q.tryTransfer(five, LONG_DELAY_MS, MILLISECONDS));
998 >                assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
999 >                checkEmpty(q);
1000 >            }});
1001 >
1002 >        while (q.size() != 2)
1003 >            Thread.yield();
1004 >        mustEqual(2, q.size());
1005 >        assertSame(four, q.poll());
1006 >        assertSame(five, q.poll());
1007 >        checkEmpty(q);
1008 >        awaitTermination(t);
1009      }
1010  
1011 <    /*
1012 <     * tryTransfer attempts to enqueue into the q and fails returning false not
1013 <     * enqueueing and the successing poll is null
1014 <     */
1015 <    public void testTryTransfer7() {
1016 <        final LinkedTransferQueue q = new LinkedTransferQueue();
1017 <        q.offer(new Integer(four));
1018 <        new Thread(new Runnable() {
1019 <
1020 <            public void run() {
1021 <                try {
1022 <                    threadAssertFalse(q.tryTransfer(new Integer(five), SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
1023 <                    threadAssertTrue(q.isEmpty());
1024 <                } catch (InterruptedException ex) {
1025 <                    threadUnexpectedException();
1203 <                }
1204 <            }
1205 <        }).start();
1206 <        try {
1207 <            assertEquals(1, q.size());
1208 <            assertEquals(new Integer(four), q.poll());
1209 <            Thread.sleep(MEDIUM_DELAY_MS);
1210 <            assertNull(q.poll());
1211 <        } catch (Exception ex) {
1212 <            this.unexpectedException();
1213 <        }
1011 >    /**
1012 >     * tryTransfer attempts to enqueue into the queue and fails
1013 >     * returning false not enqueueing and the successive poll is null
1014 >     */
1015 >    public void testTryTransfer8() throws InterruptedException {
1016 >        final LinkedTransferQueue<Item> q = new LinkedTransferQueue<Item>();
1017 >        assertTrue(q.offer(four));
1018 >        mustEqual(1, q.size());
1019 >        long startTime = System.nanoTime();
1020 >        assertFalse(q.tryTransfer(five, timeoutMillis(), MILLISECONDS));
1021 >        assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
1022 >        mustEqual(1, q.size());
1023 >        assertSame(four, q.poll());
1024 >        assertNull(q.poll());
1025 >        checkEmpty(q);
1026      }
1027  
1028 <    private LinkedTransferQueue populatedQueue(
1029 <            int n) {
1030 <        LinkedTransferQueue q = new LinkedTransferQueue();
1031 <        assertTrue(q.isEmpty());
1032 <        int remainingCapacity = q.remainingCapacity();
1033 <        for (int i = 0; i <
1034 <                n; i++) {
1223 <            assertTrue(q.offer(i));
1028 >    private LinkedTransferQueue<Item> populatedQueue(int n) {
1029 >        LinkedTransferQueue<Item> q = new LinkedTransferQueue<>();
1030 >        checkEmpty(q);
1031 >        for (int i = 0; i < n; i++) {
1032 >            mustEqual(i, q.size());
1033 >            mustOffer(q, i);
1034 >            mustEqual(Integer.MAX_VALUE, q.remainingCapacity());
1035          }
1225
1036          assertFalse(q.isEmpty());
1227        assertEquals(remainingCapacity, q.remainingCapacity());
1228        assertEquals(n, q.size());
1037          return q;
1038      }
1039  
1040 <    private static class ConsumerObserver {
1041 <
1042 <        private int waitingConsumers;
1043 <
1044 <        private ConsumerObserver() {
1045 <        }
1046 <
1047 <        private void setWaitingConsumer(int i) {
1048 <            this.waitingConsumers = i;
1049 <        }
1050 <
1051 <        private int getWaitingConsumers() {
1244 <            return waitingConsumers;
1040 >    /**
1041 >     * remove(null), contains(null) always return false
1042 >     */
1043 >    public void testNeverContainsNull() {
1044 >        Collection<?>[] qs = {
1045 >            new LinkedTransferQueue<Object>(),
1046 >            populatedQueue(2),
1047 >        };
1048 >
1049 >        for (Collection<?> q : qs) {
1050 >            assertFalse(q.contains(null));
1051 >            assertFalse(q.remove(null));
1052          }
1053      }
1054   }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines