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

Comparing jsr166/src/test/tck/StampedLockTest.java (file contents):
Revision 1.1 by jsr166, Fri Feb 1 19:07:36 2013 UTC vs.
Revision 1.44 by jsr166, Sun Sep 29 20:19:43 2019 UTC

# Line 3 | Line 3
3   * with assistance from members of JCP JSR-166 Expert Group and
4   * released to the public domain, as explained at
5   * http://creativecommons.org/publicdomain/zero/1.0/
6 * Other contributors include Andrew Wright, Jeffrey Hayes,
7 * Pat Fisher, Mike Judd.
6   */
7  
8 < import junit.framework.*;
8 > import static java.util.concurrent.TimeUnit.DAYS;
9 > import static java.util.concurrent.TimeUnit.MILLISECONDS;
10 >
11 > import static java.util.concurrent.locks.StampedLock.isLockStamp;
12 > import static java.util.concurrent.locks.StampedLock.isOptimisticReadStamp;
13 > import static java.util.concurrent.locks.StampedLock.isReadLockStamp;
14 > import static java.util.concurrent.locks.StampedLock.isWriteLockStamp;
15 >
16 > import java.util.ArrayList;
17 > import java.util.List;
18 > import java.util.concurrent.Callable;
19 > import java.util.concurrent.CompletableFuture;
20 > import java.util.concurrent.CountDownLatch;
21 > import java.util.concurrent.Future;
22 > import java.util.concurrent.ThreadLocalRandom;
23 > import java.util.concurrent.TimeUnit;
24   import java.util.concurrent.atomic.AtomicBoolean;
12 import java.util.concurrent.locks.Condition;
25   import java.util.concurrent.locks.Lock;
26 < import java.util.concurrent.locks.ReentrantReadWriteLock;
27 < import java.util.concurrent.CountDownLatch;
28 < import static java.util.concurrent.TimeUnit.MILLISECONDS;
29 < import java.util.*;
26 > import java.util.concurrent.locks.StampedLock;
27 > import java.util.function.BiConsumer;
28 > import java.util.function.Consumer;
29 > import java.util.function.Function;
30 >
31 > import junit.framework.Test;
32 > import junit.framework.TestSuite;
33  
34   public class StampedLockTest extends JSR166TestCase {
35      public static void main(String[] args) {
36 <        junit.textui.TestRunner.run(suite());
36 >        main(suite(), args);
37      }
38      public static Test suite() {
39          return new TestSuite(StampedLockTest.class);
40      }
41  
42 <    // XXXX Just a skeleton implementation for now.
43 <    public void testTODO() { fail("StampedLockTest needs help"); }
44 <    
45 < //     /**
46 < //      * A runnable calling lockInterruptibly
47 < //      */
48 < //     class InterruptibleLockRunnable extends CheckedRunnable {
49 < //         final ReentrantReadWriteLock lock;
50 < //         InterruptibleLockRunnable(ReentrantReadWriteLock l) { lock = l; }
51 < //         public void realRun() throws InterruptedException {
52 < //             lock.writeLock().lockInterruptibly();
53 < //         }
54 < //     }
55 <
56 < //     /**
57 < //      * A runnable calling lockInterruptibly that expects to be
58 < //      * interrupted
59 < //      */
60 < //     class InterruptedLockRunnable extends CheckedInterruptedRunnable {
61 < //         final ReentrantReadWriteLock lock;
62 < //         InterruptedLockRunnable(ReentrantReadWriteLock l) { lock = l; }
63 < //         public void realRun() throws InterruptedException {
64 < //             lock.writeLock().lockInterruptibly();
65 < //         }
66 < //     }
67 <
68 < //     /**
69 < //      * Subclass to expose protected methods
70 < //      */
71 < //     static class PublicReentrantReadWriteLock extends ReentrantReadWriteLock {
72 < //         PublicReentrantReadWriteLock() { super(); }
73 < //         PublicReentrantReadWriteLock(boolean fair) { super(fair); }
74 < //         public Thread getOwner() {
75 < //             return super.getOwner();
76 < //         }
77 < //         public Collection<Thread> getQueuedThreads() {
78 < //             return super.getQueuedThreads();
79 < //         }
80 < //         public Collection<Thread> getWaitingThreads(Condition c) {
81 < //             return super.getWaitingThreads(c);
82 < //         }
83 < //     }
84 <
85 < //     /**
86 < //      * Releases write lock, checking that it had a hold count of 1.
87 < //      */
88 < //     void releaseWriteLock(PublicReentrantReadWriteLock lock) {
89 < //         ReentrantReadWriteLock.WriteLock writeLock = lock.writeLock();
90 < //         assertWriteLockedByMoi(lock);
91 < //         assertEquals(1, lock.getWriteHoldCount());
92 < //         writeLock.unlock();
93 < //         assertNotWriteLocked(lock);
94 < //     }
95 <
96 < //     /**
97 < //      * Spin-waits until lock.hasQueuedThread(t) becomes true.
98 < //      */
99 < //     void waitForQueuedThread(PublicReentrantReadWriteLock lock, Thread t) {
100 < //         long startTime = System.nanoTime();
101 < //         while (!lock.hasQueuedThread(t)) {
102 < //             if (millisElapsedSince(startTime) > LONG_DELAY_MS)
103 < //                 throw new AssertionFailedError("timed out");
104 < //             Thread.yield();
105 < //         }
106 < //         assertTrue(t.isAlive());
107 < //         assertTrue(lock.getOwner() != t);
108 < //     }
109 <
110 < //     /**
111 < //      * Checks that lock is not write-locked.
112 < //      */
113 < //     void assertNotWriteLocked(PublicReentrantReadWriteLock lock) {
114 < //         assertFalse(lock.isWriteLocked());
115 < //         assertFalse(lock.isWriteLockedByCurrentThread());
116 < //         assertFalse(lock.writeLock().isHeldByCurrentThread());
117 < //         assertEquals(0, lock.getWriteHoldCount());
118 < //         assertEquals(0, lock.writeLock().getHoldCount());
119 < //         assertNull(lock.getOwner());
120 < //     }
121 <
122 < //     /**
123 < //      * Checks that lock is write-locked by the given thread.
124 < //      */
125 < //     void assertWriteLockedBy(PublicReentrantReadWriteLock lock, Thread t) {
126 < //         assertTrue(lock.isWriteLocked());
127 < //         assertSame(t, lock.getOwner());
128 < //         assertEquals(t == Thread.currentThread(),
129 < //                      lock.isWriteLockedByCurrentThread());
130 < //         assertEquals(t == Thread.currentThread(),
131 < //                      lock.writeLock().isHeldByCurrentThread());
132 < //         assertEquals(t == Thread.currentThread(),
133 < //                      lock.getWriteHoldCount() > 0);
134 < //         assertEquals(t == Thread.currentThread(),
135 < //                      lock.writeLock().getHoldCount() > 0);
136 < //         assertEquals(0, lock.getReadLockCount());
137 < //     }
138 <
139 < //     /**
140 < //      * Checks that lock is write-locked by the current thread.
141 < //      */
142 < //     void assertWriteLockedByMoi(PublicReentrantReadWriteLock lock) {
143 < //         assertWriteLockedBy(lock, Thread.currentThread());
144 < //     }
145 <
146 < //     /**
147 < //      * Checks that condition c has no waiters.
148 < //      */
149 < //     void assertHasNoWaiters(PublicReentrantReadWriteLock lock, Condition c) {
150 < //         assertHasWaiters(lock, c, new Thread[] {});
151 < //     }
152 <
153 < //     /**
154 < //      * Checks that condition c has exactly the given waiter threads.
155 < //      */
156 < //     void assertHasWaiters(PublicReentrantReadWriteLock lock, Condition c,
157 < //                           Thread... threads) {
158 < //         lock.writeLock().lock();
159 < //         assertEquals(threads.length > 0, lock.hasWaiters(c));
160 < //         assertEquals(threads.length, lock.getWaitQueueLength(c));
161 < //         assertEquals(threads.length == 0, lock.getWaitingThreads(c).isEmpty());
162 < //         assertEquals(threads.length, lock.getWaitingThreads(c).size());
163 < //         assertEquals(new HashSet<Thread>(lock.getWaitingThreads(c)),
164 < //                      new HashSet<Thread>(Arrays.asList(threads)));
165 < //         lock.writeLock().unlock();
166 < //     }
167 <
168 < //     enum AwaitMethod { await, awaitTimed, awaitNanos, awaitUntil };
169 <
170 < //     /**
171 < //      * Awaits condition using the specified AwaitMethod.
172 < //      */
173 < //     void await(Condition c, AwaitMethod awaitMethod)
174 < //             throws InterruptedException {
175 < //         switch (awaitMethod) {
176 < //         case await:
177 < //             c.await();
178 < //             break;
179 < //         case awaitTimed:
180 < //             assertTrue(c.await(2 * LONG_DELAY_MS, MILLISECONDS));
181 < //             break;
182 < //         case awaitNanos:
183 < //             long nanosRemaining = c.awaitNanos(MILLISECONDS.toNanos(2 * LONG_DELAY_MS));
184 < //             assertTrue(nanosRemaining > 0);
185 < //             break;
186 < //         case awaitUntil:
187 < //             java.util.Date d = new java.util.Date();
188 < //             assertTrue(c.awaitUntil(new java.util.Date(d.getTime() + 2 * LONG_DELAY_MS)));
189 < //             break;
190 < //         }
191 < //     }
192 <
193 < //     /**
194 < //      * Constructor sets given fairness, and is in unlocked state
195 < //      */
196 < //     public void testConstructor() {
197 < //         PublicReentrantReadWriteLock lock;
198 <
199 < //         lock = new PublicReentrantReadWriteLock();
200 < //         assertFalse(lock.isFair());
201 < //         assertNotWriteLocked(lock);
202 < //         assertEquals(0, lock.getReadLockCount());
203 <
204 < //         lock = new PublicReentrantReadWriteLock(true);
205 < //         assertTrue(lock.isFair());
206 < //         assertNotWriteLocked(lock);
207 < //         assertEquals(0, lock.getReadLockCount());
208 <
209 < //         lock = new PublicReentrantReadWriteLock(false);
210 < //         assertFalse(lock.isFair());
211 < //         assertNotWriteLocked(lock);
212 < //         assertEquals(0, lock.getReadLockCount());
213 < //     }
214 <
215 < //     /**
216 < //      * write-locking and read-locking an unlocked lock succeed
217 < //      */
218 < //     public void testLock()      { testLock(false); }
219 < //     public void testLock_fair() { testLock(true); }
220 < //     public void testLock(boolean fair) {
221 < //         PublicReentrantReadWriteLock lock =
222 < //             new PublicReentrantReadWriteLock(fair);
223 < //         assertNotWriteLocked(lock);
224 < //         lock.writeLock().lock();
225 < //         assertWriteLockedByMoi(lock);
226 < //         lock.writeLock().unlock();
227 < //         assertNotWriteLocked(lock);
228 < //         assertEquals(0, lock.getReadLockCount());
229 < //         lock.readLock().lock();
230 < //         assertNotWriteLocked(lock);
231 < //         assertEquals(1, lock.getReadLockCount());
232 < //         lock.readLock().unlock();
233 < //         assertNotWriteLocked(lock);
234 < //         assertEquals(0, lock.getReadLockCount());
235 < //     }
236 <
237 < //     /**
238 < //      * getWriteHoldCount returns number of recursive holds
239 < //      */
240 < //     public void testGetWriteHoldCount()      { testGetWriteHoldCount(false); }
241 < //     public void testGetWriteHoldCount_fair() { testGetWriteHoldCount(true); }
242 < //     public void testGetWriteHoldCount(boolean fair) {
243 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
244 < //         for (int i = 1; i <= SIZE; i++) {
245 < //             lock.writeLock().lock();
246 < //             assertEquals(i,lock.getWriteHoldCount());
247 < //         }
248 < //         for (int i = SIZE; i > 0; i--) {
249 < //             lock.writeLock().unlock();
250 < //             assertEquals(i-1,lock.getWriteHoldCount());
251 < //         }
252 < //     }
253 <
254 < //     /**
255 < //      * writelock.getHoldCount returns number of recursive holds
256 < //      */
257 < //     public void testGetHoldCount()      { testGetHoldCount(false); }
258 < //     public void testGetHoldCount_fair() { testGetHoldCount(true); }
259 < //     public void testGetHoldCount(boolean fair) {
260 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
261 < //         for (int i = 1; i <= SIZE; i++) {
262 < //             lock.writeLock().lock();
263 < //             assertEquals(i,lock.writeLock().getHoldCount());
264 < //         }
265 < //         for (int i = SIZE; i > 0; i--) {
266 < //             lock.writeLock().unlock();
267 < //             assertEquals(i-1,lock.writeLock().getHoldCount());
268 < //         }
269 < //     }
270 <
271 < //     /**
272 < //      * getReadHoldCount returns number of recursive holds
273 < //      */
274 < //     public void testGetReadHoldCount()      { testGetReadHoldCount(false); }
275 < //     public void testGetReadHoldCount_fair() { testGetReadHoldCount(true); }
276 < //     public void testGetReadHoldCount(boolean fair) {
277 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
278 < //         for (int i = 1; i <= SIZE; i++) {
279 < //             lock.readLock().lock();
280 < //             assertEquals(i,lock.getReadHoldCount());
281 < //         }
282 < //         for (int i = SIZE; i > 0; i--) {
283 < //             lock.readLock().unlock();
284 < //             assertEquals(i-1,lock.getReadHoldCount());
285 < //         }
286 < //     }
287 <
288 < //     /**
289 < //      * write-unlocking an unlocked lock throws IllegalMonitorStateException
290 < //      */
291 < //     public void testWriteUnlock_IMSE()      { testWriteUnlock_IMSE(false); }
292 < //     public void testWriteUnlock_IMSE_fair() { testWriteUnlock_IMSE(true); }
293 < //     public void testWriteUnlock_IMSE(boolean fair) {
294 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
295 < //         try {
296 < //             lock.writeLock().unlock();
297 < //             shouldThrow();
298 < //         } catch (IllegalMonitorStateException success) {}
299 < //     }
300 <
301 < //     /**
302 < //      * read-unlocking an unlocked lock throws IllegalMonitorStateException
303 < //      */
304 < //     public void testReadUnlock_IMSE()      { testReadUnlock_IMSE(false); }
305 < //     public void testReadUnlock_IMSE_fair() { testReadUnlock_IMSE(true); }
306 < //     public void testReadUnlock_IMSE(boolean fair) {
307 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
308 < //         try {
309 < //             lock.readLock().unlock();
310 < //             shouldThrow();
311 < //         } catch (IllegalMonitorStateException success) {}
312 < //     }
313 <
314 < //     /**
315 < //      * write-lockInterruptibly is interruptible
316 < //      */
317 < //     public void testWriteLockInterruptibly_Interruptible()      { testWriteLockInterruptibly_Interruptible(false); }
318 < //     public void testWriteLockInterruptibly_Interruptible_fair() { testWriteLockInterruptibly_Interruptible(true); }
319 < //     public void testWriteLockInterruptibly_Interruptible(boolean fair) {
320 < //         final PublicReentrantReadWriteLock lock =
321 < //             new PublicReentrantReadWriteLock(fair);
322 < //         lock.writeLock().lock();
323 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
324 < //             public void realRun() throws InterruptedException {
325 < //                 lock.writeLock().lockInterruptibly();
326 < //             }});
327 <
328 < //         waitForQueuedThread(lock, t);
329 < //         t.interrupt();
330 < //         awaitTermination(t);
331 < //         releaseWriteLock(lock);
332 < //     }
333 <
334 < //     /**
335 < //      * timed write-tryLock is interruptible
336 < //      */
337 < //     public void testWriteTryLock_Interruptible()      { testWriteTryLock_Interruptible(false); }
338 < //     public void testWriteTryLock_Interruptible_fair() { testWriteTryLock_Interruptible(true); }
339 < //     public void testWriteTryLock_Interruptible(boolean fair) {
340 < //         final PublicReentrantReadWriteLock lock =
341 < //             new PublicReentrantReadWriteLock(fair);
342 < //         lock.writeLock().lock();
343 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
344 < //             public void realRun() throws InterruptedException {
345 < //                 lock.writeLock().tryLock(2 * LONG_DELAY_MS, MILLISECONDS);
346 < //             }});
347 <
348 < //         waitForQueuedThread(lock, t);
349 < //         t.interrupt();
350 < //         awaitTermination(t);
351 < //         releaseWriteLock(lock);
352 < //     }
353 <
354 < //     /**
355 < //      * read-lockInterruptibly is interruptible
356 < //      */
357 < //     public void testReadLockInterruptibly_Interruptible()      { testReadLockInterruptibly_Interruptible(false); }
358 < //     public void testReadLockInterruptibly_Interruptible_fair() { testReadLockInterruptibly_Interruptible(true); }
359 < //     public void testReadLockInterruptibly_Interruptible(boolean fair) {
360 < //         final PublicReentrantReadWriteLock lock =
361 < //             new PublicReentrantReadWriteLock(fair);
362 < //         lock.writeLock().lock();
363 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
364 < //             public void realRun() throws InterruptedException {
365 < //                 lock.readLock().lockInterruptibly();
366 < //             }});
367 <
368 < //         waitForQueuedThread(lock, t);
369 < //         t.interrupt();
370 < //         awaitTermination(t);
371 < //         releaseWriteLock(lock);
372 < //     }
373 <
374 < //     /**
375 < //      * timed read-tryLock is interruptible
376 < //      */
377 < //     public void testReadTryLock_Interruptible()      { testReadTryLock_Interruptible(false); }
378 < //     public void testReadTryLock_Interruptible_fair() { testReadTryLock_Interruptible(true); }
379 < //     public void testReadTryLock_Interruptible(boolean fair) {
380 < //         final PublicReentrantReadWriteLock lock =
381 < //             new PublicReentrantReadWriteLock(fair);
382 < //         lock.writeLock().lock();
383 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
384 < //             public void realRun() throws InterruptedException {
385 < //                 lock.readLock().tryLock(2 * LONG_DELAY_MS, MILLISECONDS);
386 < //             }});
387 <
388 < //         waitForQueuedThread(lock, t);
389 < //         t.interrupt();
390 < //         awaitTermination(t);
391 < //         releaseWriteLock(lock);
392 < //     }
393 <
394 < //     /**
395 < //      * write-tryLock on an unlocked lock succeeds
396 < //      */
397 < //     public void testWriteTryLock()      { testWriteTryLock(false); }
398 < //     public void testWriteTryLock_fair() { testWriteTryLock(true); }
399 < //     public void testWriteTryLock(boolean fair) {
400 < //         final PublicReentrantReadWriteLock lock =
401 < //             new PublicReentrantReadWriteLock(fair);
402 < //         assertTrue(lock.writeLock().tryLock());
403 < //         assertWriteLockedByMoi(lock);
404 < //         assertTrue(lock.writeLock().tryLock());
405 < //         assertWriteLockedByMoi(lock);
406 < //         lock.writeLock().unlock();
407 < //         releaseWriteLock(lock);
408 < //     }
409 <
410 < //     /**
411 < //      * write-tryLock fails if locked
412 < //      */
413 < //     public void testWriteTryLockWhenLocked()      { testWriteTryLockWhenLocked(false); }
414 < //     public void testWriteTryLockWhenLocked_fair() { testWriteTryLockWhenLocked(true); }
415 < //     public void testWriteTryLockWhenLocked(boolean fair) {
416 < //         final PublicReentrantReadWriteLock lock =
417 < //             new PublicReentrantReadWriteLock(fair);
418 < //         lock.writeLock().lock();
419 < //         Thread t = newStartedThread(new CheckedRunnable() {
420 < //             public void realRun() {
421 < //                 assertFalse(lock.writeLock().tryLock());
422 < //             }});
423 <
424 < //         awaitTermination(t);
425 < //         releaseWriteLock(lock);
426 < //     }
427 <
428 < //     /**
429 < //      * read-tryLock fails if locked
430 < //      */
431 < //     public void testReadTryLockWhenLocked()      { testReadTryLockWhenLocked(false); }
432 < //     public void testReadTryLockWhenLocked_fair() { testReadTryLockWhenLocked(true); }
433 < //     public void testReadTryLockWhenLocked(boolean fair) {
434 < //         final PublicReentrantReadWriteLock lock =
435 < //             new PublicReentrantReadWriteLock(fair);
436 < //         lock.writeLock().lock();
437 < //         Thread t = newStartedThread(new CheckedRunnable() {
438 < //             public void realRun() {
439 < //                 assertFalse(lock.readLock().tryLock());
440 < //             }});
441 <
442 < //         awaitTermination(t);
443 < //         releaseWriteLock(lock);
444 < //     }
445 <
446 < //     /**
447 < //      * Multiple threads can hold a read lock when not write-locked
448 < //      */
449 < //     public void testMultipleReadLocks()      { testMultipleReadLocks(false); }
450 < //     public void testMultipleReadLocks_fair() { testMultipleReadLocks(true); }
451 < //     public void testMultipleReadLocks(boolean fair) {
452 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
453 < //         lock.readLock().lock();
454 < //         Thread t = newStartedThread(new CheckedRunnable() {
455 < //             public void realRun() throws InterruptedException {
456 < //                 assertTrue(lock.readLock().tryLock());
457 < //                 lock.readLock().unlock();
458 < //                 assertTrue(lock.readLock().tryLock(LONG_DELAY_MS, MILLISECONDS));
459 < //                 lock.readLock().unlock();
460 < //                 lock.readLock().lock();
461 < //                 lock.readLock().unlock();
462 < //             }});
463 <
464 < //         awaitTermination(t);
465 < //         lock.readLock().unlock();
466 < //     }
467 <
468 < //     /**
469 < //      * A writelock succeeds only after a reading thread unlocks
470 < //      */
471 < //     public void testWriteAfterReadLock()      { testWriteAfterReadLock(false); }
472 < //     public void testWriteAfterReadLock_fair() { testWriteAfterReadLock(true); }
473 < //     public void testWriteAfterReadLock(boolean fair) {
474 < //         final PublicReentrantReadWriteLock lock =
475 < //             new PublicReentrantReadWriteLock(fair);
476 < //         lock.readLock().lock();
477 < //         Thread t = newStartedThread(new CheckedRunnable() {
478 < //             public void realRun() {
479 < //                 assertEquals(1, lock.getReadLockCount());
480 < //                 lock.writeLock().lock();
481 < //                 assertEquals(0, lock.getReadLockCount());
482 < //                 lock.writeLock().unlock();
483 < //             }});
484 < //         waitForQueuedThread(lock, t);
485 < //         assertNotWriteLocked(lock);
486 < //         assertEquals(1, lock.getReadLockCount());
487 < //         lock.readLock().unlock();
488 < //         assertEquals(0, lock.getReadLockCount());
489 < //         awaitTermination(t);
490 < //         assertNotWriteLocked(lock);
491 < //     }
492 <
493 < //     /**
494 < //      * A writelock succeeds only after reading threads unlock
495 < //      */
496 < //     public void testWriteAfterMultipleReadLocks()      { testWriteAfterMultipleReadLocks(false); }
497 < //     public void testWriteAfterMultipleReadLocks_fair() { testWriteAfterMultipleReadLocks(true); }
498 < //     public void testWriteAfterMultipleReadLocks(boolean fair) {
499 < //         final PublicReentrantReadWriteLock lock =
500 < //             new PublicReentrantReadWriteLock(fair);
501 < //         lock.readLock().lock();
502 < //         lock.readLock().lock();
503 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
504 < //             public void realRun() {
505 < //                 lock.readLock().lock();
506 < //                 assertEquals(3, lock.getReadLockCount());
507 < //                 lock.readLock().unlock();
508 < //             }});
509 < //         awaitTermination(t1);
510 <
511 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
512 < //             public void realRun() {
513 < //                 assertEquals(2, lock.getReadLockCount());
514 < //                 lock.writeLock().lock();
515 < //                 assertEquals(0, lock.getReadLockCount());
516 < //                 lock.writeLock().unlock();
517 < //             }});
518 < //         waitForQueuedThread(lock, t2);
519 < //         assertNotWriteLocked(lock);
520 < //         assertEquals(2, lock.getReadLockCount());
521 < //         lock.readLock().unlock();
522 < //         lock.readLock().unlock();
523 < //         assertEquals(0, lock.getReadLockCount());
524 < //         awaitTermination(t2);
525 < //         assertNotWriteLocked(lock);
526 < //     }
527 <
528 < //     /**
529 < //      * A thread that tries to acquire a fair read lock (non-reentrantly)
530 < //      * will block if there is a waiting writer thread
531 < //      */
532 < //     public void testReaderWriterReaderFairFifo() {
533 < //         final PublicReentrantReadWriteLock lock =
534 < //             new PublicReentrantReadWriteLock(true);
535 < //         final AtomicBoolean t1GotLock = new AtomicBoolean(false);
536 <
537 < //         lock.readLock().lock();
538 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
539 < //             public void realRun() {
540 < //                 assertEquals(1, lock.getReadLockCount());
541 < //                 lock.writeLock().lock();
542 < //                 assertEquals(0, lock.getReadLockCount());
543 < //                 t1GotLock.set(true);
544 < //                 lock.writeLock().unlock();
545 < //             }});
546 < //         waitForQueuedThread(lock, t1);
547 <
548 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
549 < //             public void realRun() {
550 < //                 assertEquals(1, lock.getReadLockCount());
551 < //                 lock.readLock().lock();
552 < //                 assertEquals(1, lock.getReadLockCount());
553 < //                 assertTrue(t1GotLock.get());
554 < //                 lock.readLock().unlock();
555 < //             }});
556 < //         waitForQueuedThread(lock, t2);
557 < //         assertTrue(t1.isAlive());
558 < //         assertNotWriteLocked(lock);
559 < //         assertEquals(1, lock.getReadLockCount());
560 < //         lock.readLock().unlock();
561 < //         awaitTermination(t1);
562 < //         awaitTermination(t2);
563 < //         assertNotWriteLocked(lock);
564 < //     }
565 <
566 < //     /**
567 < //      * Readlocks succeed only after a writing thread unlocks
568 < //      */
569 < //     public void testReadAfterWriteLock()      { testReadAfterWriteLock(false); }
570 < //     public void testReadAfterWriteLock_fair() { testReadAfterWriteLock(true); }
571 < //     public void testReadAfterWriteLock(boolean fair) {
572 < //         final PublicReentrantReadWriteLock lock =
573 < //             new PublicReentrantReadWriteLock(fair);
574 < //         lock.writeLock().lock();
575 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
576 < //             public void realRun() {
577 < //                 lock.readLock().lock();
578 < //                 lock.readLock().unlock();
579 < //             }});
580 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
581 < //             public void realRun() {
582 < //                 lock.readLock().lock();
583 < //                 lock.readLock().unlock();
584 < //             }});
585 <
586 < //         waitForQueuedThread(lock, t1);
587 < //         waitForQueuedThread(lock, t2);
588 < //         releaseWriteLock(lock);
589 < //         awaitTermination(t1);
590 < //         awaitTermination(t2);
591 < //     }
592 <
593 < //     /**
594 < //      * Read trylock succeeds if write locked by current thread
595 < //      */
596 < //     public void testReadHoldingWriteLock()      { testReadHoldingWriteLock(false); }
597 < //     public void testReadHoldingWriteLock_fair() { testReadHoldingWriteLock(true); }
598 < //     public void testReadHoldingWriteLock(boolean fair) {
599 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
600 < //         lock.writeLock().lock();
601 < //         assertTrue(lock.readLock().tryLock());
602 < //         lock.readLock().unlock();
603 < //         lock.writeLock().unlock();
604 < //     }
605 <
606 < //     /**
607 < //      * Read trylock succeeds (barging) even in the presence of waiting
608 < //      * readers and/or writers
609 < //      */
610 < //     public void testReadTryLockBarging()      { testReadTryLockBarging(false); }
611 < //     public void testReadTryLockBarging_fair() { testReadTryLockBarging(true); }
612 < //     public void testReadTryLockBarging(boolean fair) {
613 < //         final PublicReentrantReadWriteLock lock =
614 < //             new PublicReentrantReadWriteLock(fair);
615 < //         lock.readLock().lock();
616 <
617 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
618 < //             public void realRun() {
619 < //                 lock.writeLock().lock();
620 < //                 lock.writeLock().unlock();
621 < //             }});
622 <
623 < //         waitForQueuedThread(lock, t1);
624 <
625 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
626 < //             public void realRun() {
627 < //                 lock.readLock().lock();
628 < //                 lock.readLock().unlock();
629 < //             }});
630 <
631 < //         if (fair)
632 < //             waitForQueuedThread(lock, t2);
633 <
634 < //         Thread t3 = newStartedThread(new CheckedRunnable() {
635 < //             public void realRun() {
636 < //                 lock.readLock().tryLock();
637 < //                 lock.readLock().unlock();
638 < //             }});
639 <
640 < //         assertTrue(lock.getReadLockCount() > 0);
641 < //         awaitTermination(t3);
642 < //         assertTrue(t1.isAlive());
643 < //         if (fair) assertTrue(t2.isAlive());
644 < //         lock.readLock().unlock();
645 < //         awaitTermination(t1);
646 < //         awaitTermination(t2);
647 < //     }
648 <
649 < //     /**
650 < //      * Read lock succeeds if write locked by current thread even if
651 < //      * other threads are waiting for readlock
652 < //      */
653 < //     public void testReadHoldingWriteLock2()      { testReadHoldingWriteLock2(false); }
654 < //     public void testReadHoldingWriteLock2_fair() { testReadHoldingWriteLock2(true); }
655 < //     public void testReadHoldingWriteLock2(boolean fair) {
656 < //         final PublicReentrantReadWriteLock lock =
657 < //             new PublicReentrantReadWriteLock(fair);
658 < //         lock.writeLock().lock();
659 < //         lock.readLock().lock();
660 < //         lock.readLock().unlock();
661 <
662 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
663 < //             public void realRun() {
664 < //                 lock.readLock().lock();
665 < //                 lock.readLock().unlock();
666 < //             }});
667 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
668 < //             public void realRun() {
669 < //                 lock.readLock().lock();
670 < //                 lock.readLock().unlock();
671 < //             }});
672 <
673 < //         waitForQueuedThread(lock, t1);
674 < //         waitForQueuedThread(lock, t2);
675 < //         assertWriteLockedByMoi(lock);
676 < //         lock.readLock().lock();
677 < //         lock.readLock().unlock();
678 < //         releaseWriteLock(lock);
679 < //         awaitTermination(t1);
680 < //         awaitTermination(t2);
681 < //     }
682 <
683 < //     /**
684 < //      * Read lock succeeds if write locked by current thread even if
685 < //      * other threads are waiting for writelock
686 < //      */
687 < //     public void testReadHoldingWriteLock3()      { testReadHoldingWriteLock3(false); }
688 < //     public void testReadHoldingWriteLock3_fair() { testReadHoldingWriteLock3(true); }
689 < //     public void testReadHoldingWriteLock3(boolean fair) {
690 < //         final PublicReentrantReadWriteLock lock =
691 < //             new PublicReentrantReadWriteLock(fair);
692 < //         lock.writeLock().lock();
693 < //         lock.readLock().lock();
694 < //         lock.readLock().unlock();
695 <
696 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
697 < //             public void realRun() {
698 < //                 lock.writeLock().lock();
699 < //                 lock.writeLock().unlock();
700 < //             }});
701 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
702 < //             public void realRun() {
703 < //                 lock.writeLock().lock();
704 < //                 lock.writeLock().unlock();
705 < //             }});
706 <
707 < //         waitForQueuedThread(lock, t1);
708 < //         waitForQueuedThread(lock, t2);
709 < //         assertWriteLockedByMoi(lock);
710 < //         lock.readLock().lock();
711 < //         lock.readLock().unlock();
712 < //         assertWriteLockedByMoi(lock);
713 < //         lock.writeLock().unlock();
714 < //         awaitTermination(t1);
715 < //         awaitTermination(t2);
716 < //     }
717 <
718 < //     /**
719 < //      * Write lock succeeds if write locked by current thread even if
720 < //      * other threads are waiting for writelock
721 < //      */
722 < //     public void testWriteHoldingWriteLock4()      { testWriteHoldingWriteLock4(false); }
723 < //     public void testWriteHoldingWriteLock4_fair() { testWriteHoldingWriteLock4(true); }
724 < //     public void testWriteHoldingWriteLock4(boolean fair) {
725 < //         final PublicReentrantReadWriteLock lock =
726 < //             new PublicReentrantReadWriteLock(fair);
727 < //         lock.writeLock().lock();
728 < //         lock.writeLock().lock();
729 < //         lock.writeLock().unlock();
730 <
731 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
732 < //             public void realRun() {
733 < //                 lock.writeLock().lock();
734 < //                 lock.writeLock().unlock();
735 < //             }});
736 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
737 < //             public void realRun() {
738 < //                 lock.writeLock().lock();
739 < //                 lock.writeLock().unlock();
740 < //             }});
741 <
742 < //         waitForQueuedThread(lock, t1);
743 < //         waitForQueuedThread(lock, t2);
744 < //         assertWriteLockedByMoi(lock);
745 < //         assertEquals(1, lock.getWriteHoldCount());
746 < //         lock.writeLock().lock();
747 < //         assertWriteLockedByMoi(lock);
748 < //         assertEquals(2, lock.getWriteHoldCount());
749 < //         lock.writeLock().unlock();
750 < //         assertWriteLockedByMoi(lock);
751 < //         assertEquals(1, lock.getWriteHoldCount());
752 < //         lock.writeLock().unlock();
753 < //         awaitTermination(t1);
754 < //         awaitTermination(t2);
755 < //     }
756 <
757 < //     /**
758 < //      * Read tryLock succeeds if readlocked but not writelocked
759 < //      */
760 < //     public void testTryLockWhenReadLocked()      { testTryLockWhenReadLocked(false); }
761 < //     public void testTryLockWhenReadLocked_fair() { testTryLockWhenReadLocked(true); }
762 < //     public void testTryLockWhenReadLocked(boolean fair) {
763 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
764 < //         lock.readLock().lock();
765 < //         Thread t = newStartedThread(new CheckedRunnable() {
766 < //             public void realRun() {
767 < //                 assertTrue(lock.readLock().tryLock());
768 < //                 lock.readLock().unlock();
769 < //             }});
770 <
771 < //         awaitTermination(t);
772 < //         lock.readLock().unlock();
773 < //     }
774 <
775 < //     /**
776 < //      * write tryLock fails when readlocked
777 < //      */
778 < //     public void testWriteTryLockWhenReadLocked()      { testWriteTryLockWhenReadLocked(false); }
779 < //     public void testWriteTryLockWhenReadLocked_fair() { testWriteTryLockWhenReadLocked(true); }
780 < //     public void testWriteTryLockWhenReadLocked(boolean fair) {
781 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
782 < //         lock.readLock().lock();
783 < //         Thread t = newStartedThread(new CheckedRunnable() {
784 < //             public void realRun() {
785 < //                 assertFalse(lock.writeLock().tryLock());
786 < //             }});
787 <
788 < //         awaitTermination(t);
789 < //         lock.readLock().unlock();
790 < //     }
791 <
792 < //     /**
793 < //      * write timed tryLock times out if locked
794 < //      */
795 < //     public void testWriteTryLock_Timeout()      { testWriteTryLock_Timeout(false); }
796 < //     public void testWriteTryLock_Timeout_fair() { testWriteTryLock_Timeout(true); }
797 < //     public void testWriteTryLock_Timeout(boolean fair) {
798 < //         final PublicReentrantReadWriteLock lock =
799 < //             new PublicReentrantReadWriteLock(fair);
800 < //         lock.writeLock().lock();
801 < //         Thread t = newStartedThread(new CheckedRunnable() {
802 < //             public void realRun() throws InterruptedException {
803 < //                 long startTime = System.nanoTime();
804 < //                 long timeoutMillis = 10;
805 < //                 assertFalse(lock.writeLock().tryLock(timeoutMillis, MILLISECONDS));
806 < //                 assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
807 < //             }});
808 <
809 < //         awaitTermination(t);
810 < //         releaseWriteLock(lock);
811 < //     }
812 <
813 < //     /**
814 < //      * read timed tryLock times out if write-locked
815 < //      */
816 < //     public void testReadTryLock_Timeout()      { testReadTryLock_Timeout(false); }
817 < //     public void testReadTryLock_Timeout_fair() { testReadTryLock_Timeout(true); }
818 < //     public void testReadTryLock_Timeout(boolean fair) {
819 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
820 < //         lock.writeLock().lock();
821 < //         Thread t = newStartedThread(new CheckedRunnable() {
822 < //             public void realRun() throws InterruptedException {
823 < //                 long startTime = System.nanoTime();
824 < //                 long timeoutMillis = 10;
825 < //                 assertFalse(lock.readLock().tryLock(timeoutMillis, MILLISECONDS));
826 < //                 assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
827 < //             }});
828 <
829 < //         awaitTermination(t);
830 < //         assertTrue(lock.writeLock().isHeldByCurrentThread());
831 < //         lock.writeLock().unlock();
832 < //     }
833 <
834 < //     /**
835 < //      * write lockInterruptibly succeeds if unlocked, else is interruptible
836 < //      */
837 < //     public void testWriteLockInterruptibly()      { testWriteLockInterruptibly(false); }
838 < //     public void testWriteLockInterruptibly_fair() { testWriteLockInterruptibly(true); }
839 < //     public void testWriteLockInterruptibly(boolean fair) {
840 < //         final PublicReentrantReadWriteLock lock =
841 < //             new PublicReentrantReadWriteLock(fair);
842 < //         try {
843 < //             lock.writeLock().lockInterruptibly();
844 < //         } catch (InterruptedException ie) {
845 < //             threadUnexpectedException(ie);
846 < //         }
847 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
848 < //             public void realRun() throws InterruptedException {
849 < //                 lock.writeLock().lockInterruptibly();
850 < //             }});
851 <
852 < //         waitForQueuedThread(lock, t);
853 < //         t.interrupt();
854 < //         assertTrue(lock.writeLock().isHeldByCurrentThread());
855 < //         awaitTermination(t);
856 < //         releaseWriteLock(lock);
857 < //     }
858 <
859 < //     /**
860 < //      * read lockInterruptibly succeeds if lock free else is interruptible
861 < //      */
862 < //     public void testReadLockInterruptibly()      { testReadLockInterruptibly(false); }
863 < //     public void testReadLockInterruptibly_fair() { testReadLockInterruptibly(true); }
864 < //     public void testReadLockInterruptibly(boolean fair) {
865 < //         final PublicReentrantReadWriteLock lock =
866 < //             new PublicReentrantReadWriteLock(fair);
867 < //         try {
868 < //             lock.readLock().lockInterruptibly();
869 < //             lock.readLock().unlock();
870 < //             lock.writeLock().lockInterruptibly();
871 < //         } catch (InterruptedException ie) {
872 < //             threadUnexpectedException(ie);
873 < //         }
874 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
875 < //             public void realRun() throws InterruptedException {
876 < //                 lock.readLock().lockInterruptibly();
877 < //             }});
878 <
879 < //         waitForQueuedThread(lock, t);
880 < //         t.interrupt();
881 < //         awaitTermination(t);
882 < //         releaseWriteLock(lock);
883 < //     }
884 <
885 < //     /**
886 < //      * Calling await without holding lock throws IllegalMonitorStateException
887 < //      */
888 < //     public void testAwait_IMSE()      { testAwait_IMSE(false); }
889 < //     public void testAwait_IMSE_fair() { testAwait_IMSE(true); }
890 < //     public void testAwait_IMSE(boolean fair) {
891 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
892 < //         final Condition c = lock.writeLock().newCondition();
893 < //         for (AwaitMethod awaitMethod : AwaitMethod.values()) {
894 < //             long startTime = System.nanoTime();
895 < //             try {
896 < //                 await(c, awaitMethod);
897 < //                 shouldThrow();
898 < //             } catch (IllegalMonitorStateException success) {
899 < //             } catch (InterruptedException e) { threadUnexpectedException(e); }
900 < //             assertTrue(millisElapsedSince(startTime) < LONG_DELAY_MS);
901 < //         }
902 < //     }
903 <
904 < //     /**
905 < //      * Calling signal without holding lock throws IllegalMonitorStateException
906 < //      */
907 < //     public void testSignal_IMSE()      { testSignal_IMSE(false); }
908 < //     public void testSignal_IMSE_fair() { testSignal_IMSE(true); }
909 < //     public void testSignal_IMSE(boolean fair) {
910 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
911 < //         final Condition c = lock.writeLock().newCondition();
912 < //         try {
913 < //             c.signal();
914 < //             shouldThrow();
915 < //         } catch (IllegalMonitorStateException success) {}
916 < //     }
917 <
918 < //     /**
919 < //      * Calling signalAll without holding lock throws IllegalMonitorStateException
920 < //      */
921 < //     public void testSignalAll_IMSE()      { testSignalAll_IMSE(false); }
922 < //     public void testSignalAll_IMSE_fair() { testSignalAll_IMSE(true); }
923 < //     public void testSignalAll_IMSE(boolean fair) {
924 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
925 < //         final Condition c = lock.writeLock().newCondition();
926 < //         try {
927 < //             c.signalAll();
928 < //             shouldThrow();
929 < //         } catch (IllegalMonitorStateException success) {}
930 < //     }
931 <
932 < //     /**
933 < //      * awaitNanos without a signal times out
934 < //      */
935 < //     public void testAwaitNanos_Timeout()      { testAwaitNanos_Timeout(false); }
936 < //     public void testAwaitNanos_Timeout_fair() { testAwaitNanos_Timeout(true); }
937 < //     public void testAwaitNanos_Timeout(boolean fair) {
938 < //         try {
939 < //             final ReentrantReadWriteLock lock =
940 < //                 new ReentrantReadWriteLock(fair);
941 < //             final Condition c = lock.writeLock().newCondition();
942 < //             lock.writeLock().lock();
943 < //             long startTime = System.nanoTime();
944 < //             long timeoutMillis = 10;
945 < //             long timeoutNanos = MILLISECONDS.toNanos(timeoutMillis);
946 < //             long nanosRemaining = c.awaitNanos(timeoutNanos);
947 < //             assertTrue(nanosRemaining <= 0);
948 < //             assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
949 < //             lock.writeLock().unlock();
950 < //         } catch (InterruptedException e) {
951 < //             threadUnexpectedException(e);
952 < //         }
953 < //     }
954 <
955 < //     /**
956 < //      * timed await without a signal times out
957 < //      */
958 < //     public void testAwait_Timeout()      { testAwait_Timeout(false); }
959 < //     public void testAwait_Timeout_fair() { testAwait_Timeout(true); }
960 < //     public void testAwait_Timeout(boolean fair) {
961 < //         try {
962 < //             final ReentrantReadWriteLock lock =
963 < //                 new ReentrantReadWriteLock(fair);
964 < //             final Condition c = lock.writeLock().newCondition();
965 < //             lock.writeLock().lock();
966 < //             long startTime = System.nanoTime();
967 < //             long timeoutMillis = 10;
968 < //             assertFalse(c.await(timeoutMillis, MILLISECONDS));
969 < //             assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
970 < //             lock.writeLock().unlock();
971 < //         } catch (InterruptedException e) {
972 < //             threadUnexpectedException(e);
973 < //         }
974 < //     }
975 <
976 < //     /**
977 < //      * awaitUntil without a signal times out
978 < //      */
979 < //     public void testAwaitUntil_Timeout()      { testAwaitUntil_Timeout(false); }
980 < //     public void testAwaitUntil_Timeout_fair() { testAwaitUntil_Timeout(true); }
981 < //     public void testAwaitUntil_Timeout(boolean fair) {
982 < //         try {
983 < //             final ReentrantReadWriteLock lock =
984 < //                 new ReentrantReadWriteLock(fair);
985 < //             final Condition c = lock.writeLock().newCondition();
986 < //             lock.writeLock().lock();
987 < //             long startTime = System.nanoTime();
988 < //             long timeoutMillis = 10;
989 < //             java.util.Date d = new java.util.Date();
990 < //             assertFalse(c.awaitUntil(new java.util.Date(d.getTime() + timeoutMillis)));
991 < //             assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
992 < //             lock.writeLock().unlock();
993 < //         } catch (InterruptedException e) {
994 < //             threadUnexpectedException(e);
995 < //         }
996 < //     }
997 <
998 < //     /**
999 < //      * await returns when signalled
1000 < //      */
1001 < //     public void testAwait()      { testAwait(false); }
1002 < //     public void testAwait_fair() { testAwait(true); }
1003 < //     public void testAwait(boolean fair) {
1004 < //         final PublicReentrantReadWriteLock lock =
1005 < //             new PublicReentrantReadWriteLock(fair);
1006 < //         final Condition c = lock.writeLock().newCondition();
1007 < //         final CountDownLatch locked = new CountDownLatch(1);
1008 < //         Thread t = newStartedThread(new CheckedRunnable() {
1009 < //             public void realRun() throws InterruptedException {
1010 < //                 lock.writeLock().lock();
1011 < //                 locked.countDown();
1012 < //                 c.await();
1013 < //                 lock.writeLock().unlock();
1014 < //             }});
1015 <
1016 < //         await(locked);
1017 < //         lock.writeLock().lock();
1018 < //         assertHasWaiters(lock, c, t);
1019 < //         c.signal();
1020 < //         assertHasNoWaiters(lock, c);
1021 < //         assertTrue(t.isAlive());
1022 < //         lock.writeLock().unlock();
1023 < //         awaitTermination(t);
1024 < //     }
1025 <
1026 < //     /**
1027 < //      * awaitUninterruptibly is uninterruptible
1028 < //      */
1029 < //     public void testAwaitUninterruptibly()      { testAwaitUninterruptibly(false); }
1030 < //     public void testAwaitUninterruptibly_fair() { testAwaitUninterruptibly(true); }
1031 < //     public void testAwaitUninterruptibly(boolean fair) {
1032 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1033 < //         final Condition c = lock.writeLock().newCondition();
1034 < //         final CountDownLatch pleaseInterrupt = new CountDownLatch(2);
1035 <
1036 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
1037 < //             public void realRun() {
1038 < //                 // Interrupt before awaitUninterruptibly
1039 < //                 lock.writeLock().lock();
1040 < //                 pleaseInterrupt.countDown();
1041 < //                 Thread.currentThread().interrupt();
1042 < //                 c.awaitUninterruptibly();
1043 < //                 assertTrue(Thread.interrupted());
1044 < //                 lock.writeLock().unlock();
1045 < //             }});
1046 <
1047 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
1048 < //             public void realRun() {
1049 < //                 // Interrupt during awaitUninterruptibly
1050 < //                 lock.writeLock().lock();
1051 < //                 pleaseInterrupt.countDown();
1052 < //                 c.awaitUninterruptibly();
1053 < //                 assertTrue(Thread.interrupted());
1054 < //                 lock.writeLock().unlock();
1055 < //             }});
1056 <
1057 < //         await(pleaseInterrupt);
1058 < //         lock.writeLock().lock();
1059 < //         lock.writeLock().unlock();
1060 < //         t2.interrupt();
1061 <
1062 < //         assertThreadStaysAlive(t1);
1063 < //         assertTrue(t2.isAlive());
1064 <
1065 < //         lock.writeLock().lock();
1066 < //         c.signalAll();
1067 < //         lock.writeLock().unlock();
1068 <
1069 < //         awaitTermination(t1);
1070 < //         awaitTermination(t2);
1071 < //     }
1072 <
1073 < //     /**
1074 < //      * await/awaitNanos/awaitUntil is interruptible
1075 < //      */
1076 < //     public void testInterruptible_await()           { testInterruptible(false, AwaitMethod.await); }
1077 < //     public void testInterruptible_await_fair()      { testInterruptible(true,  AwaitMethod.await); }
1078 < //     public void testInterruptible_awaitTimed()      { testInterruptible(false, AwaitMethod.awaitTimed); }
1079 < //     public void testInterruptible_awaitTimed_fair() { testInterruptible(true,  AwaitMethod.awaitTimed); }
1080 < //     public void testInterruptible_awaitNanos()      { testInterruptible(false, AwaitMethod.awaitNanos); }
1081 < //     public void testInterruptible_awaitNanos_fair() { testInterruptible(true,  AwaitMethod.awaitNanos); }
1082 < //     public void testInterruptible_awaitUntil()      { testInterruptible(false, AwaitMethod.awaitUntil); }
1083 < //     public void testInterruptible_awaitUntil_fair() { testInterruptible(true,  AwaitMethod.awaitUntil); }
1084 < //     public void testInterruptible(boolean fair, final AwaitMethod awaitMethod) {
1085 < //         final PublicReentrantReadWriteLock lock =
1086 < //             new PublicReentrantReadWriteLock(fair);
1087 < //         final Condition c = lock.writeLock().newCondition();
1088 < //         final CountDownLatch locked = new CountDownLatch(1);
1089 < //         Thread t = newStartedThread(new CheckedInterruptedRunnable() {
1090 < //             public void realRun() throws InterruptedException {
1091 < //                 lock.writeLock().lock();
1092 < //                 assertWriteLockedByMoi(lock);
1093 < //                 assertHasNoWaiters(lock, c);
1094 < //                 locked.countDown();
1095 < //                 try {
1096 < //                     await(c, awaitMethod);
1097 < //                 } finally {
1098 < //                     assertWriteLockedByMoi(lock);
1099 < //                     assertHasNoWaiters(lock, c);
1100 < //                     lock.writeLock().unlock();
1101 < //                     assertFalse(Thread.interrupted());
1102 < //                 }
1103 < //             }});
1104 <
1105 < //         await(locked);
1106 < //         assertHasWaiters(lock, c, t);
1107 < //         t.interrupt();
1108 < //         awaitTermination(t);
1109 < //         assertNotWriteLocked(lock);
1110 < //     }
1111 <
1112 < //     /**
1113 < //      * signalAll wakes up all threads
1114 < //      */
1115 < //     public void testSignalAll_await()           { testSignalAll(false, AwaitMethod.await); }
1116 < //     public void testSignalAll_await_fair()      { testSignalAll(true,  AwaitMethod.await); }
1117 < //     public void testSignalAll_awaitTimed()      { testSignalAll(false, AwaitMethod.awaitTimed); }
1118 < //     public void testSignalAll_awaitTimed_fair() { testSignalAll(true,  AwaitMethod.awaitTimed); }
1119 < //     public void testSignalAll_awaitNanos()      { testSignalAll(false, AwaitMethod.awaitNanos); }
1120 < //     public void testSignalAll_awaitNanos_fair() { testSignalAll(true,  AwaitMethod.awaitNanos); }
1121 < //     public void testSignalAll_awaitUntil()      { testSignalAll(false, AwaitMethod.awaitUntil); }
1122 < //     public void testSignalAll_awaitUntil_fair() { testSignalAll(true,  AwaitMethod.awaitUntil); }
1123 < //     public void testSignalAll(boolean fair, final AwaitMethod awaitMethod) {
1124 < //         final PublicReentrantReadWriteLock lock =
1125 < //             new PublicReentrantReadWriteLock(fair);
1126 < //         final Condition c = lock.writeLock().newCondition();
1127 < //         final CountDownLatch locked = new CountDownLatch(2);
1128 < //         final Lock writeLock = lock.writeLock();
1129 < //         class Awaiter extends CheckedRunnable {
1130 < //             public void realRun() throws InterruptedException {
1131 < //                 writeLock.lock();
1132 < //                 locked.countDown();
1133 < //                 await(c, awaitMethod);
1134 < //                 writeLock.unlock();
1135 < //             }
1136 < //         }
1137 <
1138 < //         Thread t1 = newStartedThread(new Awaiter());
1139 < //         Thread t2 = newStartedThread(new Awaiter());
1140 <
1141 < //         await(locked);
1142 < //         writeLock.lock();
1143 < //         assertHasWaiters(lock, c, t1, t2);
1144 < //         c.signalAll();
1145 < //         assertHasNoWaiters(lock, c);
1146 < //         writeLock.unlock();
1147 < //         awaitTermination(t1);
1148 < //         awaitTermination(t2);
1149 < //     }
1150 <
1151 < //     /**
1152 < //      * signal wakes up waiting threads in FIFO order
1153 < //      */
1154 < //     public void testSignalWakesFifo()      { testSignalWakesFifo(false); }
1155 < //     public void testSignalWakesFifo_fair() { testSignalWakesFifo(true); }
1156 < //     public void testSignalWakesFifo(boolean fair) {
1157 < //         final PublicReentrantReadWriteLock lock =
1158 < //             new PublicReentrantReadWriteLock(fair);
1159 < //         final Condition c = lock.writeLock().newCondition();
1160 < //         final CountDownLatch locked1 = new CountDownLatch(1);
1161 < //         final CountDownLatch locked2 = new CountDownLatch(1);
1162 < //         final Lock writeLock = lock.writeLock();
1163 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
1164 < //             public void realRun() throws InterruptedException {
1165 < //                 writeLock.lock();
1166 < //                 locked1.countDown();
1167 < //                 c.await();
1168 < //                 writeLock.unlock();
1169 < //             }});
1170 <
1171 < //         await(locked1);
1172 <
1173 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
1174 < //             public void realRun() throws InterruptedException {
1175 < //                 writeLock.lock();
1176 < //                 locked2.countDown();
1177 < //                 c.await();
1178 < //                 writeLock.unlock();
1179 < //             }});
1180 <
1181 < //         await(locked2);
1182 <
1183 < //         writeLock.lock();
1184 < //         assertHasWaiters(lock, c, t1, t2);
1185 < //         assertFalse(lock.hasQueuedThreads());
1186 < //         c.signal();
1187 < //         assertHasWaiters(lock, c, t2);
1188 < //         assertTrue(lock.hasQueuedThread(t1));
1189 < //         assertFalse(lock.hasQueuedThread(t2));
1190 < //         c.signal();
1191 < //         assertHasNoWaiters(lock, c);
1192 < //         assertTrue(lock.hasQueuedThread(t1));
1193 < //         assertTrue(lock.hasQueuedThread(t2));
1194 < //         writeLock.unlock();
1195 < //         awaitTermination(t1);
1196 < //         awaitTermination(t2);
1197 < //     }
1198 <
1199 < //     /**
1200 < //      * await after multiple reentrant locking preserves lock count
1201 < //      */
1202 < //     public void testAwaitLockCount()      { testAwaitLockCount(false); }
1203 < //     public void testAwaitLockCount_fair() { testAwaitLockCount(true); }
1204 < //     public void testAwaitLockCount(boolean fair) {
1205 < //         final PublicReentrantReadWriteLock lock =
1206 < //             new PublicReentrantReadWriteLock(fair);
1207 < //         final Condition c = lock.writeLock().newCondition();
1208 < //         final CountDownLatch locked = new CountDownLatch(2);
1209 < //         Thread t1 = newStartedThread(new CheckedRunnable() {
1210 < //             public void realRun() throws InterruptedException {
1211 < //                 lock.writeLock().lock();
1212 < //                 assertWriteLockedByMoi(lock);
1213 < //                 assertEquals(1, lock.writeLock().getHoldCount());
1214 < //                 locked.countDown();
1215 < //                 c.await();
1216 < //                 assertWriteLockedByMoi(lock);
1217 < //                 assertEquals(1, lock.writeLock().getHoldCount());
1218 < //                 lock.writeLock().unlock();
1219 < //             }});
1220 <
1221 < //         Thread t2 = newStartedThread(new CheckedRunnable() {
1222 < //             public void realRun() throws InterruptedException {
1223 < //                 lock.writeLock().lock();
1224 < //                 lock.writeLock().lock();
1225 < //                 assertWriteLockedByMoi(lock);
1226 < //                 assertEquals(2, lock.writeLock().getHoldCount());
1227 < //                 locked.countDown();
1228 < //                 c.await();
1229 < //                 assertWriteLockedByMoi(lock);
1230 < //                 assertEquals(2, lock.writeLock().getHoldCount());
1231 < //                 lock.writeLock().unlock();
1232 < //                 lock.writeLock().unlock();
1233 < //             }});
1234 <
1235 < //         await(locked);
1236 < //         lock.writeLock().lock();
1237 < //         assertHasWaiters(lock, c, t1, t2);
1238 < //         c.signalAll();
1239 < //         assertHasNoWaiters(lock, c);
1240 < //         lock.writeLock().unlock();
1241 < //         awaitTermination(t1);
1242 < //         awaitTermination(t2);
1243 < //     }
1244 <
1245 < //     /**
1246 < //      * A serialized lock deserializes as unlocked
1247 < //      */
1248 < //     public void testSerialization()      { testSerialization(false); }
1249 < //     public void testSerialization_fair() { testSerialization(true); }
1250 < //     public void testSerialization(boolean fair) {
1251 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1252 < //         lock.writeLock().lock();
1253 < //         lock.readLock().lock();
1254 <
1255 < //         ReentrantReadWriteLock clone = serialClone(lock);
1256 < //         assertEquals(lock.isFair(), clone.isFair());
1257 < //         assertTrue(lock.isWriteLocked());
1258 < //         assertFalse(clone.isWriteLocked());
1259 < //         assertEquals(1, lock.getReadLockCount());
1260 < //         assertEquals(0, clone.getReadLockCount());
1261 < //         clone.writeLock().lock();
1262 < //         clone.readLock().lock();
1263 < //         assertTrue(clone.isWriteLocked());
1264 < //         assertEquals(1, clone.getReadLockCount());
1265 < //         clone.readLock().unlock();
1266 < //         clone.writeLock().unlock();
1267 < //         assertFalse(clone.isWriteLocked());
1268 < //         assertEquals(1, lock.getReadLockCount());
1269 < //         assertEquals(0, clone.getReadLockCount());
1270 < //     }
1271 <
1272 < //     /**
1273 < //      * hasQueuedThreads reports whether there are waiting threads
1274 < //      */
1275 < //     public void testHasQueuedThreads()      { testHasQueuedThreads(false); }
1276 < //     public void testHasQueuedThreads_fair() { testHasQueuedThreads(true); }
1277 < //     public void testHasQueuedThreads(boolean fair) {
1278 < //         final PublicReentrantReadWriteLock lock =
1279 < //             new PublicReentrantReadWriteLock(fair);
1280 < //         Thread t1 = new Thread(new InterruptedLockRunnable(lock));
1281 < //         Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
1282 < //         assertFalse(lock.hasQueuedThreads());
1283 < //         lock.writeLock().lock();
1284 < //         assertFalse(lock.hasQueuedThreads());
1285 < //         t1.start();
1286 < //         waitForQueuedThread(lock, t1);
1287 < //         assertTrue(lock.hasQueuedThreads());
1288 < //         t2.start();
1289 < //         waitForQueuedThread(lock, t2);
1290 < //         assertTrue(lock.hasQueuedThreads());
1291 < //         t1.interrupt();
1292 < //         awaitTermination(t1);
1293 < //         assertTrue(lock.hasQueuedThreads());
1294 < //         lock.writeLock().unlock();
1295 < //         awaitTermination(t2);
1296 < //         assertFalse(lock.hasQueuedThreads());
1297 < //     }
1298 <
1299 < //     /**
1300 < //      * hasQueuedThread(null) throws NPE
1301 < //      */
1302 < //     public void testHasQueuedThreadNPE()      { testHasQueuedThreadNPE(false); }
1303 < //     public void testHasQueuedThreadNPE_fair() { testHasQueuedThreadNPE(true); }
1304 < //     public void testHasQueuedThreadNPE(boolean fair) {
1305 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1306 < //         try {
1307 < //             lock.hasQueuedThread(null);
1308 < //             shouldThrow();
1309 < //         } catch (NullPointerException success) {}
1310 < //     }
1311 <
1312 < //     /**
1313 < //      * hasQueuedThread reports whether a thread is queued
1314 < //      */
1315 < //     public void testHasQueuedThread()      { testHasQueuedThread(false); }
1316 < //     public void testHasQueuedThread_fair() { testHasQueuedThread(true); }
1317 < //     public void testHasQueuedThread(boolean fair) {
1318 < //         final PublicReentrantReadWriteLock lock =
1319 < //             new PublicReentrantReadWriteLock(fair);
1320 < //         Thread t1 = new Thread(new InterruptedLockRunnable(lock));
1321 < //         Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
1322 < //         assertFalse(lock.hasQueuedThread(t1));
1323 < //         assertFalse(lock.hasQueuedThread(t2));
1324 < //         lock.writeLock().lock();
1325 < //         t1.start();
1326 < //         waitForQueuedThread(lock, t1);
1327 < //         assertTrue(lock.hasQueuedThread(t1));
1328 < //         assertFalse(lock.hasQueuedThread(t2));
1329 < //         t2.start();
1330 < //         waitForQueuedThread(lock, t2);
1331 < //         assertTrue(lock.hasQueuedThread(t1));
1332 < //         assertTrue(lock.hasQueuedThread(t2));
1333 < //         t1.interrupt();
1334 < //         awaitTermination(t1);
1335 < //         assertFalse(lock.hasQueuedThread(t1));
1336 < //         assertTrue(lock.hasQueuedThread(t2));
1337 < //         lock.writeLock().unlock();
1338 < //         awaitTermination(t2);
1339 < //         assertFalse(lock.hasQueuedThread(t1));
1340 < //         assertFalse(lock.hasQueuedThread(t2));
1341 < //     }
1342 <
1343 < //     /**
1344 < //      * getQueueLength reports number of waiting threads
1345 < //      */
1346 < //     public void testGetQueueLength()      { testGetQueueLength(false); }
1347 < //     public void testGetQueueLength_fair() { testGetQueueLength(true); }
1348 < //     public void testGetQueueLength(boolean fair) {
1349 < //         final PublicReentrantReadWriteLock lock =
1350 < //             new PublicReentrantReadWriteLock(fair);
1351 < //         Thread t1 = new Thread(new InterruptedLockRunnable(lock));
1352 < //         Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
1353 < //         assertEquals(0, lock.getQueueLength());
1354 < //         lock.writeLock().lock();
1355 < //         t1.start();
1356 < //         waitForQueuedThread(lock, t1);
1357 < //         assertEquals(1, lock.getQueueLength());
1358 < //         t2.start();
1359 < //         waitForQueuedThread(lock, t2);
1360 < //         assertEquals(2, lock.getQueueLength());
1361 < //         t1.interrupt();
1362 < //         awaitTermination(t1);
1363 < //         assertEquals(1, lock.getQueueLength());
1364 < //         lock.writeLock().unlock();
1365 < //         awaitTermination(t2);
1366 < //         assertEquals(0, lock.getQueueLength());
1367 < //     }
1368 <
1369 < //     /**
1370 < //      * getQueuedThreads includes waiting threads
1371 < //      */
1372 < //     public void testGetQueuedThreads()      { testGetQueuedThreads(false); }
1373 < //     public void testGetQueuedThreads_fair() { testGetQueuedThreads(true); }
1374 < //     public void testGetQueuedThreads(boolean fair) {
1375 < //         final PublicReentrantReadWriteLock lock =
1376 < //             new PublicReentrantReadWriteLock(fair);
1377 < //         Thread t1 = new Thread(new InterruptedLockRunnable(lock));
1378 < //         Thread t2 = new Thread(new InterruptibleLockRunnable(lock));
1379 < //         assertTrue(lock.getQueuedThreads().isEmpty());
1380 < //         lock.writeLock().lock();
1381 < //         assertTrue(lock.getQueuedThreads().isEmpty());
1382 < //         t1.start();
1383 < //         waitForQueuedThread(lock, t1);
1384 < //         assertEquals(1, lock.getQueuedThreads().size());
1385 < //         assertTrue(lock.getQueuedThreads().contains(t1));
1386 < //         t2.start();
1387 < //         waitForQueuedThread(lock, t2);
1388 < //         assertEquals(2, lock.getQueuedThreads().size());
1389 < //         assertTrue(lock.getQueuedThreads().contains(t1));
1390 < //         assertTrue(lock.getQueuedThreads().contains(t2));
1391 < //         t1.interrupt();
1392 < //         awaitTermination(t1);
1393 < //         assertFalse(lock.getQueuedThreads().contains(t1));
1394 < //         assertTrue(lock.getQueuedThreads().contains(t2));
1395 < //         assertEquals(1, lock.getQueuedThreads().size());
1396 < //         lock.writeLock().unlock();
1397 < //         awaitTermination(t2);
1398 < //         assertTrue(lock.getQueuedThreads().isEmpty());
1399 < //     }
1400 <
1401 < //     /**
1402 < //      * hasWaiters throws NPE if null
1403 < //      */
1404 < //     public void testHasWaitersNPE()      { testHasWaitersNPE(false); }
1405 < //     public void testHasWaitersNPE_fair() { testHasWaitersNPE(true); }
1406 < //     public void testHasWaitersNPE(boolean fair) {
1407 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1408 < //         try {
1409 < //             lock.hasWaiters(null);
1410 < //             shouldThrow();
1411 < //         } catch (NullPointerException success) {}
1412 < //     }
1413 <
1414 < //     /**
1415 < //      * getWaitQueueLength throws NPE if null
1416 < //      */
1417 < //     public void testGetWaitQueueLengthNPE()      { testGetWaitQueueLengthNPE(false); }
1418 < //     public void testGetWaitQueueLengthNPE_fair() { testGetWaitQueueLengthNPE(true); }
1419 < //     public void testGetWaitQueueLengthNPE(boolean fair) {
1420 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1421 < //         try {
1422 < //             lock.getWaitQueueLength(null);
1423 < //             shouldThrow();
1424 < //         } catch (NullPointerException success) {}
1425 < //     }
1426 <
1427 < //     /**
1428 < //      * getWaitingThreads throws NPE if null
1429 < //      */
1430 < //     public void testGetWaitingThreadsNPE()      { testGetWaitingThreadsNPE(false); }
1431 < //     public void testGetWaitingThreadsNPE_fair() { testGetWaitingThreadsNPE(true); }
1432 < //     public void testGetWaitingThreadsNPE(boolean fair) {
1433 < //         final PublicReentrantReadWriteLock lock = new PublicReentrantReadWriteLock(fair);
1434 < //         try {
1435 < //             lock.getWaitingThreads(null);
1436 < //             shouldThrow();
1437 < //         } catch (NullPointerException success) {}
1438 < //     }
1439 <
1440 < //     /**
1441 < //      * hasWaiters throws IllegalArgumentException if not owned
1442 < //      */
1443 < //     public void testHasWaitersIAE()      { testHasWaitersIAE(false); }
1444 < //     public void testHasWaitersIAE_fair() { testHasWaitersIAE(true); }
1445 < //     public void testHasWaitersIAE(boolean fair) {
1446 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1447 < //         final Condition c = lock.writeLock().newCondition();
1448 < //         final ReentrantReadWriteLock lock2 = new ReentrantReadWriteLock(fair);
1449 < //         try {
1450 < //             lock2.hasWaiters(c);
1451 < //             shouldThrow();
1452 < //         } catch (IllegalArgumentException success) {}
1453 < //     }
1454 <
1455 < //     /**
1456 < //      * hasWaiters throws IllegalMonitorStateException if not locked
1457 < //      */
1458 < //     public void testHasWaitersIMSE()      { testHasWaitersIMSE(false); }
1459 < //     public void testHasWaitersIMSE_fair() { testHasWaitersIMSE(true); }
1460 < //     public void testHasWaitersIMSE(boolean fair) {
1461 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1462 < //         final Condition c = lock.writeLock().newCondition();
1463 < //         try {
1464 < //             lock.hasWaiters(c);
1465 < //             shouldThrow();
1466 < //         } catch (IllegalMonitorStateException success) {}
1467 < //     }
1468 <
1469 < //     /**
1470 < //      * getWaitQueueLength throws IllegalArgumentException if not owned
1471 < //      */
1472 < //     public void testGetWaitQueueLengthIAE()      { testGetWaitQueueLengthIAE(false); }
1473 < //     public void testGetWaitQueueLengthIAE_fair() { testGetWaitQueueLengthIAE(true); }
1474 < //     public void testGetWaitQueueLengthIAE(boolean fair) {
1475 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1476 < //         final Condition c = lock.writeLock().newCondition();
1477 < //         final ReentrantReadWriteLock lock2 = new ReentrantReadWriteLock(fair);
1478 < //         try {
1479 < //             lock2.getWaitQueueLength(c);
1480 < //             shouldThrow();
1481 < //         } catch (IllegalArgumentException success) {}
1482 < //     }
1483 <
1484 < //     /**
1485 < //      * getWaitQueueLength throws IllegalMonitorStateException if not locked
1486 < //      */
1487 < //     public void testGetWaitQueueLengthIMSE()      { testGetWaitQueueLengthIMSE(false); }
1488 < //     public void testGetWaitQueueLengthIMSE_fair() { testGetWaitQueueLengthIMSE(true); }
1489 < //     public void testGetWaitQueueLengthIMSE(boolean fair) {
1490 < //         final ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1491 < //         final Condition c = lock.writeLock().newCondition();
1492 < //         try {
1493 < //             lock.getWaitQueueLength(c);
1494 < //             shouldThrow();
1495 < //         } catch (IllegalMonitorStateException success) {}
1496 < //     }
1482 <
1483 < //     /**
1484 < //      * getWaitingThreads throws IllegalArgumentException if not owned
1485 < //      */
1486 < //     public void testGetWaitingThreadsIAE()      { testGetWaitingThreadsIAE(false); }
1487 < //     public void testGetWaitingThreadsIAE_fair() { testGetWaitingThreadsIAE(true); }
1488 < //     public void testGetWaitingThreadsIAE(boolean fair) {
1489 < //         final PublicReentrantReadWriteLock lock =
1490 < //             new PublicReentrantReadWriteLock(fair);
1491 < //         final Condition c = lock.writeLock().newCondition();
1492 < //         final PublicReentrantReadWriteLock lock2 =
1493 < //             new PublicReentrantReadWriteLock(fair);
1494 < //         try {
1495 < //             lock2.getWaitingThreads(c);
1496 < //             shouldThrow();
1497 < //         } catch (IllegalArgumentException success) {}
1498 < //     }
1499 <
1500 < //     /**
1501 < //      * getWaitingThreads throws IllegalMonitorStateException if not locked
1502 < //      */
1503 < //     public void testGetWaitingThreadsIMSE()      { testGetWaitingThreadsIMSE(false); }
1504 < //     public void testGetWaitingThreadsIMSE_fair() { testGetWaitingThreadsIMSE(true); }
1505 < //     public void testGetWaitingThreadsIMSE(boolean fair) {
1506 < //         final PublicReentrantReadWriteLock lock =
1507 < //             new PublicReentrantReadWriteLock(fair);
1508 < //         final Condition c = lock.writeLock().newCondition();
1509 < //         try {
1510 < //             lock.getWaitingThreads(c);
1511 < //             shouldThrow();
1512 < //         } catch (IllegalMonitorStateException success) {}
1513 < //     }
1514 <
1515 < //     /**
1516 < //      * hasWaiters returns true when a thread is waiting, else false
1517 < //      */
1518 < //     public void testHasWaiters()      { testHasWaiters(false); }
1519 < //     public void testHasWaiters_fair() { testHasWaiters(true); }
1520 < //     public void testHasWaiters(boolean fair) {
1521 < //         final PublicReentrantReadWriteLock lock =
1522 < //             new PublicReentrantReadWriteLock(fair);
1523 < //         final Condition c = lock.writeLock().newCondition();
1524 < //         final CountDownLatch locked = new CountDownLatch(1);
1525 < //         Thread t = newStartedThread(new CheckedRunnable() {
1526 < //             public void realRun() throws InterruptedException {
1527 < //                 lock.writeLock().lock();
1528 < //                 assertHasNoWaiters(lock, c);
1529 < //                 assertFalse(lock.hasWaiters(c));
1530 < //                 locked.countDown();
1531 < //                 c.await();
1532 < //                 assertHasNoWaiters(lock, c);
1533 < //                 assertFalse(lock.hasWaiters(c));
1534 < //                 lock.writeLock().unlock();
1535 < //             }});
1536 <
1537 < //         await(locked);
1538 < //         lock.writeLock().lock();
1539 < //         assertHasWaiters(lock, c, t);
1540 < //         assertTrue(lock.hasWaiters(c));
1541 < //         c.signal();
1542 < //         assertHasNoWaiters(lock, c);
1543 < //         assertFalse(lock.hasWaiters(c));
1544 < //         lock.writeLock().unlock();
1545 < //         awaitTermination(t);
1546 < //         assertHasNoWaiters(lock, c);
1547 < //     }
1548 <
1549 < //     /**
1550 < //      * getWaitQueueLength returns number of waiting threads
1551 < //      */
1552 < //     public void testGetWaitQueueLength()      { testGetWaitQueueLength(false); }
1553 < //     public void testGetWaitQueueLength_fair() { testGetWaitQueueLength(true); }
1554 < //     public void testGetWaitQueueLength(boolean fair) {
1555 < //         final PublicReentrantReadWriteLock lock =
1556 < //             new PublicReentrantReadWriteLock(fair);
1557 < //         final Condition c = lock.writeLock().newCondition();
1558 < //         final CountDownLatch locked = new CountDownLatch(1);
1559 < //         Thread t = newStartedThread(new CheckedRunnable() {
1560 < //             public void realRun() throws InterruptedException {
1561 < //                 lock.writeLock().lock();
1562 < //                 assertEquals(0, lock.getWaitQueueLength(c));
1563 < //                 locked.countDown();
1564 < //                 c.await();
1565 < //                 lock.writeLock().unlock();
1566 < //             }});
1567 <
1568 < //         await(locked);
1569 < //         lock.writeLock().lock();
1570 < //         assertHasWaiters(lock, c, t);
1571 < //         assertEquals(1, lock.getWaitQueueLength(c));
1572 < //         c.signal();
1573 < //         assertHasNoWaiters(lock, c);
1574 < //         assertEquals(0, lock.getWaitQueueLength(c));
1575 < //         lock.writeLock().unlock();
1576 < //         awaitTermination(t);
1577 < //     }
1578 <
1579 < //     /**
1580 < //      * getWaitingThreads returns only and all waiting threads
1581 < //      */
1582 < //     public void testGetWaitingThreads()      { testGetWaitingThreads(false); }
1583 < //     public void testGetWaitingThreads_fair() { testGetWaitingThreads(true); }
1584 < //     public void testGetWaitingThreads(boolean fair) {
1585 < //         final PublicReentrantReadWriteLock lock =
1586 < //             new PublicReentrantReadWriteLock(fair);
1587 < //         final Condition c = lock.writeLock().newCondition();
1588 < //         final CountDownLatch locked1 = new CountDownLatch(1);
1589 < //         final CountDownLatch locked2 = new CountDownLatch(1);
1590 < //         Thread t1 = new Thread(new CheckedRunnable() {
1591 < //             public void realRun() throws InterruptedException {
1592 < //                 lock.writeLock().lock();
1593 < //                 assertTrue(lock.getWaitingThreads(c).isEmpty());
1594 < //                 locked1.countDown();
1595 < //                 c.await();
1596 < //                 lock.writeLock().unlock();
1597 < //             }});
1598 <
1599 < //         Thread t2 = new Thread(new CheckedRunnable() {
1600 < //             public void realRun() throws InterruptedException {
1601 < //                 lock.writeLock().lock();
1602 < //                 assertFalse(lock.getWaitingThreads(c).isEmpty());
1603 < //                 locked2.countDown();
1604 < //                 c.await();
1605 < //                 lock.writeLock().unlock();
1606 < //             }});
1607 <
1608 < //         lock.writeLock().lock();
1609 < //         assertTrue(lock.getWaitingThreads(c).isEmpty());
1610 < //         lock.writeLock().unlock();
1611 <
1612 < //         t1.start();
1613 < //         await(locked1);
1614 < //         t2.start();
1615 < //         await(locked2);
1616 <
1617 < //         lock.writeLock().lock();
1618 < //         assertTrue(lock.hasWaiters(c));
1619 < //         assertTrue(lock.getWaitingThreads(c).contains(t1));
1620 < //         assertTrue(lock.getWaitingThreads(c).contains(t2));
1621 < //         assertEquals(2, lock.getWaitingThreads(c).size());
1622 < //         c.signalAll();
1623 < //         assertHasNoWaiters(lock, c);
1624 < //         lock.writeLock().unlock();
1625 <
1626 < //         awaitTermination(t1);
1627 < //         awaitTermination(t2);
1628 <
1629 < //         assertHasNoWaiters(lock, c);
1630 < //     }
1631 <
1632 < //     /**
1633 < //      * toString indicates current lock state
1634 < //      */
1635 < //     public void testToString()      { testToString(false); }
1636 < //     public void testToString_fair() { testToString(true); }
1637 < //     public void testToString(boolean fair) {
1638 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1639 < //         assertTrue(lock.toString().contains("Write locks = 0"));
1640 < //         assertTrue(lock.toString().contains("Read locks = 0"));
1641 < //         lock.writeLock().lock();
1642 < //         assertTrue(lock.toString().contains("Write locks = 1"));
1643 < //         assertTrue(lock.toString().contains("Read locks = 0"));
1644 < //         lock.writeLock().unlock();
1645 < //         lock.readLock().lock();
1646 < //         lock.readLock().lock();
1647 < //         assertTrue(lock.toString().contains("Write locks = 0"));
1648 < //         assertTrue(lock.toString().contains("Read locks = 2"));
1649 < //     }
1650 <
1651 < //     /**
1652 < //      * readLock.toString indicates current lock state
1653 < //      */
1654 < //     public void testReadLockToString()      { testReadLockToString(false); }
1655 < //     public void testReadLockToString_fair() { testReadLockToString(true); }
1656 < //     public void testReadLockToString(boolean fair) {
1657 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1658 < //         assertTrue(lock.readLock().toString().contains("Read locks = 0"));
1659 < //         lock.readLock().lock();
1660 < //         lock.readLock().lock();
1661 < //         assertTrue(lock.readLock().toString().contains("Read locks = 2"));
1662 < //     }
1663 <
1664 < //     /**
1665 < //      * writeLock.toString indicates current lock state
1666 < //      */
1667 < //     public void testWriteLockToString()      { testWriteLockToString(false); }
1668 < //     public void testWriteLockToString_fair() { testWriteLockToString(true); }
1669 < //     public void testWriteLockToString(boolean fair) {
1670 < //         ReentrantReadWriteLock lock = new ReentrantReadWriteLock(fair);
1671 < //         assertTrue(lock.writeLock().toString().contains("Unlocked"));
1672 < //         lock.writeLock().lock();
1673 < //         assertTrue(lock.writeLock().toString().contains("Locked"));
1674 < //         lock.writeLock().unlock();
1675 < //         assertTrue(lock.writeLock().toString().contains("Unlocked"));
1676 < //     }
42 >    /**
43 >     * Releases write lock, checking isWriteLocked before and after
44 >     */
45 >    void releaseWriteLock(StampedLock lock, long stamp) {
46 >        assertTrue(lock.isWriteLocked());
47 >        assertValid(lock, stamp);
48 >        lock.unlockWrite(stamp);
49 >        assertFalse(lock.isWriteLocked());
50 >        assertFalse(lock.validate(stamp));
51 >    }
52 >
53 >    /**
54 >     * Releases read lock, checking isReadLocked before and after
55 >     */
56 >    void releaseReadLock(StampedLock lock, long stamp) {
57 >        assertTrue(lock.isReadLocked());
58 >        assertValid(lock, stamp);
59 >        lock.unlockRead(stamp);
60 >        assertFalse(lock.isReadLocked());
61 >        assertTrue(lock.validate(stamp));
62 >    }
63 >
64 >    long assertNonZero(long v) {
65 >        assertTrue(v != 0L);
66 >        return v;
67 >    }
68 >
69 >    long assertValid(StampedLock lock, long stamp) {
70 >        assertTrue(stamp != 0L);
71 >        assertTrue(lock.validate(stamp));
72 >        return stamp;
73 >    }
74 >
75 >    void assertUnlocked(StampedLock lock) {
76 >        assertFalse(lock.isReadLocked());
77 >        assertFalse(lock.isWriteLocked());
78 >        assertEquals(0, lock.getReadLockCount());
79 >        assertValid(lock, lock.tryOptimisticRead());
80 >    }
81 >
82 >    List<Action> lockLockers(Lock lock) {
83 >        return List.of(
84 >            () -> lock.lock(),
85 >            () -> lock.lockInterruptibly(),
86 >            () -> lock.tryLock(),
87 >            () -> lock.tryLock(Long.MIN_VALUE, DAYS),
88 >            () -> lock.tryLock(0L, DAYS),
89 >            () -> lock.tryLock(Long.MAX_VALUE, DAYS));
90 >    }
91 >
92 >    List<Function<StampedLock, Long>> readLockers() {
93 >        return List.of(
94 >            sl -> sl.readLock(),
95 >            sl -> sl.tryReadLock(),
96 >            sl -> readLockInterruptiblyUninterrupted(sl),
97 >            sl -> tryReadLockUninterrupted(sl, Long.MIN_VALUE, DAYS),
98 >            sl -> tryReadLockUninterrupted(sl, 0L, DAYS),
99 >            sl -> sl.tryConvertToReadLock(sl.tryOptimisticRead()));
100 >    }
101 >
102 >    List<BiConsumer<StampedLock, Long>> readUnlockers() {
103 >        return List.of(
104 >            (sl, stamp) -> sl.unlockRead(stamp),
105 >            (sl, stamp) -> assertTrue(sl.tryUnlockRead()),
106 >            (sl, stamp) -> sl.asReadLock().unlock(),
107 >            (sl, stamp) -> sl.unlock(stamp),
108 >            (sl, stamp) -> assertValid(sl, sl.tryConvertToOptimisticRead(stamp)));
109 >    }
110 >
111 >    List<Function<StampedLock, Long>> writeLockers() {
112 >        return List.of(
113 >            sl -> sl.writeLock(),
114 >            sl -> sl.tryWriteLock(),
115 >            sl -> writeLockInterruptiblyUninterrupted(sl),
116 >            sl -> tryWriteLockUninterrupted(sl, Long.MIN_VALUE, DAYS),
117 >            sl -> tryWriteLockUninterrupted(sl, 0L, DAYS),
118 >            sl -> sl.tryConvertToWriteLock(sl.tryOptimisticRead()));
119 >    }
120 >
121 >    List<BiConsumer<StampedLock, Long>> writeUnlockers() {
122 >        return List.of(
123 >            (sl, stamp) -> sl.unlockWrite(stamp),
124 >            (sl, stamp) -> assertTrue(sl.tryUnlockWrite()),
125 >            (sl, stamp) -> sl.asWriteLock().unlock(),
126 >            (sl, stamp) -> sl.unlock(stamp),
127 >            (sl, stamp) -> assertValid(sl, sl.tryConvertToOptimisticRead(stamp)));
128 >    }
129 >
130 >    /**
131 >     * Constructed StampedLock is in unlocked state
132 >     */
133 >    public void testConstructor() {
134 >        assertUnlocked(new StampedLock());
135 >    }
136 >
137 >    /**
138 >     * write-locking, then unlocking, an unlocked lock succeed
139 >     */
140 >    public void testWriteLock_lockUnlock() {
141 >        StampedLock lock = new StampedLock();
142 >
143 >        for (Function<StampedLock, Long> writeLocker : writeLockers())
144 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
145 >            assertFalse(lock.isWriteLocked());
146 >            assertFalse(lock.isReadLocked());
147 >            assertEquals(0, lock.getReadLockCount());
148 >
149 >            long s = writeLocker.apply(lock);
150 >            assertValid(lock, s);
151 >            assertTrue(lock.isWriteLocked());
152 >            assertFalse(lock.isReadLocked());
153 >            assertEquals(0, lock.getReadLockCount());
154 >            writeUnlocker.accept(lock, s);
155 >            assertUnlocked(lock);
156 >        }
157 >    }
158 >
159 >    /**
160 >     * read-locking, then unlocking, an unlocked lock succeed
161 >     */
162 >    public void testReadLock_lockUnlock() {
163 >        StampedLock lock = new StampedLock();
164 >
165 >        for (Function<StampedLock, Long> readLocker : readLockers())
166 >        for (BiConsumer<StampedLock, Long> readUnlocker : readUnlockers()) {
167 >            long s = 42;
168 >            for (int i = 0; i < 2; i++) {
169 >                s = assertValid(lock, readLocker.apply(lock));
170 >                assertFalse(lock.isWriteLocked());
171 >                assertTrue(lock.isReadLocked());
172 >                assertEquals(i + 1, lock.getReadLockCount());
173 >            }
174 >            for (int i = 0; i < 2; i++) {
175 >                assertFalse(lock.isWriteLocked());
176 >                assertTrue(lock.isReadLocked());
177 >                assertEquals(2 - i, lock.getReadLockCount());
178 >                readUnlocker.accept(lock, s);
179 >            }
180 >            assertUnlocked(lock);
181 >        }
182 >    }
183 >
184 >    /**
185 >     * tryUnlockWrite fails if not write locked
186 >     */
187 >    public void testTryUnlockWrite_failure() {
188 >        StampedLock lock = new StampedLock();
189 >        assertFalse(lock.tryUnlockWrite());
190 >
191 >        for (Function<StampedLock, Long> readLocker : readLockers())
192 >        for (BiConsumer<StampedLock, Long> readUnlocker : readUnlockers()) {
193 >            long s = assertValid(lock, readLocker.apply(lock));
194 >            assertFalse(lock.tryUnlockWrite());
195 >            assertTrue(lock.isReadLocked());
196 >            readUnlocker.accept(lock, s);
197 >            assertUnlocked(lock);
198 >        }
199 >    }
200 >
201 >    /**
202 >     * tryUnlockRead fails if not read locked
203 >     */
204 >    public void testTryUnlockRead_failure() {
205 >        StampedLock lock = new StampedLock();
206 >        assertFalse(lock.tryUnlockRead());
207 >
208 >        for (Function<StampedLock, Long> writeLocker : writeLockers())
209 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
210 >            long s = writeLocker.apply(lock);
211 >            assertFalse(lock.tryUnlockRead());
212 >            assertTrue(lock.isWriteLocked());
213 >            writeUnlocker.accept(lock, s);
214 >            assertUnlocked(lock);
215 >        }
216 >    }
217 >
218 >    /**
219 >     * validate(0L) fails
220 >     */
221 >    public void testValidate0() {
222 >        StampedLock lock = new StampedLock();
223 >        assertFalse(lock.validate(0L));
224 >    }
225 >
226 >    /**
227 >     * A stamp obtained from a successful lock operation validates while the lock is held
228 >     */
229 >    public void testValidate() throws InterruptedException {
230 >        StampedLock lock = new StampedLock();
231 >
232 >        for (Function<StampedLock, Long> readLocker : readLockers())
233 >        for (BiConsumer<StampedLock, Long> readUnlocker : readUnlockers()) {
234 >            long s = assertNonZero(readLocker.apply(lock));
235 >            assertTrue(lock.validate(s));
236 >            readUnlocker.accept(lock, s);
237 >        }
238 >
239 >        for (Function<StampedLock, Long> writeLocker : writeLockers())
240 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
241 >            long s = assertNonZero(writeLocker.apply(lock));
242 >            assertTrue(lock.validate(s));
243 >            writeUnlocker.accept(lock, s);
244 >        }
245 >    }
246 >
247 >    /**
248 >     * A stamp obtained from an unsuccessful lock operation does not validate
249 >     */
250 >    public void testValidate2() throws InterruptedException {
251 >        StampedLock lock = new StampedLock();
252 >        long s = assertNonZero(lock.writeLock());
253 >        assertTrue(lock.validate(s));
254 >        assertFalse(lock.validate(lock.tryWriteLock()));
255 >        assertFalse(lock.validate(lock.tryWriteLock(randomExpiredTimeout(),
256 >                                                    randomTimeUnit())));
257 >        assertFalse(lock.validate(lock.tryReadLock()));
258 >        assertFalse(lock.validate(lock.tryWriteLock(randomExpiredTimeout(),
259 >                                                    randomTimeUnit())));
260 >        assertFalse(lock.validate(lock.tryOptimisticRead()));
261 >        lock.unlockWrite(s);
262 >    }
263 >
264 >    void assertThrowInterruptedExceptionWhenPreInterrupted(Action[] actions) {
265 >        for (Action action : actions) {
266 >            Thread.currentThread().interrupt();
267 >            try {
268 >                action.run();
269 >                shouldThrow();
270 >            }
271 >            catch (InterruptedException success) {}
272 >            catch (Throwable fail) { threadUnexpectedException(fail); }
273 >            assertFalse(Thread.interrupted());
274 >        }
275 >    }
276 >
277 >    /**
278 >     * interruptible operations throw InterruptedException when pre-interrupted
279 >     */
280 >    public void testInterruptibleOperationsThrowInterruptedExceptionWhenPreInterrupted() {
281 >        final StampedLock lock = new StampedLock();
282 >
283 >        Action[] interruptibleLockActions = {
284 >            () -> lock.writeLockInterruptibly(),
285 >            () -> lock.tryWriteLock(Long.MIN_VALUE, DAYS),
286 >            () -> lock.tryWriteLock(Long.MAX_VALUE, DAYS),
287 >            () -> lock.readLockInterruptibly(),
288 >            () -> lock.tryReadLock(Long.MIN_VALUE, DAYS),
289 >            () -> lock.tryReadLock(Long.MAX_VALUE, DAYS),
290 >            () -> lock.asWriteLock().lockInterruptibly(),
291 >            () -> lock.asWriteLock().tryLock(0L, DAYS),
292 >            () -> lock.asWriteLock().tryLock(Long.MAX_VALUE, DAYS),
293 >            () -> lock.asReadLock().lockInterruptibly(),
294 >            () -> lock.asReadLock().tryLock(0L, DAYS),
295 >            () -> lock.asReadLock().tryLock(Long.MAX_VALUE, DAYS),
296 >        };
297 >        shuffle(interruptibleLockActions);
298 >
299 >        assertThrowInterruptedExceptionWhenPreInterrupted(interruptibleLockActions);
300 >        {
301 >            long s = lock.writeLock();
302 >            assertThrowInterruptedExceptionWhenPreInterrupted(interruptibleLockActions);
303 >            lock.unlockWrite(s);
304 >        }
305 >        {
306 >            long s = lock.readLock();
307 >            assertThrowInterruptedExceptionWhenPreInterrupted(interruptibleLockActions);
308 >            lock.unlockRead(s);
309 >        }
310 >    }
311 >
312 >    void assertThrowInterruptedExceptionWhenInterrupted(Action[] actions) {
313 >        int n = actions.length;
314 >        Future<?>[] futures = new Future<?>[n];
315 >        CountDownLatch threadsStarted = new CountDownLatch(n);
316 >        CountDownLatch done = new CountDownLatch(n);
317 >
318 >        for (int i = 0; i < n; i++) {
319 >            Action action = actions[i];
320 >            futures[i] = cachedThreadPool.submit(new CheckedRunnable() {
321 >                public void realRun() throws Throwable {
322 >                    threadsStarted.countDown();
323 >                    try {
324 >                        action.run();
325 >                        shouldThrow();
326 >                    }
327 >                    catch (InterruptedException success) {}
328 >                    catch (Throwable fail) { threadUnexpectedException(fail); }
329 >                    assertFalse(Thread.interrupted());
330 >                    done.countDown();
331 >                }});
332 >        }
333 >
334 >        await(threadsStarted);
335 >        assertEquals(n, done.getCount());
336 >        for (Future<?> future : futures) // Interrupt all the tasks
337 >            future.cancel(true);
338 >        await(done);
339 >    }
340 >
341 >    /**
342 >     * interruptible operations throw InterruptedException when write locked and interrupted
343 >     */
344 >    public void testInterruptibleOperationsThrowInterruptedExceptionWriteLockedInterrupted() {
345 >        final StampedLock lock = new StampedLock();
346 >        long s = lock.writeLock();
347 >
348 >        Action[] interruptibleLockBlockingActions = {
349 >            () -> lock.writeLockInterruptibly(),
350 >            () -> lock.tryWriteLock(Long.MAX_VALUE, DAYS),
351 >            () -> lock.readLockInterruptibly(),
352 >            () -> lock.tryReadLock(Long.MAX_VALUE, DAYS),
353 >            () -> lock.asWriteLock().lockInterruptibly(),
354 >            () -> lock.asWriteLock().tryLock(Long.MAX_VALUE, DAYS),
355 >            () -> lock.asReadLock().lockInterruptibly(),
356 >            () -> lock.asReadLock().tryLock(Long.MAX_VALUE, DAYS),
357 >        };
358 >        shuffle(interruptibleLockBlockingActions);
359 >
360 >        assertThrowInterruptedExceptionWhenInterrupted(interruptibleLockBlockingActions);
361 >    }
362 >
363 >    /**
364 >     * interruptible operations throw InterruptedException when read locked and interrupted
365 >     */
366 >    public void testInterruptibleOperationsThrowInterruptedExceptionReadLockedInterrupted() {
367 >        final StampedLock lock = new StampedLock();
368 >        long s = lock.readLock();
369 >
370 >        Action[] interruptibleLockBlockingActions = {
371 >            () -> lock.writeLockInterruptibly(),
372 >            () -> lock.tryWriteLock(Long.MAX_VALUE, DAYS),
373 >            () -> lock.asWriteLock().lockInterruptibly(),
374 >            () -> lock.asWriteLock().tryLock(Long.MAX_VALUE, DAYS),
375 >        };
376 >        shuffle(interruptibleLockBlockingActions);
377 >
378 >        assertThrowInterruptedExceptionWhenInterrupted(interruptibleLockBlockingActions);
379 >    }
380 >
381 >    /**
382 >     * Non-interruptible operations ignore and preserve interrupt status
383 >     */
384 >    public void testNonInterruptibleOperationsIgnoreInterrupts() {
385 >        final StampedLock lock = new StampedLock();
386 >        Thread.currentThread().interrupt();
387 >
388 >        for (BiConsumer<StampedLock, Long> readUnlocker : readUnlockers()) {
389 >            long s = assertValid(lock, lock.readLock());
390 >            readUnlocker.accept(lock, s);
391 >            s = assertValid(lock, lock.tryReadLock());
392 >            readUnlocker.accept(lock, s);
393 >        }
394 >
395 >        lock.asReadLock().lock();
396 >        lock.asReadLock().unlock();
397 >
398 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
399 >            long s = assertValid(lock, lock.writeLock());
400 >            writeUnlocker.accept(lock, s);
401 >            s = assertValid(lock, lock.tryWriteLock());
402 >            writeUnlocker.accept(lock, s);
403 >        }
404 >
405 >        lock.asWriteLock().lock();
406 >        lock.asWriteLock().unlock();
407 >
408 >        assertTrue(Thread.interrupted());
409 >    }
410 >
411 >    /**
412 >     * tryWriteLock on an unlocked lock succeeds
413 >     */
414 >    public void testTryWriteLock() {
415 >        final StampedLock lock = new StampedLock();
416 >        long s = lock.tryWriteLock();
417 >        assertTrue(s != 0L);
418 >        assertTrue(lock.isWriteLocked());
419 >        assertEquals(0L, lock.tryWriteLock());
420 >        releaseWriteLock(lock, s);
421 >    }
422 >
423 >    /**
424 >     * tryWriteLock fails if locked
425 >     */
426 >    public void testTryWriteLockWhenLocked() {
427 >        final StampedLock lock = new StampedLock();
428 >        long s = lock.writeLock();
429 >        Thread t = newStartedThread(new CheckedRunnable() {
430 >            public void realRun() {
431 >                assertEquals(0L, lock.tryWriteLock());
432 >            }});
433 >
434 >        assertEquals(0L, lock.tryWriteLock());
435 >        awaitTermination(t);
436 >        releaseWriteLock(lock, s);
437 >    }
438 >
439 >    /**
440 >     * tryReadLock fails if write-locked
441 >     */
442 >    public void testTryReadLockWhenLocked() {
443 >        final StampedLock lock = new StampedLock();
444 >        long s = lock.writeLock();
445 >        Thread t = newStartedThread(new CheckedRunnable() {
446 >            public void realRun() {
447 >                assertEquals(0L, lock.tryReadLock());
448 >            }});
449 >
450 >        assertEquals(0L, lock.tryReadLock());
451 >        awaitTermination(t);
452 >        releaseWriteLock(lock, s);
453 >    }
454 >
455 >    /**
456 >     * Multiple threads can hold a read lock when not write-locked
457 >     */
458 >    public void testMultipleReadLocks() {
459 >        final StampedLock lock = new StampedLock();
460 >        final long s = lock.readLock();
461 >        Thread t = newStartedThread(new CheckedRunnable() {
462 >            public void realRun() throws InterruptedException {
463 >                long s2 = lock.tryReadLock();
464 >                assertValid(lock, s2);
465 >                lock.unlockRead(s2);
466 >                long s3 = lock.tryReadLock(LONG_DELAY_MS, MILLISECONDS);
467 >                assertValid(lock, s3);
468 >                lock.unlockRead(s3);
469 >                long s4 = lock.readLock();
470 >                assertValid(lock, s4);
471 >                lock.unlockRead(s4);
472 >                lock.asReadLock().lock();
473 >                lock.asReadLock().unlock();
474 >                lock.asReadLock().lockInterruptibly();
475 >                lock.asReadLock().unlock();
476 >                lock.asReadLock().tryLock(Long.MIN_VALUE, DAYS);
477 >                lock.asReadLock().unlock();
478 >            }});
479 >
480 >        awaitTermination(t);
481 >        lock.unlockRead(s);
482 >    }
483 >
484 >    /**
485 >     * writeLock() succeeds only after a reading thread unlocks
486 >     */
487 >    public void testWriteAfterReadLock() throws InterruptedException {
488 >        final CountDownLatch aboutToLock = new CountDownLatch(1);
489 >        final StampedLock lock = new StampedLock();
490 >        long rs = lock.readLock();
491 >        Thread t = newStartedThread(new CheckedRunnable() {
492 >            public void realRun() {
493 >                aboutToLock.countDown();
494 >                long s = lock.writeLock();
495 >                assertTrue(lock.isWriteLocked());
496 >                assertFalse(lock.isReadLocked());
497 >                lock.unlockWrite(s);
498 >            }});
499 >
500 >        await(aboutToLock);
501 >        assertThreadBlocks(t, Thread.State.WAITING);
502 >        assertFalse(lock.isWriteLocked());
503 >        assertTrue(lock.isReadLocked());
504 >        lock.unlockRead(rs);
505 >        awaitTermination(t);
506 >        assertUnlocked(lock);
507 >    }
508 >
509 >    /**
510 >     * writeLock() succeeds only after reading threads unlock
511 >     */
512 >    public void testWriteAfterMultipleReadLocks() {
513 >        final StampedLock lock = new StampedLock();
514 >        long s = lock.readLock();
515 >        Thread t1 = newStartedThread(new CheckedRunnable() {
516 >            public void realRun() {
517 >                long rs = lock.readLock();
518 >                lock.unlockRead(rs);
519 >            }});
520 >
521 >        awaitTermination(t1);
522 >
523 >        Thread t2 = newStartedThread(new CheckedRunnable() {
524 >            public void realRun() {
525 >                long ws = lock.writeLock();
526 >                lock.unlockWrite(ws);
527 >            }});
528 >
529 >        assertTrue(lock.isReadLocked());
530 >        assertFalse(lock.isWriteLocked());
531 >        lock.unlockRead(s);
532 >        awaitTermination(t2);
533 >        assertUnlocked(lock);
534 >    }
535 >
536 >    /**
537 >     * readLock() succeed only after a writing thread unlocks
538 >     */
539 >    public void testReadAfterWriteLock() {
540 >        final StampedLock lock = new StampedLock();
541 >        final CountDownLatch threadsStarted = new CountDownLatch(2);
542 >        final long s = lock.writeLock();
543 >        final Runnable acquireReleaseReadLock = new CheckedRunnable() {
544 >            public void realRun() {
545 >                threadsStarted.countDown();
546 >                long rs = lock.readLock();
547 >                assertTrue(lock.isReadLocked());
548 >                assertFalse(lock.isWriteLocked());
549 >                lock.unlockRead(rs);
550 >            }};
551 >        Thread t1 = newStartedThread(acquireReleaseReadLock);
552 >        Thread t2 = newStartedThread(acquireReleaseReadLock);
553 >
554 >        await(threadsStarted);
555 >        assertThreadBlocks(t1, Thread.State.WAITING);
556 >        assertThreadBlocks(t2, Thread.State.WAITING);
557 >        assertTrue(lock.isWriteLocked());
558 >        assertFalse(lock.isReadLocked());
559 >        releaseWriteLock(lock, s);
560 >        awaitTermination(t1);
561 >        awaitTermination(t2);
562 >        assertUnlocked(lock);
563 >    }
564 >
565 >    /**
566 >     * tryReadLock succeeds if read locked but not write locked
567 >     */
568 >    public void testTryLockWhenReadLocked() {
569 >        final StampedLock lock = new StampedLock();
570 >        long s = lock.readLock();
571 >        Thread t = newStartedThread(new CheckedRunnable() {
572 >            public void realRun() {
573 >                long rs = lock.tryReadLock();
574 >                assertValid(lock, rs);
575 >                lock.unlockRead(rs);
576 >            }});
577 >
578 >        awaitTermination(t);
579 >        lock.unlockRead(s);
580 >    }
581 >
582 >    /**
583 >     * tryWriteLock fails when read locked
584 >     */
585 >    public void testTryWriteLockWhenReadLocked() {
586 >        final StampedLock lock = new StampedLock();
587 >        long s = lock.readLock();
588 >        Thread t = newStartedThread(new CheckedRunnable() {
589 >            public void realRun() {
590 >                assertEquals(0L, lock.tryWriteLock());
591 >            }});
592 >
593 >        awaitTermination(t);
594 >        lock.unlockRead(s);
595 >    }
596 >
597 >    /**
598 >     * timed lock operations time out if lock not available
599 >     */
600 >    public void testTimedLock_Timeout() throws Exception {
601 >        ArrayList<Future<?>> futures = new ArrayList<>();
602 >
603 >        // Write locked
604 >        final StampedLock lock = new StampedLock();
605 >        long stamp = lock.writeLock();
606 >        assertEquals(0L, lock.tryReadLock(0L, DAYS));
607 >        assertEquals(0L, lock.tryReadLock(Long.MIN_VALUE, DAYS));
608 >        assertFalse(lock.asReadLock().tryLock(0L, DAYS));
609 >        assertFalse(lock.asReadLock().tryLock(Long.MIN_VALUE, DAYS));
610 >        assertEquals(0L, lock.tryWriteLock(0L, DAYS));
611 >        assertEquals(0L, lock.tryWriteLock(Long.MIN_VALUE, DAYS));
612 >        assertFalse(lock.asWriteLock().tryLock(0L, DAYS));
613 >        assertFalse(lock.asWriteLock().tryLock(Long.MIN_VALUE, DAYS));
614 >
615 >        futures.add(cachedThreadPool.submit(new CheckedRunnable() {
616 >            public void realRun() throws InterruptedException {
617 >                long startTime = System.nanoTime();
618 >                assertEquals(0L, lock.tryWriteLock(timeoutMillis(), MILLISECONDS));
619 >                assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
620 >            }}));
621 >
622 >        futures.add(cachedThreadPool.submit(new CheckedRunnable() {
623 >            public void realRun() throws InterruptedException {
624 >                long startTime = System.nanoTime();
625 >                assertEquals(0L, lock.tryReadLock(timeoutMillis(), MILLISECONDS));
626 >                assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
627 >            }}));
628 >
629 >        // Read locked
630 >        final StampedLock lock2 = new StampedLock();
631 >        long stamp2 = lock2.readLock();
632 >        assertEquals(0L, lock2.tryWriteLock(0L, DAYS));
633 >        assertEquals(0L, lock2.tryWriteLock(Long.MIN_VALUE, DAYS));
634 >        assertFalse(lock2.asWriteLock().tryLock(0L, DAYS));
635 >        assertFalse(lock2.asWriteLock().tryLock(Long.MIN_VALUE, DAYS));
636 >
637 >        futures.add(cachedThreadPool.submit(new CheckedRunnable() {
638 >            public void realRun() throws InterruptedException {
639 >                long startTime = System.nanoTime();
640 >                assertEquals(0L, lock2.tryWriteLock(timeoutMillis(), MILLISECONDS));
641 >                assertTrue(millisElapsedSince(startTime) >= timeoutMillis());
642 >            }}));
643 >
644 >        for (Future<?> future : futures)
645 >            assertNull(future.get());
646 >
647 >        releaseWriteLock(lock, stamp);
648 >        releaseReadLock(lock2, stamp2);
649 >    }
650 >
651 >    /**
652 >     * writeLockInterruptibly succeeds if unlocked
653 >     */
654 >    public void testWriteLockInterruptibly() throws InterruptedException {
655 >        final StampedLock lock = new StampedLock();
656 >        long s = lock.writeLockInterruptibly();
657 >        assertTrue(lock.isWriteLocked());
658 >        releaseWriteLock(lock, s);
659 >    }
660 >
661 >    /**
662 >     * readLockInterruptibly succeeds if lock free
663 >     */
664 >    public void testReadLockInterruptibly() throws InterruptedException {
665 >        final StampedLock lock = new StampedLock();
666 >
667 >        long s = assertValid(lock, lock.readLockInterruptibly());
668 >        assertTrue(lock.isReadLocked());
669 >        lock.unlockRead(s);
670 >
671 >        lock.asReadLock().lockInterruptibly();
672 >        assertTrue(lock.isReadLocked());
673 >        lock.asReadLock().unlock();
674 >    }
675 >
676 >    /**
677 >     * A serialized lock deserializes as unlocked
678 >     */
679 >    public void testSerialization() {
680 >        StampedLock lock = new StampedLock();
681 >        lock.writeLock();
682 >        StampedLock clone = serialClone(lock);
683 >        assertTrue(lock.isWriteLocked());
684 >        assertFalse(clone.isWriteLocked());
685 >        long s = clone.writeLock();
686 >        assertTrue(clone.isWriteLocked());
687 >        clone.unlockWrite(s);
688 >        assertFalse(clone.isWriteLocked());
689 >    }
690 >
691 >    /**
692 >     * toString indicates current lock state
693 >     */
694 >    public void testToString() {
695 >        StampedLock lock = new StampedLock();
696 >        assertTrue(lock.toString().contains("Unlocked"));
697 >        long s = lock.writeLock();
698 >        assertTrue(lock.toString().contains("Write-locked"));
699 >        lock.unlockWrite(s);
700 >        s = lock.readLock();
701 >        assertTrue(lock.toString().contains("Read-locks"));
702 >    }
703 >
704 >    /**
705 >     * tryOptimisticRead succeeds and validates if unlocked, fails if
706 >     * exclusively locked
707 >     */
708 >    public void testValidateOptimistic() throws InterruptedException {
709 >        StampedLock lock = new StampedLock();
710 >
711 >        assertValid(lock, lock.tryOptimisticRead());
712 >
713 >        for (Function<StampedLock, Long> writeLocker : writeLockers()) {
714 >            long s = assertValid(lock, writeLocker.apply(lock));
715 >            assertEquals(0L, lock.tryOptimisticRead());
716 >            releaseWriteLock(lock, s);
717 >        }
718 >
719 >        for (Function<StampedLock, Long> readLocker : readLockers()) {
720 >            long s = assertValid(lock, readLocker.apply(lock));
721 >            long p = assertValid(lock, lock.tryOptimisticRead());
722 >            releaseReadLock(lock, s);
723 >            assertTrue(lock.validate(p));
724 >        }
725 >
726 >        assertValid(lock, lock.tryOptimisticRead());
727 >    }
728 >
729 >    /**
730 >     * tryOptimisticRead stamp does not validate if a write lock intervenes
731 >     */
732 >    public void testValidateOptimisticWriteLocked() {
733 >        final StampedLock lock = new StampedLock();
734 >        final long p = assertValid(lock, lock.tryOptimisticRead());
735 >        final long s = assertValid(lock, lock.writeLock());
736 >        assertFalse(lock.validate(p));
737 >        assertEquals(0L, lock.tryOptimisticRead());
738 >        assertTrue(lock.validate(s));
739 >        lock.unlockWrite(s);
740 >    }
741 >
742 >    /**
743 >     * tryOptimisticRead stamp does not validate if a write lock
744 >     * intervenes in another thread
745 >     */
746 >    public void testValidateOptimisticWriteLocked2()
747 >            throws InterruptedException {
748 >        final CountDownLatch locked = new CountDownLatch(1);
749 >        final StampedLock lock = new StampedLock();
750 >        final long p = assertValid(lock, lock.tryOptimisticRead());
751 >
752 >        Thread t = newStartedThread(new CheckedInterruptedRunnable() {
753 >            public void realRun() throws InterruptedException {
754 >                lock.writeLockInterruptibly();
755 >                locked.countDown();
756 >                lock.writeLockInterruptibly();
757 >            }});
758 >
759 >        await(locked);
760 >        assertFalse(lock.validate(p));
761 >        assertEquals(0L, lock.tryOptimisticRead());
762 >        assertThreadBlocks(t, Thread.State.WAITING);
763 >        t.interrupt();
764 >        awaitTermination(t);
765 >        assertTrue(lock.isWriteLocked());
766 >    }
767 >
768 >    /**
769 >     * tryConvertToOptimisticRead succeeds and validates if successfully locked
770 >     */
771 >    public void testTryConvertToOptimisticRead() throws InterruptedException {
772 >        StampedLock lock = new StampedLock();
773 >        long s, p, q;
774 >        assertEquals(0L, lock.tryConvertToOptimisticRead(0L));
775 >
776 >        s = assertValid(lock, lock.tryOptimisticRead());
777 >        assertEquals(s, lock.tryConvertToOptimisticRead(s));
778 >        assertTrue(lock.validate(s));
779 >
780 >        for (Function<StampedLock, Long> writeLocker : writeLockers()) {
781 >            s = assertValid(lock, writeLocker.apply(lock));
782 >            p = assertValid(lock, lock.tryConvertToOptimisticRead(s));
783 >            assertFalse(lock.validate(s));
784 >            assertTrue(lock.validate(p));
785 >            assertUnlocked(lock);
786 >        }
787 >
788 >        for (Function<StampedLock, Long> readLocker : readLockers()) {
789 >            s = assertValid(lock, readLocker.apply(lock));
790 >            q = assertValid(lock, lock.tryOptimisticRead());
791 >            assertEquals(q, lock.tryConvertToOptimisticRead(q));
792 >            assertTrue(lock.validate(q));
793 >            assertTrue(lock.isReadLocked());
794 >            p = assertValid(lock, lock.tryConvertToOptimisticRead(s));
795 >            assertTrue(lock.validate(p));
796 >            assertTrue(lock.validate(s));
797 >            assertUnlocked(lock);
798 >            assertEquals(q, lock.tryConvertToOptimisticRead(q));
799 >            assertTrue(lock.validate(q));
800 >        }
801 >    }
802 >
803 >    /**
804 >     * tryConvertToReadLock succeeds for valid stamps
805 >     */
806 >    public void testTryConvertToReadLock() throws InterruptedException {
807 >        StampedLock lock = new StampedLock();
808 >        long s, p;
809 >
810 >        assertEquals(0L, lock.tryConvertToReadLock(0L));
811 >
812 >        s = assertValid(lock, lock.tryOptimisticRead());
813 >        p = assertValid(lock, lock.tryConvertToReadLock(s));
814 >        assertTrue(lock.isReadLocked());
815 >        assertEquals(1, lock.getReadLockCount());
816 >        assertTrue(lock.validate(s));
817 >        lock.unlockRead(p);
818 >
819 >        s = assertValid(lock, lock.tryOptimisticRead());
820 >        lock.readLock();
821 >        p = assertValid(lock, lock.tryConvertToReadLock(s));
822 >        assertTrue(lock.isReadLocked());
823 >        assertEquals(2, lock.getReadLockCount());
824 >        lock.unlockRead(p);
825 >        lock.unlockRead(p);
826 >        assertUnlocked(lock);
827 >
828 >        for (BiConsumer<StampedLock, Long> readUnlocker : readUnlockers()) {
829 >            for (Function<StampedLock, Long> writeLocker : writeLockers()) {
830 >                s = assertValid(lock, writeLocker.apply(lock));
831 >                p = assertValid(lock, lock.tryConvertToReadLock(s));
832 >                assertFalse(lock.validate(s));
833 >                assertTrue(lock.isReadLocked());
834 >                assertEquals(1, lock.getReadLockCount());
835 >                readUnlocker.accept(lock, p);
836 >            }
837 >
838 >            for (Function<StampedLock, Long> readLocker : readLockers()) {
839 >                s = assertValid(lock, readLocker.apply(lock));
840 >                assertEquals(s, lock.tryConvertToReadLock(s));
841 >                assertTrue(lock.validate(s));
842 >                assertTrue(lock.isReadLocked());
843 >                assertEquals(1, lock.getReadLockCount());
844 >                readUnlocker.accept(lock, s);
845 >            }
846 >        }
847 >    }
848 >
849 >    /**
850 >     * tryConvertToWriteLock succeeds if lock available; fails if multiply read locked
851 >     */
852 >    public void testTryConvertToWriteLock() throws InterruptedException {
853 >        StampedLock lock = new StampedLock();
854 >        long s, p;
855 >
856 >        assertEquals(0L, lock.tryConvertToWriteLock(0L));
857 >
858 >        assertTrue((s = lock.tryOptimisticRead()) != 0L);
859 >        assertTrue((p = lock.tryConvertToWriteLock(s)) != 0L);
860 >        assertTrue(lock.isWriteLocked());
861 >        lock.unlockWrite(p);
862 >
863 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
864 >            for (Function<StampedLock, Long> writeLocker : writeLockers()) {
865 >                s = assertValid(lock, writeLocker.apply(lock));
866 >                assertEquals(s, lock.tryConvertToWriteLock(s));
867 >                assertTrue(lock.validate(s));
868 >                assertTrue(lock.isWriteLocked());
869 >                writeUnlocker.accept(lock, s);
870 >            }
871 >
872 >            for (Function<StampedLock, Long> readLocker : readLockers()) {
873 >                s = assertValid(lock, readLocker.apply(lock));
874 >                p = assertValid(lock, lock.tryConvertToWriteLock(s));
875 >                assertFalse(lock.validate(s));
876 >                assertTrue(lock.validate(p));
877 >                assertTrue(lock.isWriteLocked());
878 >                writeUnlocker.accept(lock, p);
879 >            }
880 >        }
881 >
882 >        // failure if multiply read locked
883 >        for (Function<StampedLock, Long> readLocker : readLockers()) {
884 >            s = assertValid(lock, readLocker.apply(lock));
885 >            p = assertValid(lock, readLocker.apply(lock));
886 >            assertEquals(0L, lock.tryConvertToWriteLock(s));
887 >            assertTrue(lock.validate(s));
888 >            assertTrue(lock.validate(p));
889 >            assertEquals(2, lock.getReadLockCount());
890 >            lock.unlock(p);
891 >            lock.unlock(s);
892 >            assertUnlocked(lock);
893 >        }
894 >    }
895 >
896 >    /**
897 >     * asWriteLock can be locked and unlocked
898 >     */
899 >    public void testAsWriteLock() throws Throwable {
900 >        StampedLock sl = new StampedLock();
901 >        Lock lock = sl.asWriteLock();
902 >        for (Action locker : lockLockers(lock)) {
903 >            locker.run();
904 >            assertTrue(sl.isWriteLocked());
905 >            assertFalse(sl.isReadLocked());
906 >            assertFalse(lock.tryLock());
907 >            lock.unlock();
908 >            assertUnlocked(sl);
909 >        }
910 >    }
911 >
912 >    /**
913 >     * asReadLock can be locked and unlocked
914 >     */
915 >    public void testAsReadLock() throws Throwable {
916 >        StampedLock sl = new StampedLock();
917 >        Lock lock = sl.asReadLock();
918 >        for (Action locker : lockLockers(lock)) {
919 >            locker.run();
920 >            assertTrue(sl.isReadLocked());
921 >            assertFalse(sl.isWriteLocked());
922 >            assertEquals(1, sl.getReadLockCount());
923 >            locker.run();
924 >            assertTrue(sl.isReadLocked());
925 >            assertEquals(2, sl.getReadLockCount());
926 >            lock.unlock();
927 >            lock.unlock();
928 >            assertUnlocked(sl);
929 >        }
930 >    }
931 >
932 >    /**
933 >     * asReadWriteLock.writeLock can be locked and unlocked
934 >     */
935 >    public void testAsReadWriteLockWriteLock() throws Throwable {
936 >        StampedLock sl = new StampedLock();
937 >        Lock lock = sl.asReadWriteLock().writeLock();
938 >        for (Action locker : lockLockers(lock)) {
939 >            locker.run();
940 >            assertTrue(sl.isWriteLocked());
941 >            assertFalse(sl.isReadLocked());
942 >            assertFalse(lock.tryLock());
943 >            lock.unlock();
944 >            assertUnlocked(sl);
945 >        }
946 >    }
947 >
948 >    /**
949 >     * asReadWriteLock.readLock can be locked and unlocked
950 >     */
951 >    public void testAsReadWriteLockReadLock() throws Throwable {
952 >        StampedLock sl = new StampedLock();
953 >        Lock lock = sl.asReadWriteLock().readLock();
954 >        for (Action locker : lockLockers(lock)) {
955 >            locker.run();
956 >            assertTrue(sl.isReadLocked());
957 >            assertFalse(sl.isWriteLocked());
958 >            assertEquals(1, sl.getReadLockCount());
959 >            locker.run();
960 >            assertTrue(sl.isReadLocked());
961 >            assertEquals(2, sl.getReadLockCount());
962 >            lock.unlock();
963 >            lock.unlock();
964 >            assertUnlocked(sl);
965 >        }
966 >    }
967 >
968 >    /**
969 >     * Lock.newCondition throws UnsupportedOperationException
970 >     */
971 >    public void testLockViewsDoNotSupportConditions() {
972 >        StampedLock sl = new StampedLock();
973 >        assertThrows(UnsupportedOperationException.class,
974 >                     () -> sl.asWriteLock().newCondition(),
975 >                     () -> sl.asReadLock().newCondition(),
976 >                     () -> sl.asReadWriteLock().writeLock().newCondition(),
977 >                     () -> sl.asReadWriteLock().readLock().newCondition());
978 >    }
979 >
980 >    /**
981 >     * Passing optimistic read stamps to unlock operations result in
982 >     * IllegalMonitorStateException
983 >     */
984 >    public void testCannotUnlockOptimisticReadStamps() {
985 >        {
986 >            StampedLock sl = new StampedLock();
987 >            long stamp = assertValid(sl, sl.tryOptimisticRead());
988 >            assertThrows(IllegalMonitorStateException.class,
989 >                () -> sl.unlockRead(stamp));
990 >        }
991 >        {
992 >            StampedLock sl = new StampedLock();
993 >            long stamp = sl.tryOptimisticRead();
994 >            assertThrows(IllegalMonitorStateException.class,
995 >                () -> sl.unlock(stamp));
996 >        }
997 >
998 >        {
999 >            StampedLock sl = new StampedLock();
1000 >            long stamp = sl.tryOptimisticRead();
1001 >            sl.writeLock();
1002 >            assertThrows(IllegalMonitorStateException.class,
1003 >                () -> sl.unlock(stamp));
1004 >        }
1005 >        {
1006 >            StampedLock sl = new StampedLock();
1007 >            sl.readLock();
1008 >            long stamp = assertValid(sl, sl.tryOptimisticRead());
1009 >            assertThrows(IllegalMonitorStateException.class,
1010 >                () -> sl.unlockRead(stamp));
1011 >        }
1012 >        {
1013 >            StampedLock sl = new StampedLock();
1014 >            sl.readLock();
1015 >            long stamp = assertValid(sl, sl.tryOptimisticRead());
1016 >            assertThrows(IllegalMonitorStateException.class,
1017 >                () -> sl.unlock(stamp));
1018 >        }
1019 >
1020 >        {
1021 >            StampedLock sl = new StampedLock();
1022 >            long stamp = sl.tryConvertToOptimisticRead(sl.writeLock());
1023 >            assertValid(sl, stamp);
1024 >            sl.writeLock();
1025 >            assertThrows(IllegalMonitorStateException.class,
1026 >                () -> sl.unlockWrite(stamp));
1027 >        }
1028 >        {
1029 >            StampedLock sl = new StampedLock();
1030 >            long stamp = sl.tryConvertToOptimisticRead(sl.writeLock());
1031 >            sl.writeLock();
1032 >            assertThrows(IllegalMonitorStateException.class,
1033 >                () -> sl.unlock(stamp));
1034 >        }
1035 >        {
1036 >            StampedLock sl = new StampedLock();
1037 >            long stamp = sl.tryConvertToOptimisticRead(sl.writeLock());
1038 >            sl.readLock();
1039 >            assertThrows(IllegalMonitorStateException.class,
1040 >                () -> sl.unlockRead(stamp));
1041 >        }
1042 >        {
1043 >            StampedLock sl = new StampedLock();
1044 >            long stamp = sl.tryConvertToOptimisticRead(sl.writeLock());
1045 >            sl.readLock();
1046 >            assertThrows(IllegalMonitorStateException.class,
1047 >                () -> sl.unlock(stamp));
1048 >        }
1049 >
1050 >        {
1051 >            StampedLock sl = new StampedLock();
1052 >            long stamp = sl.tryConvertToOptimisticRead(sl.readLock());
1053 >            assertValid(sl, stamp);
1054 >            sl.writeLock();
1055 >            assertThrows(IllegalMonitorStateException.class,
1056 >                () -> sl.unlockWrite(stamp));
1057 >            }
1058 >        {
1059 >            StampedLock sl = new StampedLock();
1060 >            long stamp = sl.tryConvertToOptimisticRead(sl.readLock());
1061 >            sl.writeLock();
1062 >            assertThrows(IllegalMonitorStateException.class,
1063 >                () -> sl.unlock(stamp));
1064 >        }
1065 >        {
1066 >            StampedLock sl = new StampedLock();
1067 >            long stamp = sl.tryConvertToOptimisticRead(sl.readLock());
1068 >            sl.readLock();
1069 >            assertThrows(IllegalMonitorStateException.class,
1070 >                () -> sl.unlockRead(stamp));
1071 >        }
1072 >        {
1073 >            StampedLock sl = new StampedLock();
1074 >            sl.readLock();
1075 >            long stamp = sl.tryConvertToOptimisticRead(sl.readLock());
1076 >            assertValid(sl, stamp);
1077 >            sl.readLock();
1078 >            assertThrows(IllegalMonitorStateException.class,
1079 >                () -> sl.unlockRead(stamp));
1080 >        }
1081 >        {
1082 >            StampedLock sl = new StampedLock();
1083 >            long stamp = sl.tryConvertToOptimisticRead(sl.readLock());
1084 >            sl.readLock();
1085 >            assertThrows(IllegalMonitorStateException.class,
1086 >                () -> sl.unlock(stamp));
1087 >        }
1088 >        {
1089 >            StampedLock sl = new StampedLock();
1090 >            sl.readLock();
1091 >            long stamp = sl.tryConvertToOptimisticRead(sl.readLock());
1092 >            sl.readLock();
1093 >            assertThrows(IllegalMonitorStateException.class,
1094 >                () -> sl.unlock(stamp));
1095 >        }
1096 >    }
1097 >
1098 >    static long writeLockInterruptiblyUninterrupted(StampedLock sl) {
1099 >        try { return sl.writeLockInterruptibly(); }
1100 >        catch (InterruptedException ex) { throw new AssertionError(ex); }
1101 >    }
1102 >
1103 >    static long tryWriteLockUninterrupted(StampedLock sl, long time, TimeUnit unit) {
1104 >        try { return sl.tryWriteLock(time, unit); }
1105 >        catch (InterruptedException ex) { throw new AssertionError(ex); }
1106 >    }
1107 >
1108 >    static long readLockInterruptiblyUninterrupted(StampedLock sl) {
1109 >        try { return sl.readLockInterruptibly(); }
1110 >        catch (InterruptedException ex) { throw new AssertionError(ex); }
1111 >    }
1112 >
1113 >    static long tryReadLockUninterrupted(StampedLock sl, long time, TimeUnit unit) {
1114 >        try { return sl.tryReadLock(time, unit); }
1115 >        catch (InterruptedException ex) { throw new AssertionError(ex); }
1116 >    }
1117 >
1118 >    /**
1119 >     * Invalid stamps result in IllegalMonitorStateException
1120 >     */
1121 >    public void testInvalidStampsThrowIllegalMonitorStateException() {
1122 >        final StampedLock sl = new StampedLock();
1123 >
1124 >        assertThrows(IllegalMonitorStateException.class,
1125 >                     () -> sl.unlockWrite(0L),
1126 >                     () -> sl.unlockRead(0L),
1127 >                     () -> sl.unlock(0L));
1128 >
1129 >        final long optimisticStamp = sl.tryOptimisticRead();
1130 >        final long readStamp = sl.readLock();
1131 >        sl.unlockRead(readStamp);
1132 >        final long writeStamp = sl.writeLock();
1133 >        sl.unlockWrite(writeStamp);
1134 >        assertTrue(optimisticStamp != 0L && readStamp != 0L && writeStamp != 0L);
1135 >        final long[] noLongerValidStamps = { optimisticStamp, readStamp, writeStamp };
1136 >        final Runnable assertNoLongerValidStampsThrow = () -> {
1137 >            for (long noLongerValidStamp : noLongerValidStamps)
1138 >                assertThrows(IllegalMonitorStateException.class,
1139 >                             () -> sl.unlockWrite(noLongerValidStamp),
1140 >                             () -> sl.unlockRead(noLongerValidStamp),
1141 >                             () -> sl.unlock(noLongerValidStamp));
1142 >        };
1143 >        assertNoLongerValidStampsThrow.run();
1144 >
1145 >        for (Function<StampedLock, Long> readLocker : readLockers())
1146 >        for (BiConsumer<StampedLock, Long> readUnlocker : readUnlockers()) {
1147 >            final long stamp = readLocker.apply(sl);
1148 >            assertValid(sl, stamp);
1149 >            assertNoLongerValidStampsThrow.run();
1150 >            assertThrows(IllegalMonitorStateException.class,
1151 >                         () -> sl.unlockWrite(stamp),
1152 >                         () -> sl.unlockRead(sl.tryOptimisticRead()),
1153 >                         () -> sl.unlockRead(0L));
1154 >            readUnlocker.accept(sl, stamp);
1155 >            assertUnlocked(sl);
1156 >            assertNoLongerValidStampsThrow.run();
1157 >        }
1158 >
1159 >        for (Function<StampedLock, Long> writeLocker : writeLockers())
1160 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
1161 >            final long stamp = writeLocker.apply(sl);
1162 >            assertValid(sl, stamp);
1163 >            assertNoLongerValidStampsThrow.run();
1164 >            assertThrows(IllegalMonitorStateException.class,
1165 >                         () -> sl.unlockRead(stamp),
1166 >                         () -> sl.unlockWrite(0L));
1167 >            writeUnlocker.accept(sl, stamp);
1168 >            assertUnlocked(sl);
1169 >            assertNoLongerValidStampsThrow.run();
1170 >        }
1171 >    }
1172 >
1173 >    /**
1174 >     * Read locks can be very deeply nested
1175 >     */
1176 >    public void testDeeplyNestedReadLocks() {
1177 >        final StampedLock lock = new StampedLock();
1178 >        final int depth = 300;
1179 >        final long[] stamps = new long[depth];
1180 >        final List<Function<StampedLock, Long>> readLockers = readLockers();
1181 >        final List<BiConsumer<StampedLock, Long>> readUnlockers = readUnlockers();
1182 >        for (int i = 0; i < depth; i++) {
1183 >            Function<StampedLock, Long> readLocker
1184 >                = readLockers.get(i % readLockers.size());
1185 >            long stamp = readLocker.apply(lock);
1186 >            assertEquals(i + 1, lock.getReadLockCount());
1187 >            assertTrue(lock.isReadLocked());
1188 >            stamps[i] = stamp;
1189 >        }
1190 >        for (int i = 0; i < depth; i++) {
1191 >            BiConsumer<StampedLock, Long> readUnlocker
1192 >                = readUnlockers.get(i % readUnlockers.size());
1193 >            assertEquals(depth - i, lock.getReadLockCount());
1194 >            assertTrue(lock.isReadLocked());
1195 >            readUnlocker.accept(lock, stamps[depth - 1 - i]);
1196 >        }
1197 >        assertUnlocked(lock);
1198 >    }
1199 >
1200 >    /**
1201 >     * Stamped locks are not reentrant.
1202 >     */
1203 >    public void testNonReentrant() throws InterruptedException {
1204 >        final StampedLock lock = new StampedLock();
1205 >        long stamp;
1206 >
1207 >        stamp = lock.writeLock();
1208 >        assertValid(lock, stamp);
1209 >        assertEquals(0L, lock.tryWriteLock(0L, DAYS));
1210 >        assertEquals(0L, lock.tryReadLock(0L, DAYS));
1211 >        assertValid(lock, stamp);
1212 >        lock.unlockWrite(stamp);
1213 >
1214 >        stamp = lock.tryWriteLock(1L, DAYS);
1215 >        assertEquals(0L, lock.tryWriteLock(0L, DAYS));
1216 >        assertValid(lock, stamp);
1217 >        lock.unlockWrite(stamp);
1218 >
1219 >        stamp = lock.readLock();
1220 >        assertEquals(0L, lock.tryWriteLock(0L, DAYS));
1221 >        assertValid(lock, stamp);
1222 >        lock.unlockRead(stamp);
1223 >    }
1224 >
1225 >    /**
1226 >     * """StampedLocks have no notion of ownership. Locks acquired in
1227 >     * one thread can be released or converted in another."""
1228 >     */
1229 >    public void testNoOwnership() throws Throwable {
1230 >        ArrayList<Future<?>> futures = new ArrayList<>();
1231 >        for (Function<StampedLock, Long> writeLocker : writeLockers())
1232 >        for (BiConsumer<StampedLock, Long> writeUnlocker : writeUnlockers()) {
1233 >            StampedLock lock = new StampedLock();
1234 >            long stamp = writeLocker.apply(lock);
1235 >            futures.add(cachedThreadPool.submit(new CheckedRunnable() {
1236 >                public void realRun() {
1237 >                    writeUnlocker.accept(lock, stamp);
1238 >                    assertUnlocked(lock);
1239 >                    assertFalse(lock.validate(stamp));
1240 >                }}));
1241 >        }
1242 >        for (Future<?> future : futures)
1243 >            assertNull(future.get());
1244 >    }
1245 >
1246 >    /** Tries out sample usage code from StampedLock javadoc. */
1247 >    public void testSampleUsage() throws Throwable {
1248 >        class Point {
1249 >            private double x, y;
1250 >            private final StampedLock sl = new StampedLock();
1251 >
1252 >            void move(double deltaX, double deltaY) { // an exclusively locked method
1253 >                long stamp = sl.writeLock();
1254 >                try {
1255 >                    x += deltaX;
1256 >                    y += deltaY;
1257 >                } finally {
1258 >                    sl.unlockWrite(stamp);
1259 >                }
1260 >            }
1261 >
1262 >            double distanceFromOrigin() { // A read-only method
1263 >                double currentX, currentY;
1264 >                long stamp = sl.tryOptimisticRead();
1265 >                do {
1266 >                    if (stamp == 0L)
1267 >                        stamp = sl.readLock();
1268 >                    try {
1269 >                        // possibly racy reads
1270 >                        currentX = x;
1271 >                        currentY = y;
1272 >                    } finally {
1273 >                        stamp = sl.tryConvertToOptimisticRead(stamp);
1274 >                    }
1275 >                } while (stamp == 0);
1276 >                return Math.hypot(currentX, currentY);
1277 >            }
1278 >
1279 >            double distanceFromOrigin2() {
1280 >                long stamp = sl.tryOptimisticRead();
1281 >                try {
1282 >                    retryHoldingLock:
1283 >                    for (;; stamp = sl.readLock()) {
1284 >                        if (stamp == 0L)
1285 >                            continue retryHoldingLock;
1286 >                        // possibly racy reads
1287 >                        double currentX = x;
1288 >                        double currentY = y;
1289 >                        if (!sl.validate(stamp))
1290 >                            continue retryHoldingLock;
1291 >                        return Math.hypot(currentX, currentY);
1292 >                    }
1293 >                } finally {
1294 >                    if (StampedLock.isReadLockStamp(stamp))
1295 >                        sl.unlockRead(stamp);
1296 >                }
1297 >            }
1298 >
1299 >            void moveIfAtOrigin(double newX, double newY) {
1300 >                long stamp = sl.readLock();
1301 >                try {
1302 >                    while (x == 0.0 && y == 0.0) {
1303 >                        long ws = sl.tryConvertToWriteLock(stamp);
1304 >                        if (ws != 0L) {
1305 >                            stamp = ws;
1306 >                            x = newX;
1307 >                            y = newY;
1308 >                            return;
1309 >                        }
1310 >                        else {
1311 >                            sl.unlockRead(stamp);
1312 >                            stamp = sl.writeLock();
1313 >                        }
1314 >                    }
1315 >                } finally {
1316 >                    sl.unlock(stamp);
1317 >                }
1318 >            }
1319 >        }
1320 >
1321 >        Point p = new Point();
1322 >        p.move(3.0, 4.0);
1323 >        assertEquals(5.0, p.distanceFromOrigin());
1324 >        p.moveIfAtOrigin(5.0, 12.0);
1325 >        assertEquals(5.0, p.distanceFromOrigin2());
1326 >    }
1327 >
1328 >    /**
1329 >     * Stamp inspection methods work as expected, and do not inspect
1330 >     * the state of the lock itself.
1331 >     */
1332 >    public void testStampStateInspectionMethods() {
1333 >        StampedLock lock = new StampedLock();
1334 >
1335 >        assertFalse(isWriteLockStamp(0L));
1336 >        assertFalse(isReadLockStamp(0L));
1337 >        assertFalse(isLockStamp(0L));
1338 >        assertFalse(isOptimisticReadStamp(0L));
1339 >
1340 >        {
1341 >            long stamp = lock.writeLock();
1342 >            for (int i = 0; i < 2; i++) {
1343 >                assertTrue(isWriteLockStamp(stamp));
1344 >                assertFalse(isReadLockStamp(stamp));
1345 >                assertTrue(isLockStamp(stamp));
1346 >                assertFalse(isOptimisticReadStamp(stamp));
1347 >                if (i == 0)
1348 >                    lock.unlockWrite(stamp);
1349 >            }
1350 >        }
1351 >
1352 >        {
1353 >            long stamp = lock.readLock();
1354 >            for (int i = 0; i < 2; i++) {
1355 >                assertFalse(isWriteLockStamp(stamp));
1356 >                assertTrue(isReadLockStamp(stamp));
1357 >                assertTrue(isLockStamp(stamp));
1358 >                assertFalse(isOptimisticReadStamp(stamp));
1359 >                if (i == 0)
1360 >                    lock.unlockRead(stamp);
1361 >            }
1362 >        }
1363 >
1364 >        {
1365 >            long optimisticStamp = lock.tryOptimisticRead();
1366 >            long readStamp = lock.tryConvertToReadLock(optimisticStamp);
1367 >            long writeStamp = lock.tryConvertToWriteLock(readStamp);
1368 >            for (int i = 0; i < 2; i++) {
1369 >                assertFalse(isWriteLockStamp(optimisticStamp));
1370 >                assertFalse(isReadLockStamp(optimisticStamp));
1371 >                assertFalse(isLockStamp(optimisticStamp));
1372 >                assertTrue(isOptimisticReadStamp(optimisticStamp));
1373 >
1374 >                assertFalse(isWriteLockStamp(readStamp));
1375 >                assertTrue(isReadLockStamp(readStamp));
1376 >                assertTrue(isLockStamp(readStamp));
1377 >                assertFalse(isOptimisticReadStamp(readStamp));
1378 >
1379 >                assertTrue(isWriteLockStamp(writeStamp));
1380 >                assertFalse(isReadLockStamp(writeStamp));
1381 >                assertTrue(isLockStamp(writeStamp));
1382 >                assertFalse(isOptimisticReadStamp(writeStamp));
1383 >                if (i == 0)
1384 >                    lock.unlockWrite(writeStamp);
1385 >            }
1386 >        }
1387 >    }
1388 >
1389 >    /**
1390 >     * Multiple threads repeatedly contend for the same lock.
1391 >     */
1392 >    public void testConcurrentAccess() throws Exception {
1393 >        final StampedLock sl = new StampedLock();
1394 >        final Lock wl = sl.asWriteLock();
1395 >        final Lock rl = sl.asReadLock();
1396 >        final long testDurationMillis = expensiveTests ? 1000 : 2;
1397 >        final int nTasks = ThreadLocalRandom.current().nextInt(1, 10);
1398 >        final AtomicBoolean done = new AtomicBoolean(false);
1399 >        final List<CompletableFuture> futures = new ArrayList<>();
1400 >        final List<Callable<Long>> stampedWriteLockers = List.of(
1401 >            () -> sl.writeLock(),
1402 >            () -> writeLockInterruptiblyUninterrupted(sl),
1403 >            () -> tryWriteLockUninterrupted(sl, LONG_DELAY_MS, MILLISECONDS),
1404 >            () -> {
1405 >                long stamp;
1406 >                do { stamp = sl.tryConvertToWriteLock(sl.tryOptimisticRead()); }
1407 >                while (stamp == 0L);
1408 >                return stamp;
1409 >            },
1410 >            () -> {
1411 >              long stamp;
1412 >              do { stamp = sl.tryWriteLock(); } while (stamp == 0L);
1413 >              return stamp;
1414 >            },
1415 >            () -> {
1416 >              long stamp;
1417 >              do { stamp = sl.tryWriteLock(0L, DAYS); } while (stamp == 0L);
1418 >              return stamp;
1419 >            });
1420 >        final List<Callable<Long>> stampedReadLockers = List.of(
1421 >            () -> sl.readLock(),
1422 >            () -> readLockInterruptiblyUninterrupted(sl),
1423 >            () -> tryReadLockUninterrupted(sl, LONG_DELAY_MS, MILLISECONDS),
1424 >            () -> {
1425 >                long stamp;
1426 >                do { stamp = sl.tryConvertToReadLock(sl.tryOptimisticRead()); }
1427 >                while (stamp == 0L);
1428 >                return stamp;
1429 >            },
1430 >            () -> {
1431 >              long stamp;
1432 >              do { stamp = sl.tryReadLock(); } while (stamp == 0L);
1433 >              return stamp;
1434 >            },
1435 >            () -> {
1436 >              long stamp;
1437 >              do { stamp = sl.tryReadLock(0L, DAYS); } while (stamp == 0L);
1438 >              return stamp;
1439 >            });
1440 >        final List<Consumer<Long>> stampedWriteUnlockers = List.of(
1441 >            stamp -> sl.unlockWrite(stamp),
1442 >            stamp -> sl.unlock(stamp),
1443 >            stamp -> assertTrue(sl.tryUnlockWrite()),
1444 >            stamp -> wl.unlock(),
1445 >            stamp -> sl.tryConvertToOptimisticRead(stamp));
1446 >        final List<Consumer<Long>> stampedReadUnlockers = List.of(
1447 >            stamp -> sl.unlockRead(stamp),
1448 >            stamp -> sl.unlock(stamp),
1449 >            stamp -> assertTrue(sl.tryUnlockRead()),
1450 >            stamp -> rl.unlock(),
1451 >            stamp -> sl.tryConvertToOptimisticRead(stamp));
1452 >        final Action writer = () -> {
1453 >            // repeatedly acquires write lock
1454 >            var locker = chooseRandomly(stampedWriteLockers);
1455 >            var unlocker = chooseRandomly(stampedWriteUnlockers);
1456 >            while (!done.getAcquire()) {
1457 >                long stamp = locker.call();
1458 >                try {
1459 >                    assertTrue(isWriteLockStamp(stamp));
1460 >                    assertTrue(sl.isWriteLocked());
1461 >                    assertFalse(isReadLockStamp(stamp));
1462 >                    assertFalse(sl.isReadLocked());
1463 >                    assertEquals(0, sl.getReadLockCount());
1464 >                    assertTrue(sl.validate(stamp));
1465 >                } finally {
1466 >                    unlocker.accept(stamp);
1467 >                }
1468 >            }
1469 >        };
1470 >        final Action reader = () -> {
1471 >            // repeatedly acquires read lock
1472 >            var locker = chooseRandomly(stampedReadLockers);
1473 >            var unlocker = chooseRandomly(stampedReadUnlockers);
1474 >            while (!done.getAcquire()) {
1475 >                long stamp = locker.call();
1476 >                try {
1477 >                    assertFalse(isWriteLockStamp(stamp));
1478 >                    assertFalse(sl.isWriteLocked());
1479 >                    assertTrue(isReadLockStamp(stamp));
1480 >                    assertTrue(sl.isReadLocked());
1481 >                    assertTrue(sl.getReadLockCount() > 0);
1482 >                    assertTrue(sl.validate(stamp));
1483 >                } finally {
1484 >                    unlocker.accept(stamp);
1485 >                }
1486 >            }
1487 >        };
1488 >        for (int i = nTasks; i--> 0; ) {
1489 >            Action task = chooseRandomly(writer, reader);
1490 >            futures.add(CompletableFuture.runAsync(checkedRunnable(task)));
1491 >        }
1492 >        Thread.sleep(testDurationMillis);
1493 >        done.setRelease(true);
1494 >        for (var future : futures)
1495 >            checkTimedGet(future, null);
1496 >    }
1497  
1498   }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines