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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines