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

Comparing jsr166/src/test/tck/ReentrantLockTest.java (file contents):
Revision 1.12 by dl, Sat Dec 27 19:26:43 2003 UTC vs.
Revision 1.67 by jsr166, Fri Sep 29 22:31:55 2017 UTC

# Line 1 | Line 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
5 < * Other contributors include Andrew Wright, Jeffrey Hayes,
6 < * Pat Fisher, Mike Judd.
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.concurrent.locks.*;
11 < import java.util.concurrent.*;
12 < import java.util.*;
13 < 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.HashSet;
15 + import java.util.concurrent.CountDownLatch;
16 + import java.util.concurrent.CyclicBarrier;
17 + import java.util.concurrent.ThreadLocalRandom;
18 + import java.util.concurrent.locks.Condition;
19 + import java.util.concurrent.locks.ReentrantLock;
20 +
21 + import junit.framework.AssertionFailedError;
22 + import junit.framework.Test;
23 + import junit.framework.TestSuite;
24 +
25 + @SuppressWarnings("WaitNotInLoop") // we implement spurious-wakeup freedom
26   public class ReentrantLockTest extends JSR166TestCase {
27      public static void main(String[] args) {
28 <        junit.textui.TestRunner.run (suite());  
28 >        main(suite(), args);
29      }
30      public static Test suite() {
31 <        return new TestSuite(ReentrantLockTest.class);
31 >        return new TestSuite(ReentrantLockTest.class);
32      }
33  
34      /**
35 <     * A runnable calling lockInterruptibly
35 >     * A checked runnable calling lockInterruptibly
36       */
37 <    class InterruptibleLockRunnable implements Runnable {
37 >    class InterruptibleLockRunnable extends CheckedRunnable {
38          final ReentrantLock lock;
39 <        InterruptibleLockRunnable(ReentrantLock l) { lock = l; }
40 <        public void run() {
41 <            try {
31 <                lock.lockInterruptibly();
32 <            } catch(InterruptedException success){}
39 >        InterruptibleLockRunnable(ReentrantLock lock) { this.lock = lock; }
40 >        public void realRun() throws InterruptedException {
41 >            lock.lockInterruptibly();
42          }
43      }
44  
36
45      /**
46 <     * A runnable calling lockInterruptibly that expects to be
46 >     * A checked runnable calling lockInterruptibly that expects to be
47       * interrupted
48       */
49 <    class InterruptedLockRunnable implements Runnable {
49 >    class InterruptedLockRunnable extends CheckedInterruptedRunnable {
50          final ReentrantLock lock;
51 <        InterruptedLockRunnable(ReentrantLock l) { lock = l; }
52 <        public void run() {
53 <            try {
46 <                lock.lockInterruptibly();
47 <                threadShouldThrow();
48 <            } catch(InterruptedException success){}
51 >        InterruptedLockRunnable(ReentrantLock lock) { this.lock = lock; }
52 >        public void realRun() throws InterruptedException {
53 >            lock.lockInterruptibly();
54          }
55      }
56  
# Line 54 | Line 59 | public class ReentrantLockTest extends J
59       */
60      static class PublicReentrantLock extends ReentrantLock {
61          PublicReentrantLock() { super(); }
62 <        public Collection<Thread> getQueuedThreads() {
63 <            return super.getQueuedThreads();
62 >        PublicReentrantLock(boolean fair) { super(fair); }
63 >        public Thread getOwner() {
64 >            return super.getOwner();
65 >        }
66 >        public Collection<Thread> getQueuedThreads() {
67 >            return super.getQueuedThreads();
68 >        }
69 >        public Collection<Thread> getWaitingThreads(Condition c) {
70 >            return super.getWaitingThreads(c);
71          }
72 +    }
73  
74 +    /**
75 +     * Releases write lock, checking that it had a hold count of 1.
76 +     */
77 +    void releaseLock(PublicReentrantLock lock) {
78 +        assertLockedByMoi(lock);
79 +        lock.unlock();
80 +        assertFalse(lock.isHeldByCurrentThread());
81 +        assertNotLocked(lock);
82      }
83  
84      /**
85 <     * Constructor sets given fairness
85 >     * Spin-waits until lock.hasQueuedThread(t) becomes true.
86       */
87 <    public void testConstructor() {
88 <        ReentrantLock rl = new ReentrantLock();
89 <        assertFalse(rl.isFair());
90 <        ReentrantLock r2 = new ReentrantLock(true);
91 <        assertTrue(r2.isFair());
87 >    void waitForQueuedThread(PublicReentrantLock lock, Thread t) {
88 >        long startTime = System.nanoTime();
89 >        while (!lock.hasQueuedThread(t)) {
90 >            if (millisElapsedSince(startTime) > LONG_DELAY_MS)
91 >                throw new AssertionFailedError("timed out");
92 >            Thread.yield();
93 >        }
94 >        assertTrue(t.isAlive());
95 >        assertNotSame(t, lock.getOwner());
96      }
97  
98      /**
99 <     * locking an unlocked lock succeeds
99 >     * Checks that lock is not locked.
100       */
101 <    public void testLock() {
102 <        ReentrantLock rl = new ReentrantLock();
103 <        rl.lock();
104 <        assertTrue(rl.isLocked());
105 <        rl.unlock();
101 >    void assertNotLocked(PublicReentrantLock lock) {
102 >        assertFalse(lock.isLocked());
103 >        assertFalse(lock.isHeldByCurrentThread());
104 >        assertNull(lock.getOwner());
105 >        assertEquals(0, lock.getHoldCount());
106      }
107  
108      /**
109 <     * locking an unlocked fair lock succeeds
109 >     * Checks that lock is locked by the given thread.
110       */
111 <    public void testFairLock() {
112 <        ReentrantLock rl = new ReentrantLock(true);
113 <        rl.lock();
114 <        assertTrue(rl.isLocked());
115 <        rl.unlock();
111 >    void assertLockedBy(PublicReentrantLock lock, Thread t) {
112 >        assertTrue(lock.isLocked());
113 >        assertSame(t, lock.getOwner());
114 >        assertEquals(t == Thread.currentThread(),
115 >                     lock.isHeldByCurrentThread());
116 >        assertEquals(t == Thread.currentThread(),
117 >                     lock.getHoldCount() > 0);
118      }
119  
120      /**
121 <     * Unlocking an unlocked lock throws IllegalMonitorStateException
121 >     * Checks that lock is locked by the current thread.
122       */
123 <    public void testUnlock_IllegalMonitorStateException() {
124 <        ReentrantLock rl = new ReentrantLock();
125 <        try {
99 <            rl.unlock();
100 <            shouldThrow();
123 >    void assertLockedByMoi(PublicReentrantLock lock) {
124 >        assertLockedBy(lock, Thread.currentThread());
125 >    }
126  
127 <        } catch(IllegalMonitorStateException success){}
127 >    /**
128 >     * Checks that condition c has no waiters.
129 >     */
130 >    void assertHasNoWaiters(PublicReentrantLock lock, Condition c) {
131 >        assertHasWaiters(lock, c, new Thread[] {});
132      }
133  
134      /**
135 <     * trylock on an unlocked lock succeeds
135 >     * Checks that condition c has exactly the given waiter threads.
136       */
137 <    public void testTryLock() {
138 <        ReentrantLock rl = new ReentrantLock();
139 <        assertTrue(rl.tryLock());
140 <        assertTrue(rl.isLocked());
141 <        rl.unlock();
137 >    void assertHasWaiters(PublicReentrantLock lock, Condition c,
138 >                          Thread... threads) {
139 >        lock.lock();
140 >        assertEquals(threads.length > 0, lock.hasWaiters(c));
141 >        assertEquals(threads.length, lock.getWaitQueueLength(c));
142 >        assertEquals(threads.length == 0, lock.getWaitingThreads(c).isEmpty());
143 >        assertEquals(threads.length, lock.getWaitingThreads(c).size());
144 >        assertEquals(new HashSet<Thread>(lock.getWaitingThreads(c)),
145 >                     new HashSet<Thread>(Arrays.asList(threads)));
146 >        lock.unlock();
147      }
148  
149 +    enum AwaitMethod { await, awaitTimed, awaitNanos, awaitUntil }
150 +
151 +    static AwaitMethod randomAwaitMethod() {
152 +        AwaitMethod[] awaitMethods = AwaitMethod.values();
153 +        return awaitMethods[ThreadLocalRandom.current().nextInt(awaitMethods.length)];
154 +    }
155  
156      /**
157 <     * getQueueLength reports number of waiting threads
157 >     * Awaits condition "indefinitely" using the specified AwaitMethod.
158       */
159 <    public void testGetQueueLength() {
160 <        final ReentrantLock lock = new ReentrantLock();
161 <        Thread t1 = new Thread(new InterruptedLockRunnable(lock));
162 <        Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
163 <        try {
164 <            assertEquals(0, lock.getQueueLength());
165 <            lock.lock();
166 <            t1.start();
167 <            Thread.sleep(SHORT_DELAY_MS);
168 <            assertEquals(1, lock.getQueueLength());
169 <            t2.start();
170 <            Thread.sleep(SHORT_DELAY_MS);
171 <            assertEquals(2, lock.getQueueLength());
172 <            t1.interrupt();
173 <            Thread.sleep(SHORT_DELAY_MS);
174 <            assertEquals(1, lock.getQueueLength());
175 <            lock.unlock();
176 <            Thread.sleep(SHORT_DELAY_MS);
177 <            assertEquals(0, lock.getQueueLength());
178 <            t1.join();
179 <            t2.join();
140 <        } catch(Exception e){
141 <            unexpectedException();
159 >    void await(Condition c, AwaitMethod awaitMethod)
160 >            throws InterruptedException {
161 >        long timeoutMillis = 2 * LONG_DELAY_MS;
162 >        switch (awaitMethod) {
163 >        case await:
164 >            c.await();
165 >            break;
166 >        case awaitTimed:
167 >            assertTrue(c.await(timeoutMillis, MILLISECONDS));
168 >            break;
169 >        case awaitNanos:
170 >            long timeoutNanos = MILLISECONDS.toNanos(timeoutMillis);
171 >            long nanosRemaining = c.awaitNanos(timeoutNanos);
172 >            assertTrue(nanosRemaining > timeoutNanos / 2);
173 >            assertTrue(nanosRemaining <= timeoutNanos);
174 >            break;
175 >        case awaitUntil:
176 >            assertTrue(c.awaitUntil(delayedDate(timeoutMillis)));
177 >            break;
178 >        default:
179 >            throw new AssertionError();
180          }
181 <    }
181 >    }
182  
183      /**
184 <     * getQueuedThreads includes waiting threads
184 >     * Constructor sets given fairness, and is in unlocked state
185 >     */
186 >    public void testConstructor() {
187 >        PublicReentrantLock lock;
188 >
189 >        lock = new PublicReentrantLock();
190 >        assertFalse(lock.isFair());
191 >        assertNotLocked(lock);
192 >
193 >        lock = new PublicReentrantLock(true);
194 >        assertTrue(lock.isFair());
195 >        assertNotLocked(lock);
196 >
197 >        lock = new PublicReentrantLock(false);
198 >        assertFalse(lock.isFair());
199 >        assertNotLocked(lock);
200 >    }
201 >
202 >    /**
203 >     * locking an unlocked lock succeeds
204       */
205 <    public void testGetQueuedThreads() {
206 <        final PublicReentrantLock lock = new PublicReentrantLock();
207 <        Thread t1 = new Thread(new InterruptedLockRunnable(lock));
208 <        Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
205 >    public void testLock()      { testLock(false); }
206 >    public void testLock_fair() { testLock(true); }
207 >    public void testLock(boolean fair) {
208 >        PublicReentrantLock lock = new PublicReentrantLock(fair);
209 >        lock.lock();
210 >        assertLockedByMoi(lock);
211 >        releaseLock(lock);
212 >    }
213 >
214 >    /**
215 >     * Unlocking an unlocked lock throws IllegalMonitorStateException
216 >     */
217 >    public void testUnlock_IMSE()      { testUnlock_IMSE(false); }
218 >    public void testUnlock_IMSE_fair() { testUnlock_IMSE(true); }
219 >    public void testUnlock_IMSE(boolean fair) {
220 >        final ReentrantLock lock = new ReentrantLock(fair);
221          try {
153            assertTrue(lock.getQueuedThreads().isEmpty());
154            lock.lock();
155            assertTrue(lock.getQueuedThreads().isEmpty());
156            t1.start();
157            Thread.sleep(SHORT_DELAY_MS);
158            assertTrue(lock.getQueuedThreads().contains(t1));
159            t2.start();
160            Thread.sleep(SHORT_DELAY_MS);
161            assertTrue(lock.getQueuedThreads().contains(t1));
162            assertTrue(lock.getQueuedThreads().contains(t2));
163            t1.interrupt();
164            Thread.sleep(SHORT_DELAY_MS);
165            assertFalse(lock.getQueuedThreads().contains(t1));
166            assertTrue(lock.getQueuedThreads().contains(t2));
222              lock.unlock();
223 <            Thread.sleep(SHORT_DELAY_MS);
224 <            assertTrue(lock.getQueuedThreads().isEmpty());
225 <            t1.join();
171 <            t2.join();
172 <        } catch(Exception e){
173 <            unexpectedException();
174 <        }
175 <    }
176 <
223 >            shouldThrow();
224 >        } catch (IllegalMonitorStateException success) {}
225 >    }
226  
227      /**
228 <     * timed trylock is interruptible.
228 >     * tryLock on an unlocked lock succeeds
229       */
230 <    public void testInterruptedException2() {
231 <        final ReentrantLock lock = new ReentrantLock();
232 <        lock.lock();
233 <        Thread t = new Thread(new Runnable() {
234 <                public void run() {
235 <                    try {
236 <                        lock.tryLock(MEDIUM_DELAY_MS,TimeUnit.MILLISECONDS);
237 <                        threadShouldThrow();
238 <                    } catch(InterruptedException success){}
239 <                }
191 <            });
192 <        try {
193 <            t.start();
194 <            t.interrupt();
195 <        } catch(Exception e){
196 <            unexpectedException();
197 <        }
230 >    public void testTryLock()      { testTryLock(false); }
231 >    public void testTryLock_fair() { testTryLock(true); }
232 >    public void testTryLock(boolean fair) {
233 >        PublicReentrantLock lock = new PublicReentrantLock(fair);
234 >        assertTrue(lock.tryLock());
235 >        assertLockedByMoi(lock);
236 >        assertTrue(lock.tryLock());
237 >        assertLockedByMoi(lock);
238 >        lock.unlock();
239 >        releaseLock(lock);
240      }
241  
242 +    /**
243 +     * hasQueuedThreads reports whether there are waiting threads
244 +     */
245 +    public void testHasQueuedThreads()      { testHasQueuedThreads(false); }
246 +    public void testHasQueuedThreads_fair() { testHasQueuedThreads(true); }
247 +    public void testHasQueuedThreads(boolean fair) {
248 +        final PublicReentrantLock lock = new PublicReentrantLock(fair);
249 +        Thread t1 = new Thread(new InterruptedLockRunnable(lock));
250 +        Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
251 +        assertFalse(lock.hasQueuedThreads());
252 +        lock.lock();
253 +        assertFalse(lock.hasQueuedThreads());
254 +        t1.start();
255 +        waitForQueuedThread(lock, t1);
256 +        assertTrue(lock.hasQueuedThreads());
257 +        t2.start();
258 +        waitForQueuedThread(lock, t2);
259 +        assertTrue(lock.hasQueuedThreads());
260 +        t1.interrupt();
261 +        awaitTermination(t1);
262 +        assertTrue(lock.hasQueuedThreads());
263 +        lock.unlock();
264 +        awaitTermination(t2);
265 +        assertFalse(lock.hasQueuedThreads());
266 +    }
267  
268      /**
269 <     * Trylock on a locked lock fails
269 >     * getQueueLength reports number of waiting threads
270       */
271 <    public void testTryLockWhenLocked() {
272 <        final ReentrantLock lock = new ReentrantLock();
273 <        lock.lock();
274 <        Thread t = new Thread(new Runnable() {
275 <                public void run() {
276 <                    threadAssertFalse(lock.tryLock());
277 <                }
278 <            });
271 >    public void testGetQueueLength()      { testGetQueueLength(false); }
272 >    public void testGetQueueLength_fair() { testGetQueueLength(true); }
273 >    public void testGetQueueLength(boolean fair) {
274 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
275 >        Thread t1 = new Thread(new InterruptedLockRunnable(lock));
276 >        Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
277 >        assertEquals(0, lock.getQueueLength());
278 >        lock.lock();
279 >        t1.start();
280 >        waitForQueuedThread(lock, t1);
281 >        assertEquals(1, lock.getQueueLength());
282 >        t2.start();
283 >        waitForQueuedThread(lock, t2);
284 >        assertEquals(2, lock.getQueueLength());
285 >        t1.interrupt();
286 >        awaitTermination(t1);
287 >        assertEquals(1, lock.getQueueLength());
288 >        lock.unlock();
289 >        awaitTermination(t2);
290 >        assertEquals(0, lock.getQueueLength());
291 >    }
292 >
293 >    /**
294 >     * hasQueuedThread(null) throws NPE
295 >     */
296 >    public void testHasQueuedThreadNPE()      { testHasQueuedThreadNPE(false); }
297 >    public void testHasQueuedThreadNPE_fair() { testHasQueuedThreadNPE(true); }
298 >    public void testHasQueuedThreadNPE(boolean fair) {
299 >        final ReentrantLock lock = new ReentrantLock(fair);
300          try {
301 <            t.start();
302 <            t.join();
303 <            lock.unlock();
304 <        } catch(Exception e){
217 <            unexpectedException();
218 <        }
219 <    }
301 >            lock.hasQueuedThread(null);
302 >            shouldThrow();
303 >        } catch (NullPointerException success) {}
304 >    }
305  
306      /**
307 <     * Timed trylock on a locked lock times out
307 >     * hasQueuedThread reports whether a thread is queued
308       */
309 <    public void testTryLock_Timeout() {
310 <        final ReentrantLock lock = new ReentrantLock();
311 <        lock.lock();
312 <        Thread t = new Thread(new Runnable() {
313 <                public void run() {
314 <                    try {
315 <                        threadAssertFalse(lock.tryLock(1, TimeUnit.MILLISECONDS));
316 <                    } catch (Exception ex) {
317 <                        threadUnexpectedException();
318 <                    }
319 <                }
320 <            });
321 <        try {
322 <            t.start();
323 <            t.join();
324 <            lock.unlock();
325 <        } catch(Exception e){
326 <            unexpectedException();
327 <        }
328 <    }
329 <    
309 >    public void testHasQueuedThread()      { testHasQueuedThread(false); }
310 >    public void testHasQueuedThread_fair() { testHasQueuedThread(true); }
311 >    public void testHasQueuedThread(boolean fair) {
312 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
313 >        Thread t1 = new Thread(new InterruptedLockRunnable(lock));
314 >        Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
315 >        assertFalse(lock.hasQueuedThread(t1));
316 >        assertFalse(lock.hasQueuedThread(t2));
317 >        lock.lock();
318 >        t1.start();
319 >        waitForQueuedThread(lock, t1);
320 >        assertTrue(lock.hasQueuedThread(t1));
321 >        assertFalse(lock.hasQueuedThread(t2));
322 >        t2.start();
323 >        waitForQueuedThread(lock, t2);
324 >        assertTrue(lock.hasQueuedThread(t1));
325 >        assertTrue(lock.hasQueuedThread(t2));
326 >        t1.interrupt();
327 >        awaitTermination(t1);
328 >        assertFalse(lock.hasQueuedThread(t1));
329 >        assertTrue(lock.hasQueuedThread(t2));
330 >        lock.unlock();
331 >        awaitTermination(t2);
332 >        assertFalse(lock.hasQueuedThread(t1));
333 >        assertFalse(lock.hasQueuedThread(t2));
334 >    }
335 >
336      /**
337 <     * getHoldCount returns number of recursive holds
337 >     * getQueuedThreads includes waiting threads
338       */
339 <    public void testGetHoldCount() {
340 <        ReentrantLock lock = new ReentrantLock();
341 <        for(int i = 1; i <= SIZE; i++) {
342 <            lock.lock();
343 <            assertEquals(i,lock.getHoldCount());
344 <        }
345 <        for(int i = SIZE; i > 0; i--) {
346 <            lock.unlock();
347 <            assertEquals(i-1,lock.getHoldCount());
348 <        }
339 >    public void testGetQueuedThreads()      { testGetQueuedThreads(false); }
340 >    public void testGetQueuedThreads_fair() { testGetQueuedThreads(true); }
341 >    public void testGetQueuedThreads(boolean fair) {
342 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
343 >        Thread t1 = new Thread(new InterruptedLockRunnable(lock));
344 >        Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
345 >        assertTrue(lock.getQueuedThreads().isEmpty());
346 >        lock.lock();
347 >        assertTrue(lock.getQueuedThreads().isEmpty());
348 >        t1.start();
349 >        waitForQueuedThread(lock, t1);
350 >        assertEquals(1, lock.getQueuedThreads().size());
351 >        assertTrue(lock.getQueuedThreads().contains(t1));
352 >        t2.start();
353 >        waitForQueuedThread(lock, t2);
354 >        assertEquals(2, lock.getQueuedThreads().size());
355 >        assertTrue(lock.getQueuedThreads().contains(t1));
356 >        assertTrue(lock.getQueuedThreads().contains(t2));
357 >        t1.interrupt();
358 >        awaitTermination(t1);
359 >        assertFalse(lock.getQueuedThreads().contains(t1));
360 >        assertTrue(lock.getQueuedThreads().contains(t2));
361 >        assertEquals(1, lock.getQueuedThreads().size());
362 >        lock.unlock();
363 >        awaitTermination(t2);
364 >        assertTrue(lock.getQueuedThreads().isEmpty());
365 >    }
366 >
367 >    /**
368 >     * timed tryLock is interruptible
369 >     */
370 >    public void testTryLock_Interruptible()      { testTryLock_Interruptible(false); }
371 >    public void testTryLock_Interruptible_fair() { testTryLock_Interruptible(true); }
372 >    public void testTryLock_Interruptible(boolean fair) {
373 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
374 >        lock.lock();
375 >        Thread t = newStartedThread(new CheckedInterruptedRunnable() {
376 >            public void realRun() throws InterruptedException {
377 >                lock.tryLock(2 * LONG_DELAY_MS, MILLISECONDS);
378 >            }});
379 >
380 >        waitForQueuedThread(lock, t);
381 >        t.interrupt();
382 >        awaitTermination(t);
383 >        releaseLock(lock);
384 >    }
385 >
386 >    /**
387 >     * tryLock on a locked lock fails
388 >     */
389 >    public void testTryLockWhenLocked()      { testTryLockWhenLocked(false); }
390 >    public void testTryLockWhenLocked_fair() { testTryLockWhenLocked(true); }
391 >    public void testTryLockWhenLocked(boolean fair) {
392 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
393 >        lock.lock();
394 >        Thread t = newStartedThread(new CheckedRunnable() {
395 >            public void realRun() {
396 >                assertFalse(lock.tryLock());
397 >            }});
398 >
399 >        awaitTermination(t);
400 >        releaseLock(lock);
401 >    }
402 >
403 >    /**
404 >     * Timed tryLock on a locked lock times out
405 >     */
406 >    public void testTryLock_Timeout()      { testTryLock_Timeout(false); }
407 >    public void testTryLock_Timeout_fair() { testTryLock_Timeout(true); }
408 >    public void testTryLock_Timeout(boolean fair) {
409 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
410 >        final long timeoutMillis = timeoutMillis();
411 >        lock.lock();
412 >        Thread t = newStartedThread(new CheckedRunnable() {
413 >            public void realRun() throws InterruptedException {
414 >                long startTime = System.nanoTime();
415 >                assertFalse(lock.tryLock(timeoutMillis, MILLISECONDS));
416 >                assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
417 >            }});
418 >
419 >        awaitTermination(t);
420 >        releaseLock(lock);
421      }
422 <    
260 <  
422 >
423      /**
424 <     * isLocked is true when locked and false when not
424 >     * getHoldCount returns number of recursive holds
425       */
426 <    public void testIsLocked() {
427 <        final ReentrantLock lock = new ReentrantLock();
428 <        lock.lock();
429 <        assertTrue(lock.isLocked());
430 <        lock.unlock();
431 <        assertFalse(lock.isLocked());
432 <        Thread t = new Thread(new Runnable() {
433 <                public void run() {
434 <                    lock.lock();
435 <                    try {
436 <                        Thread.sleep(SMALL_DELAY_MS);
275 <                    }
276 <                    catch(Exception e) {
277 <                        threadUnexpectedException();
278 <                    }
279 <                    lock.unlock();
280 <                }
281 <            });
282 <        try {
283 <            t.start();
284 <            Thread.sleep(SHORT_DELAY_MS);
285 <            assertTrue(lock.isLocked());
286 <            t.join();
287 <            assertFalse(lock.isLocked());
288 <        } catch(Exception e){
289 <            unexpectedException();
426 >    public void testGetHoldCount()      { testGetHoldCount(false); }
427 >    public void testGetHoldCount_fair() { testGetHoldCount(true); }
428 >    public void testGetHoldCount(boolean fair) {
429 >        final ReentrantLock lock = new ReentrantLock(fair);
430 >        for (int i = 1; i <= SIZE; i++) {
431 >            lock.lock();
432 >            assertEquals(i, lock.getHoldCount());
433 >        }
434 >        for (int i = SIZE; i > 0; i--) {
435 >            lock.unlock();
436 >            assertEquals(i - 1, lock.getHoldCount());
437          }
438      }
439  
293
440      /**
441 <     * lockInterruptibly is interruptible.
441 >     * isLocked is true when locked and false when not
442       */
443 <    public void testLockInterruptibly1() {
444 <        final ReentrantLock lock = new ReentrantLock();
445 <        lock.lock();
446 <        Thread t = new Thread(new InterruptedLockRunnable(lock));
443 >    public void testIsLocked()      { testIsLocked(false); }
444 >    public void testIsLocked_fair() { testIsLocked(true); }
445 >    public void testIsLocked(boolean fair) {
446 >        final ReentrantLock lock = new ReentrantLock(fair);
447          try {
448 <            t.start();
449 <            t.interrupt();
448 >            assertFalse(lock.isLocked());
449 >            lock.lock();
450 >            assertTrue(lock.isLocked());
451 >            lock.lock();
452 >            assertTrue(lock.isLocked());
453              lock.unlock();
454 <            t.join();
455 <        } catch(Exception e){
456 <            unexpectedException();
457 <        }
458 <    }
454 >            assertTrue(lock.isLocked());
455 >            lock.unlock();
456 >            assertFalse(lock.isLocked());
457 >            final CyclicBarrier barrier = new CyclicBarrier(2);
458 >            Thread t = newStartedThread(new CheckedRunnable() {
459 >                    public void realRun() throws Exception {
460 >                        lock.lock();
461 >                        assertTrue(lock.isLocked());
462 >                        barrier.await();
463 >                        barrier.await();
464 >                        lock.unlock();
465 >                    }});
466 >
467 >            barrier.await();
468 >            assertTrue(lock.isLocked());
469 >            barrier.await();
470 >            awaitTermination(t);
471 >            assertFalse(lock.isLocked());
472 >        } catch (Exception fail) { threadUnexpectedException(fail); }
473 >    }
474  
475      /**
476       * lockInterruptibly succeeds when unlocked, else is interruptible
477       */
478 <    public void testLockInterruptibly2() {
479 <        final ReentrantLock lock = new ReentrantLock();
480 <        try {
481 <            lock.lockInterruptibly();
318 <        } catch(Exception e) {
319 <            unexpectedException();
320 <        }
321 <        Thread t = new Thread(new InterruptedLockRunnable(lock));
478 >    public void testLockInterruptibly()      { testLockInterruptibly(false); }
479 >    public void testLockInterruptibly_fair() { testLockInterruptibly(true); }
480 >    public void testLockInterruptibly(boolean fair) {
481 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
482          try {
483 <            t.start();
484 <            t.interrupt();
485 <            assertTrue(lock.isLocked());
486 <            assertTrue(lock.isHeldByCurrentThread());
487 <            t.join();
488 <        } catch(Exception e){
489 <            unexpectedException();
490 <        }
483 >            lock.lockInterruptibly();
484 >        } catch (InterruptedException fail) { threadUnexpectedException(fail); }
485 >        assertLockedByMoi(lock);
486 >        Thread t = newStartedThread(new InterruptedLockRunnable(lock));
487 >        waitForQueuedThread(lock, t);
488 >        t.interrupt();
489 >        assertTrue(lock.isLocked());
490 >        assertTrue(lock.isHeldByCurrentThread());
491 >        awaitTermination(t);
492 >        releaseLock(lock);
493      }
494  
495      /**
496       * Calling await without holding lock throws IllegalMonitorStateException
497       */
498 <    public void testAwait_IllegalMonitor() {
499 <        final ReentrantLock lock = new ReentrantLock();
498 >    public void testAwait_IMSE()      { testAwait_IMSE(false); }
499 >    public void testAwait_IMSE_fair() { testAwait_IMSE(true); }
500 >    public void testAwait_IMSE(boolean fair) {
501 >        final ReentrantLock lock = new ReentrantLock(fair);
502          final Condition c = lock.newCondition();
503 <        try {
504 <            c.await();
505 <            shouldThrow();
506 <        }
507 <        catch (IllegalMonitorStateException success) {
508 <        }
509 <        catch (Exception ex) {
510 <            unexpectedException();
503 >        for (AwaitMethod awaitMethod : AwaitMethod.values()) {
504 >            long startTime = System.nanoTime();
505 >            try {
506 >                await(c, awaitMethod);
507 >                shouldThrow();
508 >            } catch (IllegalMonitorStateException success) {
509 >            } catch (InterruptedException e) { threadUnexpectedException(e); }
510 >            assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
511          }
512      }
513  
514      /**
515       * Calling signal without holding lock throws IllegalMonitorStateException
516       */
517 <    public void testSignal_IllegalMonitor() {
518 <        final ReentrantLock lock = new ReentrantLock();
517 >    public void testSignal_IMSE()      { testSignal_IMSE(false); }
518 >    public void testSignal_IMSE_fair() { testSignal_IMSE(true); }
519 >    public void testSignal_IMSE(boolean fair) {
520 >        final ReentrantLock lock = new ReentrantLock(fair);
521          final Condition c = lock.newCondition();
522          try {
523              c.signal();
524              shouldThrow();
525 <        }
360 <        catch (IllegalMonitorStateException success) {
361 <        }
362 <        catch (Exception ex) {
363 <            unexpectedException();
364 <        }
525 >        } catch (IllegalMonitorStateException success) {}
526      }
527  
528      /**
529       * awaitNanos without a signal times out
530       */
531 <    public void testAwaitNanos_Timeout() {
532 <        final ReentrantLock lock = new ReentrantLock();
531 >    public void testAwaitNanos_Timeout()      { testAwaitNanos_Timeout(false); }
532 >    public void testAwaitNanos_Timeout_fair() { testAwaitNanos_Timeout(true); }
533 >    public void testAwaitNanos_Timeout(boolean fair) {
534 >        final ReentrantLock lock = new ReentrantLock(fair);
535          final Condition c = lock.newCondition();
536 +        final long timeoutMillis = timeoutMillis();
537 +        final long timeoutNanos = MILLISECONDS.toNanos(timeoutMillis);
538 +        lock.lock();
539 +        final long startTime = System.nanoTime();
540          try {
541 <            lock.lock();
542 <            long t = c.awaitNanos(100);
543 <            assertTrue(t <= 0);
544 <            lock.unlock();
545 <        }
379 <        catch (Exception ex) {
380 <            unexpectedException();
381 <        }
541 >            long nanosRemaining = c.awaitNanos(timeoutNanos);
542 >            assertTrue(nanosRemaining <= 0);
543 >        } catch (InterruptedException fail) { threadUnexpectedException(fail); }
544 >        assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
545 >        lock.unlock();
546      }
547  
548      /**
549 <     *  timed await without a signal times out
549 >     * timed await without a signal times out
550       */
551 <    public void testAwait_Timeout() {
552 <        final ReentrantLock lock = new ReentrantLock();
551 >    public void testAwait_Timeout()      { testAwait_Timeout(false); }
552 >    public void testAwait_Timeout_fair() { testAwait_Timeout(true); }
553 >    public void testAwait_Timeout(boolean fair) {
554 >        final ReentrantLock lock = new ReentrantLock(fair);
555          final Condition c = lock.newCondition();
556 <        try {
557 <            lock.lock();
558 <            assertFalse(c.await(SHORT_DELAY_MS, TimeUnit.MILLISECONDS));
559 <            lock.unlock();
560 <        }
561 <        catch (Exception ex) {
562 <            unexpectedException();
563 <        }
556 >        final long timeoutMillis = timeoutMillis();
557 >        lock.lock();
558 >        final long startTime = System.nanoTime();
559 >        try {
560 >            assertFalse(c.await(timeoutMillis, MILLISECONDS));
561 >        } catch (InterruptedException fail) { threadUnexpectedException(fail); }
562 >        assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
563 >        lock.unlock();
564      }
565  
566      /**
567       * awaitUntil without a signal times out
568       */
569 <    public void testAwaitUntil_Timeout() {
570 <        final ReentrantLock lock = new ReentrantLock();
569 >    public void testAwaitUntil_Timeout()      { testAwaitUntil_Timeout(false); }
570 >    public void testAwaitUntil_Timeout_fair() { testAwaitUntil_Timeout(true); }
571 >    public void testAwaitUntil_Timeout(boolean fair) {
572 >        final ReentrantLock lock = new ReentrantLock(fair);
573          final Condition c = lock.newCondition();
574 <        try {
575 <            lock.lock();
576 <            java.util.Date d = new java.util.Date();
577 <            assertFalse(c.awaitUntil(new java.util.Date(d.getTime() + 10)));
578 <            lock.unlock();
579 <        }
580 <        catch (Exception ex) {
581 <            unexpectedException();
582 <        }
574 >        lock.lock();
575 >        // We shouldn't assume that nanoTime and currentTimeMillis
576 >        // use the same time source, so don't use nanoTime here.
577 >        final java.util.Date delayedDate = delayedDate(timeoutMillis());
578 >        try {
579 >            assertFalse(c.awaitUntil(delayedDate));
580 >        } catch (InterruptedException fail) { threadUnexpectedException(fail); }
581 >        assertTrue(new java.util.Date().getTime() >= delayedDate.getTime());
582 >        lock.unlock();
583      }
584  
585      /**
586       * await returns when signalled
587       */
588 <    public void testAwait() {
589 <        final ReentrantLock lock = new ReentrantLock();
590 <        final AbstractQueuedSynchronizer.ConditionObject c = lock.newCondition();
591 <        Thread t = new Thread(new Runnable() {
592 <                public void run() {
593 <                    try {
594 <                        lock.lock();
595 <                        c.await();
596 <                        lock.unlock();
597 <                    }
598 <                    catch(InterruptedException e) {
599 <                        threadUnexpectedException();
600 <                    }
601 <                }
602 <            });
588 >    public void testAwait()      { testAwait(false); }
589 >    public void testAwait_fair() { testAwait(true); }
590 >    public void testAwait(boolean fair) {
591 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
592 >        final Condition c = lock.newCondition();
593 >        final CountDownLatch locked = new CountDownLatch(1);
594 >        Thread t = newStartedThread(new CheckedRunnable() {
595 >            public void realRun() throws InterruptedException {
596 >                lock.lock();
597 >                locked.countDown();
598 >                c.await();
599 >                lock.unlock();
600 >            }});
601 >
602 >        await(locked);
603 >        lock.lock();
604 >        assertHasWaiters(lock, c, t);
605 >        c.signal();
606 >        assertHasNoWaiters(lock, c);
607 >        assertTrue(t.isAlive());
608 >        lock.unlock();
609 >        awaitTermination(t);
610 >    }
611  
612 +    /**
613 +     * hasWaiters throws NPE if null
614 +     */
615 +    public void testHasWaitersNPE()      { testHasWaitersNPE(false); }
616 +    public void testHasWaitersNPE_fair() { testHasWaitersNPE(true); }
617 +    public void testHasWaitersNPE(boolean fair) {
618 +        final ReentrantLock lock = new ReentrantLock(fair);
619          try {
620 <            t.start();
621 <            Thread.sleep(SHORT_DELAY_MS);
622 <            lock.lock();
440 <            c.signal();
441 <            lock.unlock();
442 <            t.join(SHORT_DELAY_MS);
443 <            assertFalse(t.isAlive());
444 <        }
445 <        catch (Exception ex) {
446 <            unexpectedException();
447 <        }
620 >            lock.hasWaiters(null);
621 >            shouldThrow();
622 >        } catch (NullPointerException success) {}
623      }
624  
625      /**
626 <     * hasWaiters returns true when a thread is waiting, else false
626 >     * getWaitQueueLength throws NPE if null
627       */
628 <    public void testHasWaiters() {
629 <        final ReentrantLock lock = new ReentrantLock();
630 <        final AbstractQueuedSynchronizer.ConditionObject c = lock.newCondition();
631 <        Thread t = new Thread(new Runnable() {
457 <                public void run() {
458 <                    try {
459 <                        lock.lock();
460 <                        threadAssertFalse(c.hasWaiters());
461 <                        threadAssertEquals(0, c.getWaitQueueLength());
462 <                        c.await();
463 <                        lock.unlock();
464 <                    }
465 <                    catch(InterruptedException e) {
466 <                        threadUnexpectedException();
467 <                    }
468 <                }
469 <            });
470 <
628 >    public void testGetWaitQueueLengthNPE()      { testGetWaitQueueLengthNPE(false); }
629 >    public void testGetWaitQueueLengthNPE_fair() { testGetWaitQueueLengthNPE(true); }
630 >    public void testGetWaitQueueLengthNPE(boolean fair) {
631 >        final ReentrantLock lock = new ReentrantLock(fair);
632          try {
633 <            t.start();
634 <            Thread.sleep(SHORT_DELAY_MS);
635 <            lock.lock();
475 <            assertTrue(c.hasWaiters());
476 <            assertEquals(1, c.getWaitQueueLength());
477 <            c.signal();
478 <            lock.unlock();
479 <            Thread.sleep(SHORT_DELAY_MS);
480 <            lock.lock();
481 <            assertFalse(c.hasWaiters());
482 <            assertEquals(0, c.getWaitQueueLength());
483 <            lock.unlock();
484 <            t.join(SHORT_DELAY_MS);
485 <            assertFalse(t.isAlive());
486 <        }
487 <        catch (Exception ex) {
488 <            unexpectedException();
489 <        }
633 >            lock.getWaitQueueLength(null);
634 >            shouldThrow();
635 >        } catch (NullPointerException success) {}
636      }
637  
638      /**
639 <     * getWaitQueueLength returns number of waiting threads
639 >     * getWaitingThreads throws NPE if null
640       */
641 <    public void testGetWaitQueueLength() {
642 <        final ReentrantLock lock = new ReentrantLock();
643 <        final AbstractQueuedSynchronizer.ConditionObject c = lock.newCondition();
644 <        Thread t1 = new Thread(new Runnable() {
499 <                public void run() {
500 <                    try {
501 <                        lock.lock();
502 <                        threadAssertFalse(c.hasWaiters());
503 <                        threadAssertEquals(0, c.getWaitQueueLength());
504 <                        c.await();
505 <                        lock.unlock();
506 <                    }
507 <                    catch(InterruptedException e) {
508 <                        threadUnexpectedException();
509 <                    }
510 <                }
511 <            });
512 <
513 <        Thread t2 = new Thread(new Runnable() {
514 <                public void run() {
515 <                    try {
516 <                        lock.lock();
517 <                        threadAssertTrue(c.hasWaiters());
518 <                        threadAssertEquals(1, c.getWaitQueueLength());
519 <                        c.await();
520 <                        lock.unlock();
521 <                    }
522 <                    catch(InterruptedException e) {
523 <                        threadUnexpectedException();
524 <                    }
525 <                }
526 <            });
527 <
641 >    public void testGetWaitingThreadsNPE()      { testGetWaitingThreadsNPE(false); }
642 >    public void testGetWaitingThreadsNPE_fair() { testGetWaitingThreadsNPE(true); }
643 >    public void testGetWaitingThreadsNPE(boolean fair) {
644 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
645          try {
646 <            t1.start();
647 <            Thread.sleep(SHORT_DELAY_MS);
648 <            t2.start();
532 <            Thread.sleep(SHORT_DELAY_MS);
533 <            lock.lock();
534 <            assertTrue(c.hasWaiters());
535 <            assertEquals(2, c.getWaitQueueLength());
536 <            c.signalAll();
537 <            lock.unlock();
538 <            Thread.sleep(SHORT_DELAY_MS);
539 <            lock.lock();
540 <            assertFalse(c.hasWaiters());
541 <            assertEquals(0, c.getWaitQueueLength());
542 <            lock.unlock();
543 <            t1.join(SHORT_DELAY_MS);
544 <            t2.join(SHORT_DELAY_MS);
545 <            assertFalse(t1.isAlive());
546 <            assertFalse(t2.isAlive());
547 <        }
548 <        catch (Exception ex) {
549 <            unexpectedException();
550 <        }
646 >            lock.getWaitingThreads(null);
647 >            shouldThrow();
648 >        } catch (NullPointerException success) {}
649      }
650  
651      /**
652 <     * awaitUninterruptibly doesn't abort on interrupt
652 >     * hasWaiters throws IllegalArgumentException if not owned
653       */
654 <    public void testAwaitUninterruptibly() {
655 <        final ReentrantLock lock = new ReentrantLock();
654 >    public void testHasWaitersIAE()      { testHasWaitersIAE(false); }
655 >    public void testHasWaitersIAE_fair() { testHasWaitersIAE(true); }
656 >    public void testHasWaitersIAE(boolean fair) {
657 >        final ReentrantLock lock = new ReentrantLock(fair);
658          final Condition c = lock.newCondition();
659 <        Thread t = new Thread(new Runnable() {
660 <                public void run() {
661 <                    lock.lock();
662 <                    c.awaitUninterruptibly();
663 <                    lock.unlock();
664 <                }
565 <            });
659 >        final ReentrantLock lock2 = new ReentrantLock(fair);
660 >        try {
661 >            lock2.hasWaiters(c);
662 >            shouldThrow();
663 >        } catch (IllegalArgumentException success) {}
664 >    }
665  
666 +    /**
667 +     * hasWaiters throws IllegalMonitorStateException if not locked
668 +     */
669 +    public void testHasWaitersIMSE()      { testHasWaitersIMSE(false); }
670 +    public void testHasWaitersIMSE_fair() { testHasWaitersIMSE(true); }
671 +    public void testHasWaitersIMSE(boolean fair) {
672 +        final ReentrantLock lock = new ReentrantLock(fair);
673 +        final Condition c = lock.newCondition();
674          try {
675 <            t.start();
676 <            Thread.sleep(SHORT_DELAY_MS);
677 <            t.interrupt();
571 <            lock.lock();
572 <            c.signal();
573 <            lock.unlock();
574 <            assert(t.isInterrupted());
575 <            t.join(SHORT_DELAY_MS);
576 <            assertFalse(t.isAlive());
577 <        }
578 <        catch (Exception ex) {
579 <            unexpectedException();
580 <        }
675 >            lock.hasWaiters(c);
676 >            shouldThrow();
677 >        } catch (IllegalMonitorStateException success) {}
678      }
679  
680      /**
681 <     * await is interruptible
681 >     * getWaitQueueLength throws IllegalArgumentException if not owned
682       */
683 <    public void testAwait_Interrupt() {
684 <        final ReentrantLock lock = new ReentrantLock();
683 >    public void testGetWaitQueueLengthIAE()      { testGetWaitQueueLengthIAE(false); }
684 >    public void testGetWaitQueueLengthIAE_fair() { testGetWaitQueueLengthIAE(true); }
685 >    public void testGetWaitQueueLengthIAE(boolean fair) {
686 >        final ReentrantLock lock = new ReentrantLock(fair);
687          final Condition c = lock.newCondition();
688 <        Thread t = new Thread(new Runnable() {
689 <                public void run() {
690 <                    try {
691 <                        lock.lock();
692 <                        c.await();
693 <                        lock.unlock();
595 <                        threadShouldThrow();
596 <                    }
597 <                    catch(InterruptedException success) {
598 <                    }
599 <                }
600 <            });
688 >        final ReentrantLock lock2 = new ReentrantLock(fair);
689 >        try {
690 >            lock2.getWaitQueueLength(c);
691 >            shouldThrow();
692 >        } catch (IllegalArgumentException success) {}
693 >    }
694  
695 +    /**
696 +     * getWaitQueueLength throws IllegalMonitorStateException if not locked
697 +     */
698 +    public void testGetWaitQueueLengthIMSE()      { testGetWaitQueueLengthIMSE(false); }
699 +    public void testGetWaitQueueLengthIMSE_fair() { testGetWaitQueueLengthIMSE(true); }
700 +    public void testGetWaitQueueLengthIMSE(boolean fair) {
701 +        final ReentrantLock lock = new ReentrantLock(fair);
702 +        final Condition c = lock.newCondition();
703          try {
704 <            t.start();
705 <            Thread.sleep(SHORT_DELAY_MS);
706 <            t.interrupt();
606 <            t.join(SHORT_DELAY_MS);
607 <            assertFalse(t.isAlive());
608 <        }
609 <        catch (Exception ex) {
610 <            unexpectedException();
611 <        }
704 >            lock.getWaitQueueLength(c);
705 >            shouldThrow();
706 >        } catch (IllegalMonitorStateException success) {}
707      }
708  
709      /**
710 <     * awaitNanos is interruptible
710 >     * getWaitingThreads throws IllegalArgumentException if not owned
711       */
712 <    public void testAwaitNanos_Interrupt() {
713 <        final ReentrantLock lock = new ReentrantLock();
712 >    public void testGetWaitingThreadsIAE()      { testGetWaitingThreadsIAE(false); }
713 >    public void testGetWaitingThreadsIAE_fair() { testGetWaitingThreadsIAE(true); }
714 >    public void testGetWaitingThreadsIAE(boolean fair) {
715 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
716          final Condition c = lock.newCondition();
717 <        Thread t = new Thread(new Runnable() {
718 <                public void run() {
719 <                    try {
720 <                        lock.lock();
721 <                        c.awaitNanos(SHORT_DELAY_MS * 2 * 1000000);
722 <                        lock.unlock();
626 <                        threadShouldThrow();
627 <                    }
628 <                    catch(InterruptedException success) {
629 <                    }
630 <                }
631 <            });
717 >        final PublicReentrantLock lock2 = new PublicReentrantLock(fair);
718 >        try {
719 >            lock2.getWaitingThreads(c);
720 >            shouldThrow();
721 >        } catch (IllegalArgumentException success) {}
722 >    }
723  
724 +    /**
725 +     * getWaitingThreads throws IllegalMonitorStateException if not locked
726 +     */
727 +    public void testGetWaitingThreadsIMSE()      { testGetWaitingThreadsIMSE(false); }
728 +    public void testGetWaitingThreadsIMSE_fair() { testGetWaitingThreadsIMSE(true); }
729 +    public void testGetWaitingThreadsIMSE(boolean fair) {
730 +        final PublicReentrantLock lock = new PublicReentrantLock(fair);
731 +        final Condition c = lock.newCondition();
732          try {
733 <            t.start();
734 <            Thread.sleep(SHORT_DELAY_MS);
735 <            t.interrupt();
637 <            t.join(SHORT_DELAY_MS);
638 <            assertFalse(t.isAlive());
639 <        }
640 <        catch (Exception ex) {
641 <            unexpectedException();
642 <        }
733 >            lock.getWaitingThreads(c);
734 >            shouldThrow();
735 >        } catch (IllegalMonitorStateException success) {}
736      }
737  
738      /**
739 <     * awaitUntil is interruptible
739 >     * hasWaiters returns true when a thread is waiting, else false
740       */
741 <    public void testAwaitUntil_Interrupt() {
742 <        final ReentrantLock lock = new ReentrantLock();
741 >    public void testHasWaiters()      { testHasWaiters(false); }
742 >    public void testHasWaiters_fair() { testHasWaiters(true); }
743 >    public void testHasWaiters(boolean fair) {
744 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
745          final Condition c = lock.newCondition();
746 <        Thread t = new Thread(new Runnable() {
747 <                public void run() {
748 <                    try {
749 <                        lock.lock();
750 <                        java.util.Date d = new java.util.Date();
751 <                        c.awaitUntil(new java.util.Date(d.getTime() + 10000));
752 <                        lock.unlock();
753 <                        threadShouldThrow();
754 <                    }
755 <                    catch(InterruptedException success) {
756 <                    }
757 <                }
758 <            });
759 <
760 <        try {
761 <            t.start();
762 <            Thread.sleep(SHORT_DELAY_MS);
763 <            t.interrupt();
764 <            t.join(SHORT_DELAY_MS);
765 <            assertFalse(t.isAlive());
766 <        }
767 <        catch (Exception ex) {
768 <            unexpectedException();
769 <        }
746 >        final CountDownLatch pleaseSignal = new CountDownLatch(1);
747 >        Thread t = newStartedThread(new CheckedRunnable() {
748 >            public void realRun() throws InterruptedException {
749 >                lock.lock();
750 >                assertHasNoWaiters(lock, c);
751 >                assertFalse(lock.hasWaiters(c));
752 >                pleaseSignal.countDown();
753 >                c.await();
754 >                assertHasNoWaiters(lock, c);
755 >                assertFalse(lock.hasWaiters(c));
756 >                lock.unlock();
757 >            }});
758 >
759 >        await(pleaseSignal);
760 >        lock.lock();
761 >        assertHasWaiters(lock, c, t);
762 >        assertTrue(lock.hasWaiters(c));
763 >        c.signal();
764 >        assertHasNoWaiters(lock, c);
765 >        assertFalse(lock.hasWaiters(c));
766 >        lock.unlock();
767 >        awaitTermination(t);
768 >        assertHasNoWaiters(lock, c);
769 >    }
770 >
771 >    /**
772 >     * getWaitQueueLength returns number of waiting threads
773 >     */
774 >    public void testGetWaitQueueLength()      { testGetWaitQueueLength(false); }
775 >    public void testGetWaitQueueLength_fair() { testGetWaitQueueLength(true); }
776 >    public void testGetWaitQueueLength(boolean fair) {
777 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
778 >        final Condition c = lock.newCondition();
779 >        final CountDownLatch locked1 = new CountDownLatch(1);
780 >        final CountDownLatch locked2 = new CountDownLatch(1);
781 >        Thread t1 = new Thread(new CheckedRunnable() {
782 >            public void realRun() throws InterruptedException {
783 >                lock.lock();
784 >                assertFalse(lock.hasWaiters(c));
785 >                assertEquals(0, lock.getWaitQueueLength(c));
786 >                locked1.countDown();
787 >                c.await();
788 >                lock.unlock();
789 >            }});
790 >
791 >        Thread t2 = new Thread(new CheckedRunnable() {
792 >            public void realRun() throws InterruptedException {
793 >                lock.lock();
794 >                assertTrue(lock.hasWaiters(c));
795 >                assertEquals(1, lock.getWaitQueueLength(c));
796 >                locked2.countDown();
797 >                c.await();
798 >                lock.unlock();
799 >            }});
800 >
801 >        lock.lock();
802 >        assertEquals(0, lock.getWaitQueueLength(c));
803 >        lock.unlock();
804 >
805 >        t1.start();
806 >        await(locked1);
807 >
808 >        lock.lock();
809 >        assertHasWaiters(lock, c, t1);
810 >        assertEquals(1, lock.getWaitQueueLength(c));
811 >        lock.unlock();
812 >
813 >        t2.start();
814 >        await(locked2);
815 >
816 >        lock.lock();
817 >        assertHasWaiters(lock, c, t1, t2);
818 >        assertEquals(2, lock.getWaitQueueLength(c));
819 >        c.signalAll();
820 >        assertHasNoWaiters(lock, c);
821 >        lock.unlock();
822 >
823 >        awaitTermination(t1);
824 >        awaitTermination(t2);
825 >
826 >        assertHasNoWaiters(lock, c);
827 >    }
828 >
829 >    /**
830 >     * getWaitingThreads returns only and all waiting threads
831 >     */
832 >    public void testGetWaitingThreads()      { testGetWaitingThreads(false); }
833 >    public void testGetWaitingThreads_fair() { testGetWaitingThreads(true); }
834 >    public void testGetWaitingThreads(boolean fair) {
835 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
836 >        final Condition c = lock.newCondition();
837 >        final CountDownLatch locked1 = new CountDownLatch(1);
838 >        final CountDownLatch locked2 = new CountDownLatch(1);
839 >        Thread t1 = new Thread(new CheckedRunnable() {
840 >            public void realRun() throws InterruptedException {
841 >                lock.lock();
842 >                assertTrue(lock.getWaitingThreads(c).isEmpty());
843 >                locked1.countDown();
844 >                c.await();
845 >                lock.unlock();
846 >            }});
847 >
848 >        Thread t2 = new Thread(new CheckedRunnable() {
849 >            public void realRun() throws InterruptedException {
850 >                lock.lock();
851 >                assertFalse(lock.getWaitingThreads(c).isEmpty());
852 >                locked2.countDown();
853 >                c.await();
854 >                lock.unlock();
855 >            }});
856 >
857 >        lock.lock();
858 >        assertTrue(lock.getWaitingThreads(c).isEmpty());
859 >        lock.unlock();
860 >
861 >        t1.start();
862 >        await(locked1);
863 >
864 >        lock.lock();
865 >        assertHasWaiters(lock, c, t1);
866 >        assertTrue(lock.getWaitingThreads(c).contains(t1));
867 >        assertFalse(lock.getWaitingThreads(c).contains(t2));
868 >        assertEquals(1, lock.getWaitingThreads(c).size());
869 >        lock.unlock();
870 >
871 >        t2.start();
872 >        await(locked2);
873 >
874 >        lock.lock();
875 >        assertHasWaiters(lock, c, t1, t2);
876 >        assertTrue(lock.getWaitingThreads(c).contains(t1));
877 >        assertTrue(lock.getWaitingThreads(c).contains(t2));
878 >        assertEquals(2, lock.getWaitingThreads(c).size());
879 >        c.signalAll();
880 >        assertHasNoWaiters(lock, c);
881 >        lock.unlock();
882 >
883 >        awaitTermination(t1);
884 >        awaitTermination(t2);
885 >
886 >        assertHasNoWaiters(lock, c);
887 >    }
888 >
889 >    /**
890 >     * awaitUninterruptibly is uninterruptible
891 >     */
892 >    public void testAwaitUninterruptibly()      { testAwaitUninterruptibly(false); }
893 >    public void testAwaitUninterruptibly_fair() { testAwaitUninterruptibly(true); }
894 >    public void testAwaitUninterruptibly(boolean fair) {
895 >        final ReentrantLock lock = new ReentrantLock(fair);
896 >        final Condition condition = lock.newCondition();
897 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(2);
898 >
899 >        Thread t1 = newStartedThread(new CheckedRunnable() {
900 >            public void realRun() {
901 >                // Interrupt before awaitUninterruptibly
902 >                lock.lock();
903 >                pleaseInterrupt.countDown();
904 >                Thread.currentThread().interrupt();
905 >                condition.awaitUninterruptibly();
906 >                assertTrue(Thread.interrupted());
907 >                lock.unlock();
908 >            }});
909 >
910 >        Thread t2 = newStartedThread(new CheckedRunnable() {
911 >            public void realRun() {
912 >                // Interrupt during awaitUninterruptibly
913 >                lock.lock();
914 >                pleaseInterrupt.countDown();
915 >                condition.awaitUninterruptibly();
916 >                assertTrue(Thread.interrupted());
917 >                lock.unlock();
918 >            }});
919 >
920 >        await(pleaseInterrupt);
921 >        t2.interrupt();
922 >        lock.lock();
923 >        lock.unlock();
924 >        assertThreadBlocks(t1, Thread.State.WAITING);
925 >        assertThreadBlocks(t2, Thread.State.WAITING);
926 >
927 >        lock.lock();
928 >        condition.signalAll();
929 >        lock.unlock();
930 >
931 >        awaitTermination(t1);
932 >        awaitTermination(t2);
933 >    }
934 >
935 >    /**
936 >     * await/awaitNanos/awaitUntil is interruptible
937 >     */
938 >    public void testInterruptible_await()           { testInterruptible(false, AwaitMethod.await); }
939 >    public void testInterruptible_await_fair()      { testInterruptible(true,  AwaitMethod.await); }
940 >    public void testInterruptible_awaitTimed()      { testInterruptible(false, AwaitMethod.awaitTimed); }
941 >    public void testInterruptible_awaitTimed_fair() { testInterruptible(true,  AwaitMethod.awaitTimed); }
942 >    public void testInterruptible_awaitNanos()      { testInterruptible(false, AwaitMethod.awaitNanos); }
943 >    public void testInterruptible_awaitNanos_fair() { testInterruptible(true,  AwaitMethod.awaitNanos); }
944 >    public void testInterruptible_awaitUntil()      { testInterruptible(false, AwaitMethod.awaitUntil); }
945 >    public void testInterruptible_awaitUntil_fair() { testInterruptible(true,  AwaitMethod.awaitUntil); }
946 >    public void testInterruptible(boolean fair, final AwaitMethod awaitMethod) {
947 >        final PublicReentrantLock lock =
948 >            new PublicReentrantLock(fair);
949 >        final Condition c = lock.newCondition();
950 >        final CountDownLatch pleaseInterrupt = new CountDownLatch(1);
951 >        Thread t = newStartedThread(new CheckedInterruptedRunnable() {
952 >            public void realRun() throws InterruptedException {
953 >                lock.lock();
954 >                assertLockedByMoi(lock);
955 >                assertHasNoWaiters(lock, c);
956 >                pleaseInterrupt.countDown();
957 >                try {
958 >                    await(c, awaitMethod);
959 >                } finally {
960 >                    assertLockedByMoi(lock);
961 >                    assertHasNoWaiters(lock, c);
962 >                    lock.unlock();
963 >                    assertFalse(Thread.interrupted());
964 >                }
965 >            }});
966 >
967 >        await(pleaseInterrupt);
968 >        assertHasWaiters(lock, c, t);
969 >        t.interrupt();
970 >        awaitTermination(t);
971 >        assertNotLocked(lock);
972      }
973  
974      /**
975       * signalAll wakes up all threads
976       */
977 <    public void testSignalAll() {
978 <        final ReentrantLock lock = new ReentrantLock();
977 >    public void testSignalAll_await()           { testSignalAll(false, AwaitMethod.await); }
978 >    public void testSignalAll_await_fair()      { testSignalAll(true,  AwaitMethod.await); }
979 >    public void testSignalAll_awaitTimed()      { testSignalAll(false, AwaitMethod.awaitTimed); }
980 >    public void testSignalAll_awaitTimed_fair() { testSignalAll(true,  AwaitMethod.awaitTimed); }
981 >    public void testSignalAll_awaitNanos()      { testSignalAll(false, AwaitMethod.awaitNanos); }
982 >    public void testSignalAll_awaitNanos_fair() { testSignalAll(true,  AwaitMethod.awaitNanos); }
983 >    public void testSignalAll_awaitUntil()      { testSignalAll(false, AwaitMethod.awaitUntil); }
984 >    public void testSignalAll_awaitUntil_fair() { testSignalAll(true,  AwaitMethod.awaitUntil); }
985 >    public void testSignalAll(boolean fair, final AwaitMethod awaitMethod) {
986 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
987          final Condition c = lock.newCondition();
988 <        Thread t1 = new Thread(new Runnable() {
989 <                public void run() {
990 <                    try {
991 <                        lock.lock();
992 <                        c.await();
993 <                        lock.unlock();
994 <                    }
995 <                    catch(InterruptedException e) {
996 <                        threadUnexpectedException();
997 <                    }
998 <                }
999 <            });
1000 <
1001 <        Thread t2 = new Thread(new Runnable() {
1002 <                public void run() {
1003 <                    try {
1004 <                        lock.lock();
1005 <                        c.await();
1006 <                        lock.unlock();
1007 <                    }
1008 <                    catch(InterruptedException e) {
1009 <                        threadUnexpectedException();
705 <                    }
706 <                }
707 <            });
988 >        final CountDownLatch pleaseSignal = new CountDownLatch(2);
989 >        class Awaiter extends CheckedRunnable {
990 >            public void realRun() throws InterruptedException {
991 >                lock.lock();
992 >                pleaseSignal.countDown();
993 >                await(c, awaitMethod);
994 >                lock.unlock();
995 >            }
996 >        }
997 >
998 >        Thread t1 = newStartedThread(new Awaiter());
999 >        Thread t2 = newStartedThread(new Awaiter());
1000 >
1001 >        await(pleaseSignal);
1002 >        lock.lock();
1003 >        assertHasWaiters(lock, c, t1, t2);
1004 >        c.signalAll();
1005 >        assertHasNoWaiters(lock, c);
1006 >        lock.unlock();
1007 >        awaitTermination(t1);
1008 >        awaitTermination(t2);
1009 >    }
1010  
1011 <        try {
1012 <            t1.start();
1013 <            t2.start();
1014 <            Thread.sleep(SHORT_DELAY_MS);
1015 <            lock.lock();
1016 <            c.signalAll();
1017 <            lock.unlock();
1018 <            t1.join(SHORT_DELAY_MS);
1019 <            t2.join(SHORT_DELAY_MS);
1020 <            assertFalse(t1.isAlive());
1021 <            assertFalse(t2.isAlive());
1022 <        }
1023 <        catch (Exception ex) {
1024 <            unexpectedException();
1025 <        }
1011 >    /**
1012 >     * signal wakes up waiting threads in FIFO order
1013 >     */
1014 >    public void testSignalWakesFifo()      { testSignalWakesFifo(false); }
1015 >    public void testSignalWakesFifo_fair() { testSignalWakesFifo(true); }
1016 >    public void testSignalWakesFifo(boolean fair) {
1017 >        final PublicReentrantLock lock =
1018 >            new PublicReentrantLock(fair);
1019 >        final Condition c = lock.newCondition();
1020 >        final CountDownLatch locked1 = new CountDownLatch(1);
1021 >        final CountDownLatch locked2 = new CountDownLatch(1);
1022 >        Thread t1 = newStartedThread(new CheckedRunnable() {
1023 >            public void realRun() throws InterruptedException {
1024 >                lock.lock();
1025 >                locked1.countDown();
1026 >                c.await();
1027 >                lock.unlock();
1028 >            }});
1029 >
1030 >        await(locked1);
1031 >
1032 >        Thread t2 = newStartedThread(new CheckedRunnable() {
1033 >            public void realRun() throws InterruptedException {
1034 >                lock.lock();
1035 >                locked2.countDown();
1036 >                c.await();
1037 >                lock.unlock();
1038 >            }});
1039 >
1040 >        await(locked2);
1041 >
1042 >        lock.lock();
1043 >        assertHasWaiters(lock, c, t1, t2);
1044 >        assertFalse(lock.hasQueuedThreads());
1045 >        c.signal();
1046 >        assertHasWaiters(lock, c, t2);
1047 >        assertTrue(lock.hasQueuedThread(t1));
1048 >        assertFalse(lock.hasQueuedThread(t2));
1049 >        c.signal();
1050 >        assertHasNoWaiters(lock, c);
1051 >        assertTrue(lock.hasQueuedThread(t1));
1052 >        assertTrue(lock.hasQueuedThread(t2));
1053 >        lock.unlock();
1054 >        awaitTermination(t1);
1055 >        awaitTermination(t2);
1056 >    }
1057 >
1058 >    /**
1059 >     * await after multiple reentrant locking preserves lock count
1060 >     */
1061 >    public void testAwaitLockCount()      { testAwaitLockCount(false); }
1062 >    public void testAwaitLockCount_fair() { testAwaitLockCount(true); }
1063 >    public void testAwaitLockCount(boolean fair) {
1064 >        final PublicReentrantLock lock = new PublicReentrantLock(fair);
1065 >        final Condition c = lock.newCondition();
1066 >        final CountDownLatch pleaseSignal = new CountDownLatch(2);
1067 >        Thread t1 = newStartedThread(new CheckedRunnable() {
1068 >            public void realRun() throws InterruptedException {
1069 >                lock.lock();
1070 >                assertLockedByMoi(lock);
1071 >                assertEquals(1, lock.getHoldCount());
1072 >                pleaseSignal.countDown();
1073 >                c.await();
1074 >                assertLockedByMoi(lock);
1075 >                assertEquals(1, lock.getHoldCount());
1076 >                lock.unlock();
1077 >            }});
1078 >
1079 >        Thread t2 = newStartedThread(new CheckedRunnable() {
1080 >            public void realRun() throws InterruptedException {
1081 >                lock.lock();
1082 >                lock.lock();
1083 >                assertLockedByMoi(lock);
1084 >                assertEquals(2, lock.getHoldCount());
1085 >                pleaseSignal.countDown();
1086 >                c.await();
1087 >                assertLockedByMoi(lock);
1088 >                assertEquals(2, lock.getHoldCount());
1089 >                lock.unlock();
1090 >                lock.unlock();
1091 >            }});
1092 >
1093 >        await(pleaseSignal);
1094 >        lock.lock();
1095 >        assertHasWaiters(lock, c, t1, t2);
1096 >        assertEquals(1, lock.getHoldCount());
1097 >        c.signalAll();
1098 >        assertHasNoWaiters(lock, c);
1099 >        lock.unlock();
1100 >        awaitTermination(t1);
1101 >        awaitTermination(t2);
1102      }
1103  
1104      /**
1105       * A serialized lock deserializes as unlocked
1106       */
1107 <    public void testSerialization() {
1108 <        ReentrantLock l = new ReentrantLock();
1109 <        l.lock();
1110 <        l.unlock();
1111 <
1112 <        try {
1113 <            ByteArrayOutputStream bout = new ByteArrayOutputStream(10000);
1114 <            ObjectOutputStream out = new ObjectOutputStream(new BufferedOutputStream(bout));
1115 <            out.writeObject(l);
1116 <            out.close();
1117 <
1118 <            ByteArrayInputStream bin = new ByteArrayInputStream(bout.toByteArray());
1119 <            ObjectInputStream in = new ObjectInputStream(new BufferedInputStream(bin));
1120 <            ReentrantLock r = (ReentrantLock) in.readObject();
1121 <            r.lock();
1122 <            r.unlock();
1123 <        } catch(Exception e){
1124 <            e.printStackTrace();
1125 <            unexpectedException();
1107 >    public void testSerialization()      { testSerialization(false); }
1108 >    public void testSerialization_fair() { testSerialization(true); }
1109 >    public void testSerialization(boolean fair) {
1110 >        final ReentrantLock lock = new ReentrantLock(fair);
1111 >        lock.lock();
1112 >
1113 >        ReentrantLock clone = serialClone(lock);
1114 >        assertEquals(lock.isFair(), clone.isFair());
1115 >        assertTrue(lock.isLocked());
1116 >        assertFalse(clone.isLocked());
1117 >        assertEquals(1, lock.getHoldCount());
1118 >        assertEquals(0, clone.getHoldCount());
1119 >        clone.lock();
1120 >        clone.lock();
1121 >        assertTrue(clone.isLocked());
1122 >        assertEquals(2, clone.getHoldCount());
1123 >        assertEquals(1, lock.getHoldCount());
1124 >        clone.unlock();
1125 >        clone.unlock();
1126 >        assertTrue(lock.isLocked());
1127 >        assertFalse(clone.isLocked());
1128 >    }
1129 >
1130 >    /**
1131 >     * toString indicates current lock state
1132 >     */
1133 >    public void testToString()      { testToString(false); }
1134 >    public void testToString_fair() { testToString(true); }
1135 >    public void testToString(boolean fair) {
1136 >        final ReentrantLock lock = new ReentrantLock(fair);
1137 >        assertTrue(lock.toString().contains("Unlocked"));
1138 >        lock.lock();
1139 >        assertTrue(lock.toString().contains("Locked by"));
1140 >        lock.unlock();
1141 >        assertTrue(lock.toString().contains("Unlocked"));
1142 >    }
1143 >
1144 >    /**
1145 >     * Tests scenario for JDK-8187408
1146 >     * AbstractQueuedSynchronizer wait queue corrupted when thread awaits without holding the lock
1147 >     */
1148 >    public void testBug8187408() throws InterruptedException {
1149 >        final ThreadLocalRandom rnd = ThreadLocalRandom.current();
1150 >        final AwaitMethod awaitMethod = randomAwaitMethod();
1151 >        final int nThreads = rnd.nextInt(2, 10);
1152 >        final ReentrantLock lock = new ReentrantLock();
1153 >        final Condition cond = lock.newCondition();
1154 >        final CountDownLatch done = new CountDownLatch(nThreads);
1155 >        final ArrayList<Thread> threads = new ArrayList<>();
1156 >
1157 >        Runnable rogue = () -> {
1158 >            while (done.getCount() > 0) {
1159 >                try {
1160 >                    // call await without holding lock?!
1161 >                    await(cond, awaitMethod);
1162 >                    throw new AssertionError("should throw");
1163 >                }
1164 >                catch (IllegalMonitorStateException expected) {}
1165 >                catch (Throwable fail) { threadUnexpectedException(fail); }}};
1166 >        Thread rogueThread = new Thread(rogue, "rogue");
1167 >        threads.add(rogueThread);
1168 >        rogueThread.start();
1169 >
1170 >        Runnable waiter = () -> {
1171 >            lock.lock();
1172 >            try {
1173 >                done.countDown();
1174 >                cond.await();
1175 >            } catch (Throwable fail) {
1176 >                threadUnexpectedException(fail);
1177 >            } finally {
1178 >                lock.unlock();
1179 >            }};
1180 >        for (int i = 0; i < nThreads; i++) {
1181 >            Thread thread = new Thread(waiter, "waiter");
1182 >            threads.add(thread);
1183 >            thread.start();
1184 >        }
1185 >
1186 >        assertTrue(done.await(LONG_DELAY_MS, MILLISECONDS));
1187 >        lock.lock();
1188 >        try {
1189 >            assertEquals(nThreads, lock.getWaitQueueLength(cond));
1190 >        } finally {
1191 >            cond.signalAll();
1192 >            lock.unlock();
1193 >        }
1194 >        for (Thread thread : threads) {
1195 >            thread.join(LONG_DELAY_MS);
1196 >            assertFalse(thread.isAlive());
1197          }
1198      }
750
1199   }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines