ViewVC Help

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

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

Comparing jsr166/src/test/tck/JSR166TestCase.java (file contents):
Revision 1.242 by jsr166, Mon Feb 19 16:12:11 2018 UTC vs.
Revision 1.250 by jsr166, Sat Nov 24 21:48:19 2018 UTC

#	Line 66 | Line 66 | import java.util.Arrays;
66		import java.util.Collection;
67		import java.util.Collections;
68		import java.util.Date;
69	+	import java.util.Deque;
70		import java.util.Enumeration;
71	+	import java.util.HashSet;
72		import java.util.Iterator;
73		import java.util.List;
74		import java.util.NoSuchElementException;
75		import java.util.PropertyPermission;
76	+	import java.util.Set;
77		import java.util.concurrent.BlockingQueue;
78		import java.util.concurrent.Callable;
79		import java.util.concurrent.CountDownLatch;
#	Line 114 | Line 117 | import junit.framework.TestSuite;
117		*
118		* <ol>
119		*
120	<	* <li>All assertions in code running in generated threads must use
121	<	* the forms {@link #threadFail}, {@link #threadAssertTrue}, {@link
122	<	* #threadAssertEquals}, or {@link #threadAssertNull}, (not
123	<	* {@code fail}, {@code assertTrue}, etc.) It is OK (but not
124	<	* particularly recommended) for other code to use these forms too.
125	<	* Only the most typically used JUnit assertion methods are defined
126	<	* this way, but enough to live with.
120	>	* <li>All code not running in the main test thread (manually spawned threads
121	>	* or the common fork join pool) must be checked for failure (and completion!).
122	>	* Mechanisms that can be used to ensure this are:
123	>	*   <ol>
124	>	*   <li>Signalling via a synchronizer like AtomicInteger or CountDownLatch
125	>	*    that the task completed normally, which is checked before returning from
126	>	*    the test method in the main thread.
127	>	*   <li>Using the forms {@link #threadFail}, {@link #threadAssertTrue},
128	>	*    or {@link #threadAssertNull}, (not {@code fail}, {@code assertTrue}, etc.)
129	>	*    Only the most typically used JUnit assertion methods are defined
130	>	*    this way, but enough to live with.
131	>	*   <li>Recording failure explicitly using {@link #threadUnexpectedException}
132	>	*    or {@link #threadRecordFailure}.
133	>	*   <li>Using a wrapper like CheckedRunnable that uses one the mechanisms above.
134	>	*   </ol>
135		*
136		* <li>If you override {@link #setUp} or {@link #tearDown}, make sure
137		* to invoke {@code super.setUp} and {@code super.tearDown} within
#	Line 448 | Line 459 | public class JSR166TestCase extends Test
459		public static boolean atLeastJava8()  { return JAVA_CLASS_VERSION >= 52.0; }
460		public static boolean atLeastJava9()  { return JAVA_CLASS_VERSION >= 53.0; }
461		public static boolean atLeastJava10() { return JAVA_CLASS_VERSION >= 54.0; }
462	+	public static boolean atLeastJava11() { return JAVA_CLASS_VERSION >= 55.0; }
463
464		/**
465		* Collects all JSR166 unit tests as one suite.
#	Line 1287 | Line 1299 | public class JSR166TestCase extends Test
1299		/**
1300		* Spin-waits up to the specified number of milliseconds for the given
1301		* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
1302	+	* @param waitingForGodot if non-null, an additional condition to satisfy
1303		*/
1304	<	void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) {
1305	<	long startTime = 0L;
1306	<	for (;;) {
1307	<	Thread.State s = thread.getState();
1308	<	if (s == Thread.State.BLOCKED ||
1309	<	s == Thread.State.WAITING ||
1310	<	s == Thread.State.TIMED_WAITING)
1311	<	return;
1312	<	else if (s == Thread.State.TERMINATED)
1304	>	void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis,
1305	>	Callable<Boolean> waitingForGodot) {
1306	>	for (long startTime = 0L;;) {
1307	>	switch (thread.getState()) {
1308	>	default: break;
1309	>	case BLOCKED: case WAITING: case TIMED_WAITING:
1310	>	try {
1311	>	if (waitingForGodot == null || waitingForGodot.call())
1312	>	return;
1313	>	} catch (Throwable fail) { threadUnexpectedException(fail); }
1314	>	break;
1315	>	case TERMINATED:
1316		fail("Unexpected thread termination");
1317	<	else if (startTime == 0L)
1317	>	}
1318	>
1319	>	if (startTime == 0L)
1320		startTime = System.nanoTime();
1321		else if (millisElapsedSince(startTime) > timeoutMillis) {
1322	<	threadAssertTrue(thread.isAlive());
1323	<	fail("timed out waiting for thread to enter wait state");
1322	>	assertTrue(thread.isAlive());
1323	>	if (waitingForGodot == null
1324	>	|| thread.getState() == Thread.State.RUNNABLE)
1325	>	fail("timed out waiting for thread to enter wait state");
1326	>	else
1327	>	fail("timed out waiting for condition, thread state="
1328	>	+ thread.getState());
1329		}
1330		Thread.yield();
1331		}
#	Line 1310 | Line 1333 | public class JSR166TestCase extends Test
1333
1334		/**
1335		* Spin-waits up to the specified number of milliseconds for the given
1336	<	* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING,
1314	<	* and additionally satisfy the given condition.
1336	>	* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
1337		*/
1338	<	void waitForThreadToEnterWaitState(
1339	<	Thread thread, long timeoutMillis, Callable<Boolean> waitingForGodot) {
1318	<	long startTime = 0L;
1319	<	for (;;) {
1320	<	Thread.State s = thread.getState();
1321	<	if (s == Thread.State.BLOCKED ||
1322	<	s == Thread.State.WAITING ||
1323	<	s == Thread.State.TIMED_WAITING) {
1324	<	try {
1325	<	if (waitingForGodot.call())
1326	<	return;
1327	<	} catch (Throwable fail) { threadUnexpectedException(fail); }
1328	<	}
1329	<	else if (s == Thread.State.TERMINATED)
1330	<	fail("Unexpected thread termination");
1331	<	else if (startTime == 0L)
1332	<	startTime = System.nanoTime();
1333	<	else if (millisElapsedSince(startTime) > timeoutMillis) {
1334	<	threadAssertTrue(thread.isAlive());
1335	<	fail("timed out waiting for thread to enter wait state");
1336	<	}
1337	<	Thread.yield();
1338	<	}
1338	>	void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) {
1339	>	waitForThreadToEnterWaitState(thread, timeoutMillis, null);
1340		}
1341
1342		/**
#	Line 1343 | Line 1344 | public class JSR166TestCase extends Test
1344		* enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
1345		*/
1346		void waitForThreadToEnterWaitState(Thread thread) {
1347	<	waitForThreadToEnterWaitState(thread, LONG_DELAY_MS);
1347	>	waitForThreadToEnterWaitState(thread, LONG_DELAY_MS, null);
1348		}
1349
1350		/**
#	Line 1351 | Line 1352 | public class JSR166TestCase extends Test
1352		* enter a wait state: BLOCKED, WAITING, or TIMED_WAITING,
1353		* and additionally satisfy the given condition.
1354		*/
1355	<	void waitForThreadToEnterWaitState(
1356	<	Thread thread, Callable<Boolean> waitingForGodot) {
1355	>	void waitForThreadToEnterWaitState(Thread thread,
1356	>	Callable<Boolean> waitingForGodot) {
1357		waitForThreadToEnterWaitState(thread, LONG_DELAY_MS, waitingForGodot);
1358		}
1359
#	Line 1384 | Line 1385 | public class JSR166TestCase extends Test
1385		*/
1386		<T> void checkTimedGet(Future<T> f, T expectedValue, long timeoutMillis) {
1387		long startTime = System.nanoTime();
1388	+	T actual = null;
1389		try {
1390	<	assertEquals(expectedValue, f.get(timeoutMillis, MILLISECONDS));
1390	>	actual = f.get(timeoutMillis, MILLISECONDS);
1391		} catch (Throwable fail) { threadUnexpectedException(fail); }
1392	+	assertEquals(expectedValue, actual);
1393		if (millisElapsedSince(startTime) > timeoutMillis/2)
1394		throw new AssertionError("timed get did not return promptly");
1395		}
#	Line 1458 | Line 1461 | public class JSR166TestCase extends Test
1461		public final void run() {
1462		try {
1463		realRun();
1461	–	threadShouldThrow(exceptionClass.getSimpleName());
1464		} catch (Throwable t) {
1465		if (! exceptionClass.isInstance(t))
1466		threadUnexpectedException(t);
1467	+	return;
1468		}
1469	+	threadShouldThrow(exceptionClass.getSimpleName());
1470		}
1471		}
1472
#	Line 1472 | Line 1476 | public class JSR166TestCase extends Test
1476		public final void run() {
1477		try {
1478		realRun();
1475	–	threadShouldThrow("InterruptedException");
1479		} catch (InterruptedException success) {
1480		threadAssertFalse(Thread.interrupted());
1481	+	return;
1482		} catch (Throwable fail) {
1483		threadUnexpectedException(fail);
1484		}
1485	+	threadShouldThrow("InterruptedException");
1486		}
1487		}
1488
#	Line 1489 | Line 1494 | public class JSR166TestCase extends Test
1494		return realCall();
1495		} catch (Throwable fail) {
1496		threadUnexpectedException(fail);
1492	–	return null;
1493	–	}
1494	–	}
1495	–	}
1496	–
1497	–	public abstract class CheckedInterruptedCallable<T>
1498	–	implements Callable<T> {
1499	–	protected abstract T realCall() throws Throwable;
1500	–
1501	–	public final T call() {
1502	–	try {
1503	–	T result = realCall();
1504	–	threadShouldThrow("InterruptedException");
1505	–	return result;
1506	–	} catch (InterruptedException success) {
1507	–	threadAssertFalse(Thread.interrupted());
1508	–	} catch (Throwable fail) {
1509	–	threadUnexpectedException(fail);
1497		}
1498	<	return null;
1498	>	throw new AssertionError("unreached");
1499		}
1500		}
1501
#	Line 1565 | Line 1552 | public class JSR166TestCase extends Test
1552		}
1553
1554		public void await(CountDownLatch latch, long timeoutMillis) {
1555	+	boolean timedOut = false;
1556		try {
1557	<	if (!latch.await(timeoutMillis, MILLISECONDS))
1570	<	fail("timed out waiting for CountDownLatch for "
1571	<	+ (timeoutMillis/1000) + " sec");
1557	>	timedOut = !latch.await(timeoutMillis, MILLISECONDS);
1558		} catch (Throwable fail) {
1559		threadUnexpectedException(fail);
1560		}
1561	+	if (timedOut)
1562	+	fail("timed out waiting for CountDownLatch for "
1563	+	+ (timeoutMillis/1000) + " sec");
1564		}
1565
1566		public void await(CountDownLatch latch) {
#	Line 1579 | Line 1568 | public class JSR166TestCase extends Test
1568		}
1569
1570		public void await(Semaphore semaphore) {
1571	+	boolean timedOut = false;
1572		try {
1573	<	if (!semaphore.tryAcquire(LONG_DELAY_MS, MILLISECONDS))
1584	<	fail("timed out waiting for Semaphore for "
1585	<	+ (LONG_DELAY_MS/1000) + " sec");
1573	>	timedOut = !semaphore.tryAcquire(LONG_DELAY_MS, MILLISECONDS);
1574		} catch (Throwable fail) {
1575		threadUnexpectedException(fail);
1576		}
1577	+	if (timedOut)
1578	+	fail("timed out waiting for Semaphore for "
1579	+	+ (LONG_DELAY_MS/1000) + " sec");
1580		}
1581
1582		public void await(CyclicBarrier barrier) {
#	Line 1619 | Line 1610 | public class JSR166TestCase extends Test
1610		public String call() { throw new NullPointerException(); }
1611		}
1612
1622	–	public class SmallPossiblyInterruptedRunnable extends CheckedRunnable {
1623	–	protected void realRun() {
1624	–	try {
1625	–	delay(SMALL_DELAY_MS);
1626	–	} catch (InterruptedException ok) {}
1627	–	}
1628	–	}
1629	–
1613		public Runnable possiblyInterruptedRunnable(final long timeoutMillis) {
1614		return new CheckedRunnable() {
1615		protected void realRun() {
#	Line 1682 | Line 1665 | public class JSR166TestCase extends Test
1665		return realCompute();
1666		} catch (Throwable fail) {
1667		threadUnexpectedException(fail);
1685	–	return null;
1668		}
1669	+	throw new AssertionError("unreached");
1670		}
1671		}
1672
#	Line 1771 | Line 1754 | public class JSR166TestCase extends Test
1754
1755		@SuppressWarnings("unchecked")
1756		<T> T serialClone(T o) {
1757	+	T clone = null;
1758		try {
1759		ObjectInputStream ois = new ObjectInputStream
1760		(new ByteArrayInputStream(serialBytes(o)));
1761	<	T clone = (T) ois.readObject();
1778	<	if (o == clone) assertImmutable(o);
1779	<	assertSame(o.getClass(), clone.getClass());
1780	<	return clone;
1761	>	clone = (T) ois.readObject();
1762		} catch (Throwable fail) {
1763		threadUnexpectedException(fail);
1783	–	return null;
1764		}
1765	+	if (o == clone) assertImmutable(o);
1766	+	else assertSame(o.getClass(), clone.getClass());
1767	+	return clone;
1768		}
1769
1770		/**
#	Line 1800 | Line 1783 | public class JSR166TestCase extends Test
1783		(new ByteArrayInputStream(bos.toByteArray()));
1784		T clone = (T) ois.readObject();
1785		if (o == clone) assertImmutable(o);
1786	<	assertSame(o.getClass(), clone.getClass());
1786	>	else assertSame(o.getClass(), clone.getClass());
1787		return clone;
1788		}
1789
#	Line 2051 | Line 2034 | public class JSR166TestCase extends Test
2034		assertEquals(savedCompletedTaskCount, p.getCompletedTaskCount());
2035		assertEquals(savedQueueSize, p.getQueue().size());
2036		}
2037	+
2038	+	void assertCollectionsEquals(Collection<?> x, Collection<?> y) {
2039	+	assertEquals(x, y);
2040	+	assertEquals(y, x);
2041	+	assertEquals(x.isEmpty(), y.isEmpty());
2042	+	assertEquals(x.size(), y.size());
2043	+	if (x instanceof List) {
2044	+	assertEquals(x.toString(), y.toString());
2045	+	}
2046	+	if (x instanceof List || x instanceof Set) {
2047	+	assertEquals(x.hashCode(), y.hashCode());
2048	+	}
2049	+	if (x instanceof List || x instanceof Deque) {
2050	+	assertTrue(Arrays.equals(x.toArray(), y.toArray()));
2051	+	assertTrue(Arrays.equals(x.toArray(new Object[0]),
2052	+	y.toArray(new Object[0])));
2053	+	}
2054	+	}
2055	+
2056	+	/**
2057	+	* A weaker form of assertCollectionsEquals which does not insist
2058	+	* that the two collections satisfy Object#equals(Object), since
2059	+	* they may use identity semantics as Deques do.
2060	+	*/
2061	+	void assertCollectionsEquivalent(Collection<?> x, Collection<?> y) {
2062	+	if (x instanceof List || x instanceof Set)
2063	+	assertCollectionsEquals(x, y);
2064	+	else {
2065	+	assertEquals(x.isEmpty(), y.isEmpty());
2066	+	assertEquals(x.size(), y.size());
2067	+	assertEquals(new HashSet(x), new HashSet(y));
2068	+	if (x instanceof Deque) {
2069	+	assertTrue(Arrays.equals(x.toArray(), y.toArray()));
2070	+	assertTrue(Arrays.equals(x.toArray(new Object[0]),
2071	+	y.toArray(new Object[0])));
2072	+	}
2073	+	}
2074	+	}
2075		}

Diff Legend

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