ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/jsr166/jsr166/src/test/tck/ReentrantReadWriteLockTest.java

Comparing jsr166/src/test/tck/ReentrantReadWriteLockTest.java (file contents):
Revision 1.5 by dl, Fri Sep 26 15:33:13 2003 UTC vs.
Revision 1.61 by jsr166, Fri May 13 21:48:59 2011 UTC

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

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines