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

Diff Legend

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