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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines