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; |
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 |
429 |
|
for (String testClassName : testClassNames) { |
430 |
|
try { |
431 |
|
Class<?> testClass = Class.forName(testClassName); |
432 |
< |
Method m = testClass.getDeclaredMethod("suite", |
422 |
< |
new Class<?>[0]); |
432 |
> |
Method m = testClass.getDeclaredMethod("suite"); |
433 |
|
suite.addTest(newTestSuite((Test)m.invoke(null))); |
434 |
< |
} catch (Exception e) { |
435 |
< |
throw new Error("Missing test class", e); |
434 |
> |
} catch (ReflectiveOperationException e) { |
435 |
> |
throw new AssertionError("Missing test class", e); |
436 |
|
} |
437 |
|
} |
438 |
|
} |
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. |
610 |
|
for (String methodName : testMethodNames(testClass)) |
611 |
|
suite.addTest((Test) c.newInstance(data, methodName)); |
612 |
|
return suite; |
613 |
< |
} catch (Exception e) { |
614 |
< |
throw new Error(e); |
613 |
> |
} catch (ReflectiveOperationException e) { |
614 |
> |
throw new AssertionError(e); |
615 |
|
} |
616 |
|
} |
617 |
|
|
627 |
|
if (atLeastJava8()) { |
628 |
|
String name = testClass.getName(); |
629 |
|
String name8 = name.replaceAll("Test$", "8Test"); |
630 |
< |
if (name.equals(name8)) throw new Error(name); |
630 |
> |
if (name.equals(name8)) throw new AssertionError(name); |
631 |
|
try { |
632 |
|
return (Test) |
633 |
|
Class.forName(name8) |
634 |
< |
.getMethod("testSuite", new Class[] { dataClass }) |
634 |
> |
.getMethod("testSuite", dataClass) |
635 |
|
.invoke(null, data); |
636 |
< |
} catch (Exception e) { |
637 |
< |
throw new Error(e); |
636 |
> |
} catch (ReflectiveOperationException e) { |
637 |
> |
throw new AssertionError(e); |
638 |
|
} |
639 |
|
} else { |
640 |
|
return new TestSuite(); |
1100 |
|
for (long retries = LONG_DELAY_MS * 3 / 4; retries-->0; ) { |
1101 |
|
try { delay(1); } |
1102 |
|
catch (InterruptedException fail) { |
1103 |
< |
fail("Unexpected InterruptedException"); |
1103 |
> |
throw new AssertionError("Unexpected InterruptedException", fail); |
1104 |
|
} |
1105 |
|
Thread.State s = thread.getState(); |
1106 |
|
if (s == expected) |
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 |
|
} |
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, |
1315 |
< |
* 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) { |
1319 |
< |
long startTime = 0L; |
1320 |
< |
for (;;) { |
1321 |
< |
Thread.State s = thread.getState(); |
1322 |
< |
if (s == Thread.State.BLOCKED || |
1323 |
< |
s == Thread.State.WAITING || |
1324 |
< |
s == Thread.State.TIMED_WAITING) { |
1325 |
< |
try { |
1326 |
< |
if (waitingForGodot.call()) |
1327 |
< |
return; |
1328 |
< |
} catch (Throwable fail) { threadUnexpectedException(fail); } |
1329 |
< |
} |
1330 |
< |
else if (s == Thread.State.TERMINATED) |
1331 |
< |
fail("Unexpected thread termination"); |
1332 |
< |
else if (startTime == 0L) |
1333 |
< |
startTime = System.nanoTime(); |
1334 |
< |
else if (millisElapsedSince(startTime) > timeoutMillis) { |
1335 |
< |
threadAssertTrue(thread.isAlive()); |
1336 |
< |
fail("timed out waiting for thread to enter wait state"); |
1337 |
< |
} |
1338 |
< |
Thread.yield(); |
1339 |
< |
} |
1338 |
> |
void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) { |
1339 |
> |
waitForThreadToEnterWaitState(thread, timeoutMillis, null); |
1340 |
|
} |
1341 |
|
|
1342 |
|
/** |
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 |
|
/** |
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 |
|
|
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 |
|
} |
1449 |
|
} |
1450 |
|
} |
1451 |
|
|
1450 |
– |
public abstract class RunnableShouldThrow implements Runnable { |
1451 |
– |
protected abstract void realRun() throws Throwable; |
1452 |
– |
|
1453 |
– |
final Class<?> exceptionClass; |
1454 |
– |
|
1455 |
– |
<T extends Throwable> RunnableShouldThrow(Class<T> exceptionClass) { |
1456 |
– |
this.exceptionClass = exceptionClass; |
1457 |
– |
} |
1458 |
– |
|
1459 |
– |
public final void run() { |
1460 |
– |
try { |
1461 |
– |
realRun(); |
1462 |
– |
threadShouldThrow(exceptionClass.getSimpleName()); |
1463 |
– |
} catch (Throwable t) { |
1464 |
– |
if (! exceptionClass.isInstance(t)) |
1465 |
– |
threadUnexpectedException(t); |
1466 |
– |
} |
1467 |
– |
} |
1468 |
– |
} |
1469 |
– |
|
1452 |
|
public abstract class ThreadShouldThrow extends Thread { |
1453 |
|
protected abstract void realRun() throws Throwable; |
1454 |
|
|
1461 |
|
public final void run() { |
1462 |
|
try { |
1463 |
|
realRun(); |
1482 |
– |
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 |
|
|
1476 |
|
public final void run() { |
1477 |
|
try { |
1478 |
|
realRun(); |
1496 |
– |
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 |
|
|
1494 |
|
return realCall(); |
1495 |
|
} catch (Throwable fail) { |
1496 |
|
threadUnexpectedException(fail); |
1513 |
– |
return null; |
1514 |
– |
} |
1515 |
– |
} |
1516 |
– |
} |
1517 |
– |
|
1518 |
– |
public abstract class CheckedInterruptedCallable<T> |
1519 |
– |
implements Callable<T> { |
1520 |
– |
protected abstract T realCall() throws Throwable; |
1521 |
– |
|
1522 |
– |
public final T call() { |
1523 |
– |
try { |
1524 |
– |
T result = realCall(); |
1525 |
– |
threadShouldThrow("InterruptedException"); |
1526 |
– |
return result; |
1527 |
– |
} catch (InterruptedException success) { |
1528 |
– |
threadAssertFalse(Thread.interrupted()); |
1529 |
– |
} catch (Throwable fail) { |
1530 |
– |
threadUnexpectedException(fail); |
1497 |
|
} |
1498 |
< |
return null; |
1498 |
> |
throw new AssertionError("unreached"); |
1499 |
|
} |
1500 |
|
} |
1501 |
|
|
1552 |
|
} |
1553 |
|
|
1554 |
|
public void await(CountDownLatch latch, long timeoutMillis) { |
1555 |
+ |
boolean timedOut = false; |
1556 |
|
try { |
1557 |
< |
if (!latch.await(timeoutMillis, MILLISECONDS)) |
1591 |
< |
fail("timed out waiting for CountDownLatch for " |
1592 |
< |
+ (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) { |
1568 |
|
} |
1569 |
|
|
1570 |
|
public void await(Semaphore semaphore) { |
1571 |
+ |
boolean timedOut = false; |
1572 |
|
try { |
1573 |
< |
if (!semaphore.tryAcquire(LONG_DELAY_MS, MILLISECONDS)) |
1605 |
< |
fail("timed out waiting for Semaphore for " |
1606 |
< |
+ (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) { |
1610 |
|
public String call() { throw new NullPointerException(); } |
1611 |
|
} |
1612 |
|
|
1643 |
– |
public class SmallPossiblyInterruptedRunnable extends CheckedRunnable { |
1644 |
– |
protected void realRun() { |
1645 |
– |
try { |
1646 |
– |
delay(SMALL_DELAY_MS); |
1647 |
– |
} catch (InterruptedException ok) {} |
1648 |
– |
} |
1649 |
– |
} |
1650 |
– |
|
1613 |
|
public Runnable possiblyInterruptedRunnable(final long timeoutMillis) { |
1614 |
|
return new CheckedRunnable() { |
1615 |
|
protected void realRun() { |
1665 |
|
return realCompute(); |
1666 |
|
} catch (Throwable fail) { |
1667 |
|
threadUnexpectedException(fail); |
1706 |
– |
return null; |
1668 |
|
} |
1669 |
+ |
throw new AssertionError("unreached"); |
1670 |
|
} |
1671 |
|
} |
1672 |
|
|
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(); |
1799 |
< |
if (o == clone) assertImmutable(o); |
1800 |
< |
assertSame(o.getClass(), clone.getClass()); |
1801 |
< |
return clone; |
1761 |
> |
clone = (T) ois.readObject(); |
1762 |
|
} catch (Throwable fail) { |
1763 |
|
threadUnexpectedException(fail); |
1804 |
– |
return null; |
1764 |
|
} |
1765 |
+ |
if (o == clone) assertImmutable(o); |
1766 |
+ |
else assertSame(o.getClass(), clone.getClass()); |
1767 |
+ |
return clone; |
1768 |
|
} |
1769 |
|
|
1770 |
|
/** |
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 |
|
|
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 |
|
} |