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.245 by jsr166, Sun Jul 22 21:19:14 2018 UTC vs.
Revision 1.257 by jsr166, Wed Aug 14 23:06:11 2019 UTC

#	Line 117 | 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 280 | Line 288 | public class JSR166TestCase extends Test
288		// Avoid spurious reports with enormous runsPerTest.
289		// A single test case run should never take more than 1 second.
290		// But let's cap it at the high end too ...
291	<	final int timeoutMinutes =
292	<	Math.min(15, Math.max(runsPerTest / 60, 1));
291	>	final int timeoutMinutesMin = Math.max(runsPerTest / 60, 1)
292	>	* Math.max((int) delayFactor, 1);
293	>	final int timeoutMinutes = Math.min(15, timeoutMinutesMin);
294		for (TestCase lastTestCase = currentTestCase;;) {
295		try { MINUTES.sleep(timeoutMinutes); }
296		catch (InterruptedException unexpected) { break; }
#	Line 452 | Line 461 | public class JSR166TestCase extends Test
461		public static boolean atLeastJava9()  { return JAVA_CLASS_VERSION >= 53.0; }
462		public static boolean atLeastJava10() { return JAVA_CLASS_VERSION >= 54.0; }
463		public static boolean atLeastJava11() { return JAVA_CLASS_VERSION >= 55.0; }
464	+	public static boolean atLeastJava12() { return JAVA_CLASS_VERSION >= 56.0; }
465	+	public static boolean atLeastJava13() { return JAVA_CLASS_VERSION >= 57.0; }
466	+	public static boolean atLeastJava14() { return JAVA_CLASS_VERSION >= 58.0; }
467	+	public static boolean atLeastJava15() { return JAVA_CLASS_VERSION >= 59.0; }
468	+	public static boolean atLeastJava16() { return JAVA_CLASS_VERSION >= 60.0; }
469	+	public static boolean atLeastJava17() { return JAVA_CLASS_VERSION >= 61.0; }
470
471		/**
472		* Collects all JSR166 unit tests as one suite.
#	Line 503 | Line 518 | public class JSR166TestCase extends Test
518		ExecutorsTest.suite(),
519		ExecutorCompletionServiceTest.suite(),
520		FutureTaskTest.suite(),
521	+	HashtableTest.suite(),
522		LinkedBlockingDequeTest.suite(),
523		LinkedBlockingQueueTest.suite(),
524		LinkedListTest.suite(),
#	Line 542 | Line 558 | public class JSR166TestCase extends Test
558		"HashMapTest",
559		"LinkedBlockingDeque8Test",
560		"LinkedBlockingQueue8Test",
561	+	"LinkedHashMapTest",
562		"LongAccumulatorTest",
563		"LongAdderTest",
564		"SplittableRandomTest",
#	Line 668 | Line 685 | public class JSR166TestCase extends Test
685		static TimeUnit randomTimeUnit() { return RANDOM_TIMEUNIT; }
686
687		/**
688	+	* Returns a random boolean; a "coin flip".
689	+	*/
690	+	static boolean randomBoolean() {
691	+	return ThreadLocalRandom.current().nextBoolean();
692	+	}
693	+
694	+	/**
695	+	* Returns a random element from given choices.
696	+	*/
697	+	<T> T chooseRandomly(T... choices) {
698	+	return choices[ThreadLocalRandom.current().nextInt(choices.length)];
699	+	}
700	+
701	+	/**
702		* Returns the shortest timed delay. This can be scaled up for
703		* slow machines using the jsr166.delay.factor system property,
704		* or via jtreg's -timeoutFactor: flag.
#	Line 1291 | Line 1322 | public class JSR166TestCase extends Test
1322		/**
1323		* Spin-waits up to the specified number of milliseconds for the given
1324		* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
1325	+	* @param waitingForGodot if non-null, an additional condition to satisfy
1326		*/
1327	<	void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) {
1328	<	long startTime = 0L;
1329	<	for (;;) {
1330	<	Thread.State s = thread.getState();
1331	<	if (s == Thread.State.BLOCKED ||
1332	<	s == Thread.State.WAITING ||
1333	<	s == Thread.State.TIMED_WAITING)
1334	<	return;
1335	<	else if (s == Thread.State.TERMINATED)
1327	>	void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis,
1328	>	Callable<Boolean> waitingForGodot) {
1329	>	for (long startTime = 0L;;) {
1330	>	switch (thread.getState()) {
1331	>	default: break;
1332	>	case BLOCKED: case WAITING: case TIMED_WAITING:
1333	>	try {
1334	>	if (waitingForGodot == null || waitingForGodot.call())
1335	>	return;
1336	>	} catch (Throwable fail) { threadUnexpectedException(fail); }
1337	>	break;
1338	>	case TERMINATED:
1339		fail("Unexpected thread termination");
1340	<	else if (startTime == 0L)
1340	>	}
1341	>
1342	>	if (startTime == 0L)
1343		startTime = System.nanoTime();
1344		else if (millisElapsedSince(startTime) > timeoutMillis) {
1345	<	threadAssertTrue(thread.isAlive());
1346	<	fail("timed out waiting for thread to enter wait state");
1345	>	assertTrue(thread.isAlive());
1346	>	if (waitingForGodot == null
1347	>	|| thread.getState() == Thread.State.RUNNABLE)
1348	>	fail("timed out waiting for thread to enter wait state");
1349	>	else
1350	>	fail("timed out waiting for condition, thread state="
1351	>	+ thread.getState());
1352		}
1353		Thread.yield();
1354		}
#	Line 1314 | Line 1356 | public class JSR166TestCase extends Test
1356
1357		/**
1358		* Spin-waits up to the specified number of milliseconds for the given
1359	<	* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING,
1318	<	* and additionally satisfy the given condition.
1359	>	* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
1360		*/
1361	<	void waitForThreadToEnterWaitState(
1362	<	Thread thread, long timeoutMillis, Callable<Boolean> waitingForGodot) {
1322	<	long startTime = 0L;
1323	<	for (;;) {
1324	<	Thread.State s = thread.getState();
1325	<	if (s == Thread.State.BLOCKED ||
1326	<	s == Thread.State.WAITING ||
1327	<	s == Thread.State.TIMED_WAITING) {
1328	<	try {
1329	<	if (waitingForGodot.call())
1330	<	return;
1331	<	} catch (Throwable fail) { threadUnexpectedException(fail); }
1332	<	}
1333	<	else if (s == Thread.State.TERMINATED)
1334	<	fail("Unexpected thread termination");
1335	<	else if (startTime == 0L)
1336	<	startTime = System.nanoTime();
1337	<	else if (millisElapsedSince(startTime) > timeoutMillis) {
1338	<	threadAssertTrue(thread.isAlive());
1339	<	fail("timed out waiting for thread to enter wait state");
1340	<	}
1341	<	Thread.yield();
1342	<	}
1361	>	void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) {
1362	>	waitForThreadToEnterWaitState(thread, timeoutMillis, null);
1363		}
1364
1365		/**
#	Line 1347 | Line 1367 | public class JSR166TestCase extends Test
1367		* enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
1368		*/
1369		void waitForThreadToEnterWaitState(Thread thread) {
1370	<	waitForThreadToEnterWaitState(thread, LONG_DELAY_MS);
1370	>	waitForThreadToEnterWaitState(thread, LONG_DELAY_MS, null);
1371		}
1372
1373		/**
#	Line 1355 | Line 1375 | public class JSR166TestCase extends Test
1375		* enter a wait state: BLOCKED, WAITING, or TIMED_WAITING,
1376		* and additionally satisfy the given condition.
1377		*/
1378	<	void waitForThreadToEnterWaitState(
1379	<	Thread thread, Callable<Boolean> waitingForGodot) {
1378	>	void waitForThreadToEnterWaitState(Thread thread,
1379	>	Callable<Boolean> waitingForGodot) {
1380		waitForThreadToEnterWaitState(thread, LONG_DELAY_MS, waitingForGodot);
1381		}
1382
1383		/**
1384	+	* Spin-waits up to LONG_DELAY_MS milliseconds for the current thread to
1385	+	* be interrupted.  Clears the interrupt status before returning.
1386	+	*/
1387	+	void awaitInterrupted() {
1388	+	for (long startTime = 0L; !Thread.interrupted(); ) {
1389	+	if (startTime == 0L)
1390	+	startTime = System.nanoTime();
1391	+	else if (millisElapsedSince(startTime) > LONG_DELAY_MS)
1392	+	fail("timed out waiting for thread interrupt");
1393	+	Thread.yield();
1394	+	}
1395	+	}
1396	+
1397	+	/**
1398		* Returns the number of milliseconds since time given by
1399		* startNanoTime, which must have been previously returned from a
1400		* call to {@link System#nanoTime()}.
#	Line 1464 | Line 1498 | public class JSR166TestCase extends Test
1498		public final void run() {
1499		try {
1500		realRun();
1467	–	threadShouldThrow(exceptionClass.getSimpleName());
1501		} catch (Throwable t) {
1502		if (! exceptionClass.isInstance(t))
1503		threadUnexpectedException(t);
1504	+	return;
1505		}
1506	+	threadShouldThrow(exceptionClass.getSimpleName());
1507		}
1508		}
1509
#	Line 1478 | Line 1513 | public class JSR166TestCase extends Test
1513		public final void run() {
1514		try {
1515		realRun();
1481	–	threadShouldThrow("InterruptedException");
1516		} catch (InterruptedException success) {
1517		threadAssertFalse(Thread.interrupted());
1518	+	return;
1519		} catch (Throwable fail) {
1520		threadUnexpectedException(fail);
1521		}
1522	+	threadShouldThrow("InterruptedException");
1523		}
1524		}
1525
#	Line 1495 | Line 1531 | public class JSR166TestCase extends Test
1531		return realCall();
1532		} catch (Throwable fail) {
1533		threadUnexpectedException(fail);
1498	–	return null;
1534		}
1535	<	}
1501	<	}
1502	<
1503	<	public abstract class CheckedInterruptedCallable<T>
1504	<	implements Callable<T> {
1505	<	protected abstract T realCall() throws Throwable;
1506	<
1507	<	public final T call() {
1508	<	try {
1509	<	T result = realCall();
1510	<	threadShouldThrow("InterruptedException");
1511	<	return result;
1512	<	} catch (InterruptedException success) {
1513	<	threadAssertFalse(Thread.interrupted());
1514	<	} catch (Throwable fail) {
1515	<	threadUnexpectedException(fail);
1516	<	}
1517	<	return null;
1535	>	throw new AssertionError("unreached");
1536		}
1537		}
1538
#	Line 1571 | Line 1589 | public class JSR166TestCase extends Test
1589		}
1590
1591		public void await(CountDownLatch latch, long timeoutMillis) {
1592	+	boolean timedOut = false;
1593		try {
1594	<	if (!latch.await(timeoutMillis, MILLISECONDS))
1576	<	fail("timed out waiting for CountDownLatch for "
1577	<	+ (timeoutMillis/1000) + " sec");
1594	>	timedOut = !latch.await(timeoutMillis, MILLISECONDS);
1595		} catch (Throwable fail) {
1596		threadUnexpectedException(fail);
1597		}
1598	+	if (timedOut)
1599	+	fail("timed out waiting for CountDownLatch for "
1600	+	+ (timeoutMillis/1000) + " sec");
1601		}
1602
1603		public void await(CountDownLatch latch) {
#	Line 1585 | Line 1605 | public class JSR166TestCase extends Test
1605		}
1606
1607		public void await(Semaphore semaphore) {
1608	+	boolean timedOut = false;
1609		try {
1610	<	if (!semaphore.tryAcquire(LONG_DELAY_MS, MILLISECONDS))
1590	<	fail("timed out waiting for Semaphore for "
1591	<	+ (LONG_DELAY_MS/1000) + " sec");
1610	>	timedOut = !semaphore.tryAcquire(LONG_DELAY_MS, MILLISECONDS);
1611		} catch (Throwable fail) {
1612		threadUnexpectedException(fail);
1613		}
1614	+	if (timedOut)
1615	+	fail("timed out waiting for Semaphore for "
1616	+	+ (LONG_DELAY_MS/1000) + " sec");
1617		}
1618
1619		public void await(CyclicBarrier barrier) {
#	Line 1625 | Line 1647 | public class JSR166TestCase extends Test
1647		public String call() { throw new NullPointerException(); }
1648		}
1649
1628	–	public class SmallPossiblyInterruptedRunnable extends CheckedRunnable {
1629	–	protected void realRun() {
1630	–	try {
1631	–	delay(SMALL_DELAY_MS);
1632	–	} catch (InterruptedException ok) {}
1633	–	}
1634	–	}
1635	–
1650		public Runnable possiblyInterruptedRunnable(final long timeoutMillis) {
1651		return new CheckedRunnable() {
1652		protected void realRun() {
#	Line 1688 | Line 1702 | public class JSR166TestCase extends Test
1702		return realCompute();
1703		} catch (Throwable fail) {
1704		threadUnexpectedException(fail);
1691	–	return null;
1705		}
1706	+	throw new AssertionError("unreached");
1707		}
1708		}
1709
#	Line 1766 | Line 1780 | public class JSR166TestCase extends Test
1780		}
1781		}
1782
1783	<	void assertImmutable(final Object o) {
1783	>	void assertImmutable(Object o) {
1784		if (o instanceof Collection) {
1785		assertThrows(
1786		UnsupportedOperationException.class,
1787	<	new Runnable() { public void run() {
1774	<	((Collection) o).add(null);}});
1787	>	() -> ((Collection) o).add(null));
1788		}
1789		}
1790
1791		@SuppressWarnings("unchecked")
1792		<T> T serialClone(T o) {
1793	+	T clone = null;
1794		try {
1795		ObjectInputStream ois = new ObjectInputStream
1796		(new ByteArrayInputStream(serialBytes(o)));
1797	<	T clone = (T) ois.readObject();
1784	<	if (o == clone) assertImmutable(o);
1785	<	assertSame(o.getClass(), clone.getClass());
1786	<	return clone;
1797	>	clone = (T) ois.readObject();
1798		} catch (Throwable fail) {
1799		threadUnexpectedException(fail);
1789	–	return null;
1800		}
1801	+	if (o == clone) assertImmutable(o);
1802	+	else assertSame(o.getClass(), clone.getClass());
1803	+	return clone;
1804		}
1805
1806		/**
#	Line 1806 | Line 1819 | public class JSR166TestCase extends Test
1819		(new ByteArrayInputStream(bos.toByteArray()));
1820		T clone = (T) ois.readObject();
1821		if (o == clone) assertImmutable(o);
1822	<	assertSame(o.getClass(), clone.getClass());
1822	>	else assertSame(o.getClass(), clone.getClass());
1823		return clone;
1824		}
1825
#	Line 1831 | Line 1844 | public class JSR166TestCase extends Test
1844		}
1845
1846		public void assertThrows(Class<? extends Throwable> expectedExceptionClass,
1847	<	Runnable... throwingActions) {
1848	<	for (Runnable throwingAction : throwingActions) {
1847	>	Action... throwingActions) {
1848	>	for (Action throwingAction : throwingActions) {
1849		boolean threw = false;
1850		try { throwingAction.run(); }
1851		catch (Throwable t) {

Diff Legend

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