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.4 by dl, Sun Sep 14 20:42:40 2003 UTC vs.
Revision 1.57 by jsr166, Fri Feb 27 21:43:18 2015 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines