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; |
102 |
|
import java.util.concurrent.atomic.AtomicReference; |
103 |
|
import java.util.regex.Pattern; |
104 |
|
|
102 |
– |
import junit.framework.AssertionFailedError; |
105 |
|
import junit.framework.Test; |
106 |
|
import junit.framework.TestCase; |
107 |
|
import junit.framework.TestResult; |
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 |
284 |
|
static volatile TestCase currentTestCase; |
285 |
|
// static volatile int currentRun = 0; |
286 |
|
static { |
287 |
< |
Runnable checkForWedgedTest = new Runnable() { public void run() { |
287 |
> |
Runnable wedgedTestDetector = new Runnable() { public void run() { |
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; } |
310 |
|
} |
311 |
|
lastTestCase = currentTestCase; |
312 |
|
}}}; |
313 |
< |
Thread thread = new Thread(checkForWedgedTest, "checkForWedgedTest"); |
313 |
> |
Thread thread = new Thread(wedgedTestDetector, "WedgedTestDetector"); |
314 |
|
thread.setDaemon(true); |
315 |
|
thread.start(); |
316 |
|
} |
430 |
|
for (String testClassName : testClassNames) { |
431 |
|
try { |
432 |
|
Class<?> testClass = Class.forName(testClassName); |
433 |
< |
Method m = testClass.getDeclaredMethod("suite", |
423 |
< |
new Class<?>[0]); |
433 |
> |
Method m = testClass.getDeclaredMethod("suite"); |
434 |
|
suite.addTest(newTestSuite((Test)m.invoke(null))); |
435 |
< |
} catch (Exception e) { |
436 |
< |
throw new Error("Missing test class", e); |
435 |
> |
} catch (ReflectiveOperationException e) { |
436 |
> |
throw new AssertionError("Missing test class", e); |
437 |
|
} |
438 |
|
} |
439 |
|
} |
455 |
|
} |
456 |
|
} |
457 |
|
|
458 |
< |
public static boolean atLeastJava6() { return JAVA_CLASS_VERSION >= 50.0; } |
459 |
< |
public static boolean atLeastJava7() { return JAVA_CLASS_VERSION >= 51.0; } |
460 |
< |
public static boolean atLeastJava8() { return JAVA_CLASS_VERSION >= 52.0; } |
461 |
< |
public static boolean atLeastJava9() { |
462 |
< |
return JAVA_CLASS_VERSION >= 53.0 |
463 |
< |
// As of 2015-09, java9 still uses 52.0 class file version |
464 |
< |
|| JAVA_SPECIFICATION_VERSION.matches("^(1\\.)?(9|[0-9][0-9])$"); |
465 |
< |
} |
466 |
< |
public static boolean atLeastJava10() { |
467 |
< |
return JAVA_CLASS_VERSION >= 54.0 |
468 |
< |
|| JAVA_SPECIFICATION_VERSION.matches("^(1\\.)?[0-9][0-9]$"); |
469 |
< |
} |
458 |
> |
public static boolean atLeastJava6() { return JAVA_CLASS_VERSION >= 50.0; } |
459 |
> |
public static boolean atLeastJava7() { return JAVA_CLASS_VERSION >= 51.0; } |
460 |
> |
public static boolean atLeastJava8() { return JAVA_CLASS_VERSION >= 52.0; } |
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. |
518 |
|
ExecutorsTest.suite(), |
519 |
|
ExecutorCompletionServiceTest.suite(), |
520 |
|
FutureTaskTest.suite(), |
521 |
+ |
HashtableTest.suite(), |
522 |
|
LinkedBlockingDequeTest.suite(), |
523 |
|
LinkedBlockingQueueTest.suite(), |
524 |
|
LinkedListTest.suite(), |
555 |
|
"DoubleAdderTest", |
556 |
|
"ForkJoinPool8Test", |
557 |
|
"ForkJoinTask8Test", |
558 |
+ |
"HashMapTest", |
559 |
|
"LinkedBlockingDeque8Test", |
560 |
|
"LinkedBlockingQueue8Test", |
561 |
+ |
"LinkedHashMapTest", |
562 |
|
"LongAccumulatorTest", |
563 |
|
"LongAdderTest", |
564 |
|
"SplittableRandomTest", |
619 |
|
for (String methodName : testMethodNames(testClass)) |
620 |
|
suite.addTest((Test) c.newInstance(data, methodName)); |
621 |
|
return suite; |
622 |
< |
} catch (Exception e) { |
623 |
< |
throw new Error(e); |
622 |
> |
} catch (ReflectiveOperationException e) { |
623 |
> |
throw new AssertionError(e); |
624 |
|
} |
625 |
|
} |
626 |
|
|
636 |
|
if (atLeastJava8()) { |
637 |
|
String name = testClass.getName(); |
638 |
|
String name8 = name.replaceAll("Test$", "8Test"); |
639 |
< |
if (name.equals(name8)) throw new Error(name); |
639 |
> |
if (name.equals(name8)) throw new AssertionError(name); |
640 |
|
try { |
641 |
|
return (Test) |
642 |
|
Class.forName(name8) |
643 |
< |
.getMethod("testSuite", new Class[] { dataClass }) |
643 |
> |
.getMethod("testSuite", dataClass) |
644 |
|
.invoke(null, data); |
645 |
< |
} catch (Exception e) { |
646 |
< |
throw new Error(e); |
645 |
> |
} catch (ReflectiveOperationException e) { |
646 |
> |
throw new AssertionError(e); |
647 |
|
} |
648 |
|
} else { |
649 |
|
return new TestSuite(); |
657 |
|
public static long MEDIUM_DELAY_MS; |
658 |
|
public static long LONG_DELAY_MS; |
659 |
|
|
660 |
+ |
/** |
661 |
+ |
* A delay significantly longer than LONG_DELAY_MS. |
662 |
+ |
* Use this in a thread that is waited for via awaitTermination(Thread). |
663 |
+ |
*/ |
664 |
+ |
public static long LONGER_DELAY_MS; |
665 |
+ |
|
666 |
|
private static final long RANDOM_TIMEOUT; |
667 |
|
private static final long RANDOM_EXPIRED_TIMEOUT; |
668 |
|
private static final TimeUnit RANDOM_TIMEUNIT; |
691 |
|
static TimeUnit randomTimeUnit() { return RANDOM_TIMEUNIT; } |
692 |
|
|
693 |
|
/** |
694 |
+ |
* Returns a random boolean; a "coin flip". |
695 |
+ |
*/ |
696 |
+ |
static boolean randomBoolean() { |
697 |
+ |
return ThreadLocalRandom.current().nextBoolean(); |
698 |
+ |
} |
699 |
+ |
|
700 |
+ |
/** |
701 |
+ |
* Returns a random element from given choices. |
702 |
+ |
*/ |
703 |
+ |
<T> T chooseRandomly(T... choices) { |
704 |
+ |
return choices[ThreadLocalRandom.current().nextInt(choices.length)]; |
705 |
+ |
} |
706 |
+ |
|
707 |
+ |
/** |
708 |
|
* Returns the shortest timed delay. This can be scaled up for |
709 |
|
* slow machines using the jsr166.delay.factor system property, |
710 |
|
* or via jtreg's -timeoutFactor: flag. |
722 |
|
SMALL_DELAY_MS = SHORT_DELAY_MS * 5; |
723 |
|
MEDIUM_DELAY_MS = SHORT_DELAY_MS * 10; |
724 |
|
LONG_DELAY_MS = SHORT_DELAY_MS * 200; |
725 |
+ |
LONGER_DELAY_MS = 2 * LONG_DELAY_MS; |
726 |
|
} |
727 |
|
|
728 |
|
private static final long TIMEOUT_DELAY_MS |
761 |
|
*/ |
762 |
|
public void threadRecordFailure(Throwable t) { |
763 |
|
System.err.println(t); |
764 |
< |
dumpTestThreads(); |
765 |
< |
threadFailure.compareAndSet(null, t); |
764 |
> |
if (threadFailure.compareAndSet(null, t)) |
765 |
> |
dumpTestThreads(); |
766 |
|
} |
767 |
|
|
768 |
|
public void setUp() { |
773 |
|
String msg = toString() + ": " + String.format(format, args); |
774 |
|
System.err.println(msg); |
775 |
|
dumpTestThreads(); |
776 |
< |
throw new AssertionFailedError(msg); |
776 |
> |
throw new AssertionError(msg); |
777 |
|
} |
778 |
|
|
779 |
|
/** |
794 |
|
throw (RuntimeException) t; |
795 |
|
else if (t instanceof Exception) |
796 |
|
throw (Exception) t; |
797 |
< |
else { |
798 |
< |
AssertionFailedError afe = |
765 |
< |
new AssertionFailedError(t.toString()); |
766 |
< |
afe.initCause(t); |
767 |
< |
throw afe; |
768 |
< |
} |
797 |
> |
else |
798 |
> |
throw new AssertionError(t.toString(), t); |
799 |
|
} |
800 |
|
|
801 |
|
if (Thread.interrupted()) |
829 |
|
|
830 |
|
/** |
831 |
|
* Just like fail(reason), but additionally recording (using |
832 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
833 |
< |
* the current testcase will fail. |
832 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
833 |
> |
* current testcase will fail. |
834 |
|
*/ |
835 |
|
public void threadFail(String reason) { |
836 |
|
try { |
837 |
|
fail(reason); |
838 |
< |
} catch (AssertionFailedError t) { |
839 |
< |
threadRecordFailure(t); |
840 |
< |
throw t; |
838 |
> |
} catch (AssertionError fail) { |
839 |
> |
threadRecordFailure(fail); |
840 |
> |
throw fail; |
841 |
|
} |
842 |
|
} |
843 |
|
|
844 |
|
/** |
845 |
|
* Just like assertTrue(b), but additionally recording (using |
846 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
847 |
< |
* the current testcase will fail. |
846 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
847 |
> |
* current testcase will fail. |
848 |
|
*/ |
849 |
|
public void threadAssertTrue(boolean b) { |
850 |
|
try { |
851 |
|
assertTrue(b); |
852 |
< |
} catch (AssertionFailedError t) { |
853 |
< |
threadRecordFailure(t); |
854 |
< |
throw t; |
852 |
> |
} catch (AssertionError fail) { |
853 |
> |
threadRecordFailure(fail); |
854 |
> |
throw fail; |
855 |
|
} |
856 |
|
} |
857 |
|
|
858 |
|
/** |
859 |
|
* Just like assertFalse(b), but additionally recording (using |
860 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
861 |
< |
* the current testcase will fail. |
860 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
861 |
> |
* current testcase will fail. |
862 |
|
*/ |
863 |
|
public void threadAssertFalse(boolean b) { |
864 |
|
try { |
865 |
|
assertFalse(b); |
866 |
< |
} catch (AssertionFailedError t) { |
867 |
< |
threadRecordFailure(t); |
868 |
< |
throw t; |
866 |
> |
} catch (AssertionError fail) { |
867 |
> |
threadRecordFailure(fail); |
868 |
> |
throw fail; |
869 |
|
} |
870 |
|
} |
871 |
|
|
872 |
|
/** |
873 |
|
* Just like assertNull(x), but additionally recording (using |
874 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
875 |
< |
* the current testcase will fail. |
874 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
875 |
> |
* current testcase will fail. |
876 |
|
*/ |
877 |
|
public void threadAssertNull(Object x) { |
878 |
|
try { |
879 |
|
assertNull(x); |
880 |
< |
} catch (AssertionFailedError t) { |
881 |
< |
threadRecordFailure(t); |
882 |
< |
throw t; |
880 |
> |
} catch (AssertionError fail) { |
881 |
> |
threadRecordFailure(fail); |
882 |
> |
throw fail; |
883 |
|
} |
884 |
|
} |
885 |
|
|
886 |
|
/** |
887 |
|
* Just like assertEquals(x, y), but additionally recording (using |
888 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
889 |
< |
* the current testcase will fail. |
888 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
889 |
> |
* current testcase will fail. |
890 |
|
*/ |
891 |
|
public void threadAssertEquals(long x, long y) { |
892 |
|
try { |
893 |
|
assertEquals(x, y); |
894 |
< |
} catch (AssertionFailedError t) { |
895 |
< |
threadRecordFailure(t); |
896 |
< |
throw t; |
894 |
> |
} catch (AssertionError fail) { |
895 |
> |
threadRecordFailure(fail); |
896 |
> |
throw fail; |
897 |
|
} |
898 |
|
} |
899 |
|
|
900 |
|
/** |
901 |
|
* Just like assertEquals(x, y), but additionally recording (using |
902 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
903 |
< |
* the current testcase will fail. |
902 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
903 |
> |
* current testcase will fail. |
904 |
|
*/ |
905 |
|
public void threadAssertEquals(Object x, Object y) { |
906 |
|
try { |
907 |
|
assertEquals(x, y); |
908 |
< |
} catch (AssertionFailedError fail) { |
908 |
> |
} catch (AssertionError fail) { |
909 |
|
threadRecordFailure(fail); |
910 |
|
throw fail; |
911 |
|
} catch (Throwable fail) { |
915 |
|
|
916 |
|
/** |
917 |
|
* Just like assertSame(x, y), but additionally recording (using |
918 |
< |
* threadRecordFailure) any AssertionFailedError thrown, so that |
919 |
< |
* the current testcase will fail. |
918 |
> |
* threadRecordFailure) any AssertionError thrown, so that the |
919 |
> |
* current testcase will fail. |
920 |
|
*/ |
921 |
|
public void threadAssertSame(Object x, Object y) { |
922 |
|
try { |
923 |
|
assertSame(x, y); |
924 |
< |
} catch (AssertionFailedError fail) { |
924 |
> |
} catch (AssertionError fail) { |
925 |
|
threadRecordFailure(fail); |
926 |
|
throw fail; |
927 |
|
} |
943 |
|
|
944 |
|
/** |
945 |
|
* Records the given exception using {@link #threadRecordFailure}, |
946 |
< |
* then rethrows the exception, wrapping it in an |
947 |
< |
* AssertionFailedError if necessary. |
946 |
> |
* then rethrows the exception, wrapping it in an AssertionError |
947 |
> |
* if necessary. |
948 |
|
*/ |
949 |
|
public void threadUnexpectedException(Throwable t) { |
950 |
|
threadRecordFailure(t); |
953 |
|
throw (RuntimeException) t; |
954 |
|
else if (t instanceof Error) |
955 |
|
throw (Error) t; |
956 |
< |
else { |
957 |
< |
AssertionFailedError afe = |
928 |
< |
new AssertionFailedError("unexpected exception: " + t); |
929 |
< |
afe.initCause(t); |
930 |
< |
throw afe; |
931 |
< |
} |
956 |
> |
else |
957 |
> |
throw new AssertionError("unexpected exception: " + t, t); |
958 |
|
} |
959 |
|
|
960 |
|
/** |
1106 |
|
continue; |
1107 |
|
if ("Reference Handler".equals(name) |
1108 |
|
&& (lockName = info.getLockName()) != null |
1109 |
< |
&& lockName.startsWith("java.lang.ref.Reference$Lock")) |
1109 |
> |
&& lockName.startsWith("java.lang.ref")) |
1110 |
|
continue; |
1111 |
< |
if ("Finalizer".equals(name) |
1111 |
> |
if (("Finalizer".equals(name) || "Common-Cleaner".equals(name)) |
1112 |
|
&& (lockName = info.getLockName()) != null |
1113 |
< |
&& lockName.startsWith("java.lang.ref.ReferenceQueue$Lock")) |
1113 |
> |
&& lockName.startsWith("java.lang.ref")) |
1114 |
|
continue; |
1115 |
< |
if ("checkForWedgedTest".equals(name)) |
1115 |
> |
if ("WedgedTestDetector".equals(name)) |
1116 |
|
continue; |
1117 |
|
System.err.print(info); |
1118 |
|
} |
1130 |
|
for (long retries = LONG_DELAY_MS * 3 / 4; retries-->0; ) { |
1131 |
|
try { delay(1); } |
1132 |
|
catch (InterruptedException fail) { |
1133 |
< |
fail("Unexpected InterruptedException"); |
1133 |
> |
throw new AssertionError("Unexpected InterruptedException", fail); |
1134 |
|
} |
1135 |
|
Thread.State s = thread.getState(); |
1136 |
|
if (s == expected) |
1316 |
|
|
1317 |
|
/** |
1318 |
|
* Sleeps until the given time has elapsed. |
1319 |
< |
* Throws AssertionFailedError if interrupted. |
1319 |
> |
* Throws AssertionError if interrupted. |
1320 |
|
*/ |
1321 |
|
static void sleep(long millis) { |
1322 |
|
try { |
1323 |
|
delay(millis); |
1324 |
|
} catch (InterruptedException fail) { |
1325 |
< |
AssertionFailedError afe = |
1300 |
< |
new AssertionFailedError("Unexpected InterruptedException"); |
1301 |
< |
afe.initCause(fail); |
1302 |
< |
throw afe; |
1325 |
> |
throw new AssertionError("Unexpected InterruptedException", fail); |
1326 |
|
} |
1327 |
|
} |
1328 |
|
|
1329 |
|
/** |
1330 |
|
* Spin-waits up to the specified number of milliseconds for the given |
1331 |
|
* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING. |
1332 |
+ |
* @param waitingForGodot if non-null, an additional condition to satisfy |
1333 |
|
*/ |
1334 |
< |
void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) { |
1335 |
< |
long startTime = 0L; |
1336 |
< |
for (;;) { |
1337 |
< |
Thread.State s = thread.getState(); |
1338 |
< |
if (s == Thread.State.BLOCKED || |
1339 |
< |
s == Thread.State.WAITING || |
1340 |
< |
s == Thread.State.TIMED_WAITING) |
1341 |
< |
return; |
1342 |
< |
else if (s == Thread.State.TERMINATED) |
1334 |
> |
void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis, |
1335 |
> |
Callable<Boolean> waitingForGodot) { |
1336 |
> |
for (long startTime = 0L;;) { |
1337 |
> |
switch (thread.getState()) { |
1338 |
> |
default: break; |
1339 |
> |
case BLOCKED: case WAITING: case TIMED_WAITING: |
1340 |
> |
try { |
1341 |
> |
if (waitingForGodot == null || waitingForGodot.call()) |
1342 |
> |
return; |
1343 |
> |
} catch (Throwable fail) { threadUnexpectedException(fail); } |
1344 |
> |
break; |
1345 |
> |
case TERMINATED: |
1346 |
|
fail("Unexpected thread termination"); |
1347 |
< |
else if (startTime == 0L) |
1347 |
> |
} |
1348 |
> |
|
1349 |
> |
if (startTime == 0L) |
1350 |
|
startTime = System.nanoTime(); |
1351 |
|
else if (millisElapsedSince(startTime) > timeoutMillis) { |
1352 |
< |
threadAssertTrue(thread.isAlive()); |
1353 |
< |
fail("timed out waiting for thread to enter wait state"); |
1352 |
> |
assertTrue(thread.isAlive()); |
1353 |
> |
if (waitingForGodot == null |
1354 |
> |
|| thread.getState() == Thread.State.RUNNABLE) |
1355 |
> |
fail("timed out waiting for thread to enter wait state"); |
1356 |
> |
else |
1357 |
> |
fail("timed out waiting for condition, thread state=" |
1358 |
> |
+ thread.getState()); |
1359 |
|
} |
1360 |
|
Thread.yield(); |
1361 |
|
} |
1363 |
|
|
1364 |
|
/** |
1365 |
|
* Spin-waits up to the specified number of milliseconds for the given |
1366 |
< |
* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING, |
1333 |
< |
* and additionally satisfy the given condition. |
1366 |
> |
* thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING. |
1367 |
|
*/ |
1368 |
< |
void waitForThreadToEnterWaitState( |
1369 |
< |
Thread thread, long timeoutMillis, Callable<Boolean> waitingForGodot) { |
1337 |
< |
long startTime = 0L; |
1338 |
< |
for (;;) { |
1339 |
< |
Thread.State s = thread.getState(); |
1340 |
< |
if (s == Thread.State.BLOCKED || |
1341 |
< |
s == Thread.State.WAITING || |
1342 |
< |
s == Thread.State.TIMED_WAITING) { |
1343 |
< |
try { |
1344 |
< |
if (waitingForGodot.call()) |
1345 |
< |
return; |
1346 |
< |
} catch (Throwable fail) { threadUnexpectedException(fail); } |
1347 |
< |
} |
1348 |
< |
else if (s == Thread.State.TERMINATED) |
1349 |
< |
fail("Unexpected thread termination"); |
1350 |
< |
else if (startTime == 0L) |
1351 |
< |
startTime = System.nanoTime(); |
1352 |
< |
else if (millisElapsedSince(startTime) > timeoutMillis) { |
1353 |
< |
threadAssertTrue(thread.isAlive()); |
1354 |
< |
fail("timed out waiting for thread to enter wait state"); |
1355 |
< |
} |
1356 |
< |
Thread.yield(); |
1357 |
< |
} |
1368 |
> |
void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) { |
1369 |
> |
waitForThreadToEnterWaitState(thread, timeoutMillis, null); |
1370 |
|
} |
1371 |
|
|
1372 |
|
/** |
1374 |
|
* enter a wait state: BLOCKED, WAITING, or TIMED_WAITING. |
1375 |
|
*/ |
1376 |
|
void waitForThreadToEnterWaitState(Thread thread) { |
1377 |
< |
waitForThreadToEnterWaitState(thread, LONG_DELAY_MS); |
1377 |
> |
waitForThreadToEnterWaitState(thread, LONG_DELAY_MS, null); |
1378 |
|
} |
1379 |
|
|
1380 |
|
/** |
1382 |
|
* enter a wait state: BLOCKED, WAITING, or TIMED_WAITING, |
1383 |
|
* and additionally satisfy the given condition. |
1384 |
|
*/ |
1385 |
< |
void waitForThreadToEnterWaitState( |
1386 |
< |
Thread thread, Callable<Boolean> waitingForGodot) { |
1385 |
> |
void waitForThreadToEnterWaitState(Thread thread, |
1386 |
> |
Callable<Boolean> waitingForGodot) { |
1387 |
|
waitForThreadToEnterWaitState(thread, LONG_DELAY_MS, waitingForGodot); |
1388 |
|
} |
1389 |
|
|
1390 |
|
/** |
1391 |
+ |
* Spin-waits up to LONG_DELAY_MS milliseconds for the current thread to |
1392 |
+ |
* be interrupted. Clears the interrupt status before returning. |
1393 |
+ |
*/ |
1394 |
+ |
void awaitInterrupted() { |
1395 |
+ |
for (long startTime = 0L; !Thread.interrupted(); ) { |
1396 |
+ |
if (startTime == 0L) |
1397 |
+ |
startTime = System.nanoTime(); |
1398 |
+ |
else if (millisElapsedSince(startTime) > LONG_DELAY_MS) |
1399 |
+ |
fail("timed out waiting for thread interrupt"); |
1400 |
+ |
Thread.yield(); |
1401 |
+ |
} |
1402 |
+ |
} |
1403 |
+ |
|
1404 |
+ |
/** |
1405 |
|
* Returns the number of milliseconds since time given by |
1406 |
|
* startNanoTime, which must have been previously returned from a |
1407 |
|
* call to {@link System#nanoTime()}. |
1410 |
|
return NANOSECONDS.toMillis(System.nanoTime() - startNanoTime); |
1411 |
|
} |
1412 |
|
|
1387 |
– |
// void assertTerminatesPromptly(long timeoutMillis, Runnable r) { |
1388 |
– |
// long startTime = System.nanoTime(); |
1389 |
– |
// try { |
1390 |
– |
// r.run(); |
1391 |
– |
// } catch (Throwable fail) { threadUnexpectedException(fail); } |
1392 |
– |
// if (millisElapsedSince(startTime) > timeoutMillis/2) |
1393 |
– |
// throw new AssertionFailedError("did not return promptly"); |
1394 |
– |
// } |
1395 |
– |
|
1396 |
– |
// void assertTerminatesPromptly(Runnable r) { |
1397 |
– |
// assertTerminatesPromptly(LONG_DELAY_MS/2, r); |
1398 |
– |
// } |
1399 |
– |
|
1413 |
|
/** |
1414 |
|
* Checks that timed f.get() returns the expected value, and does not |
1415 |
|
* wait for the timeout to elapse before returning. |
1416 |
|
*/ |
1417 |
|
<T> void checkTimedGet(Future<T> f, T expectedValue, long timeoutMillis) { |
1418 |
|
long startTime = System.nanoTime(); |
1419 |
+ |
T actual = null; |
1420 |
|
try { |
1421 |
< |
assertEquals(expectedValue, f.get(timeoutMillis, MILLISECONDS)); |
1421 |
> |
actual = f.get(timeoutMillis, MILLISECONDS); |
1422 |
|
} catch (Throwable fail) { threadUnexpectedException(fail); } |
1423 |
+ |
assertEquals(expectedValue, actual); |
1424 |
|
if (millisElapsedSince(startTime) > timeoutMillis/2) |
1425 |
< |
throw new AssertionFailedError("timed get did not return promptly"); |
1425 |
> |
throw new AssertionError("timed get did not return promptly"); |
1426 |
|
} |
1427 |
|
|
1428 |
|
<T> void checkTimedGet(Future<T> f, T expectedValue) { |
1444 |
|
* to terminate (using {@link Thread#join(long)}), else interrupts |
1445 |
|
* the thread (in the hope that it may terminate later) and fails. |
1446 |
|
*/ |
1447 |
< |
void awaitTermination(Thread t, long timeoutMillis) { |
1447 |
> |
void awaitTermination(Thread thread, long timeoutMillis) { |
1448 |
|
try { |
1449 |
< |
t.join(timeoutMillis); |
1449 |
> |
thread.join(timeoutMillis); |
1450 |
|
} catch (InterruptedException fail) { |
1451 |
|
threadUnexpectedException(fail); |
1452 |
< |
} finally { |
1453 |
< |
if (t.getState() != Thread.State.TERMINATED) { |
1454 |
< |
t.interrupt(); |
1455 |
< |
threadFail("timed out waiting for thread to terminate"); |
1452 |
> |
} |
1453 |
> |
if (thread.getState() != Thread.State.TERMINATED) { |
1454 |
> |
String detail = String.format( |
1455 |
> |
"timed out waiting for thread to terminate, thread=%s, state=%s" , |
1456 |
> |
thread, thread.getState()); |
1457 |
> |
try { |
1458 |
> |
threadFail(detail); |
1459 |
> |
} finally { |
1460 |
> |
// Interrupt thread __after__ having reported its stack trace |
1461 |
> |
thread.interrupt(); |
1462 |
|
} |
1463 |
|
} |
1464 |
|
} |
1486 |
|
} |
1487 |
|
} |
1488 |
|
|
1468 |
– |
public abstract class RunnableShouldThrow implements Runnable { |
1469 |
– |
protected abstract void realRun() throws Throwable; |
1470 |
– |
|
1471 |
– |
final Class<?> exceptionClass; |
1472 |
– |
|
1473 |
– |
<T extends Throwable> RunnableShouldThrow(Class<T> exceptionClass) { |
1474 |
– |
this.exceptionClass = exceptionClass; |
1475 |
– |
} |
1476 |
– |
|
1477 |
– |
public final void run() { |
1478 |
– |
try { |
1479 |
– |
realRun(); |
1480 |
– |
threadShouldThrow(exceptionClass.getSimpleName()); |
1481 |
– |
} catch (Throwable t) { |
1482 |
– |
if (! exceptionClass.isInstance(t)) |
1483 |
– |
threadUnexpectedException(t); |
1484 |
– |
} |
1485 |
– |
} |
1486 |
– |
} |
1487 |
– |
|
1489 |
|
public abstract class ThreadShouldThrow extends Thread { |
1490 |
|
protected abstract void realRun() throws Throwable; |
1491 |
|
|
1498 |
|
public final void run() { |
1499 |
|
try { |
1500 |
|
realRun(); |
1500 |
– |
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 |
|
|
1513 |
|
public final void run() { |
1514 |
|
try { |
1515 |
|
realRun(); |
1514 |
– |
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 |
|
|
1531 |
|
return realCall(); |
1532 |
|
} catch (Throwable fail) { |
1533 |
|
threadUnexpectedException(fail); |
1531 |
– |
return null; |
1534 |
|
} |
1535 |
< |
} |
1534 |
< |
} |
1535 |
< |
|
1536 |
< |
public abstract class CheckedInterruptedCallable<T> |
1537 |
< |
implements Callable<T> { |
1538 |
< |
protected abstract T realCall() throws Throwable; |
1539 |
< |
|
1540 |
< |
public final T call() { |
1541 |
< |
try { |
1542 |
< |
T result = realCall(); |
1543 |
< |
threadShouldThrow("InterruptedException"); |
1544 |
< |
return result; |
1545 |
< |
} catch (InterruptedException success) { |
1546 |
< |
threadAssertFalse(Thread.interrupted()); |
1547 |
< |
} catch (Throwable fail) { |
1548 |
< |
threadUnexpectedException(fail); |
1549 |
< |
} |
1550 |
< |
return null; |
1535 |
> |
throw new AssertionError("unreached"); |
1536 |
|
} |
1537 |
|
} |
1538 |
|
|
1589 |
|
} |
1590 |
|
|
1591 |
|
public void await(CountDownLatch latch, long timeoutMillis) { |
1592 |
+ |
boolean timedOut = false; |
1593 |
|
try { |
1594 |
< |
if (!latch.await(timeoutMillis, MILLISECONDS)) |
1609 |
< |
fail("timed out waiting for CountDownLatch for " |
1610 |
< |
+ (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) { |
1605 |
|
} |
1606 |
|
|
1607 |
|
public void await(Semaphore semaphore) { |
1608 |
+ |
boolean timedOut = false; |
1609 |
|
try { |
1610 |
< |
if (!semaphore.tryAcquire(LONG_DELAY_MS, MILLISECONDS)) |
1623 |
< |
fail("timed out waiting for Semaphore for " |
1624 |
< |
+ (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) { |
1638 |
|
// long startTime = System.nanoTime(); |
1639 |
|
// while (!flag.get()) { |
1640 |
|
// if (millisElapsedSince(startTime) > timeoutMillis) |
1641 |
< |
// throw new AssertionFailedError("timed out"); |
1641 |
> |
// throw new AssertionError("timed out"); |
1642 |
|
// Thread.yield(); |
1643 |
|
// } |
1644 |
|
// } |
1647 |
|
public String call() { throw new NullPointerException(); } |
1648 |
|
} |
1649 |
|
|
1661 |
– |
public class SmallPossiblyInterruptedRunnable extends CheckedRunnable { |
1662 |
– |
protected void realRun() { |
1663 |
– |
try { |
1664 |
– |
delay(SMALL_DELAY_MS); |
1665 |
– |
} catch (InterruptedException ok) {} |
1666 |
– |
} |
1667 |
– |
} |
1668 |
– |
|
1650 |
|
public Runnable possiblyInterruptedRunnable(final long timeoutMillis) { |
1651 |
|
return new CheckedRunnable() { |
1652 |
|
protected void realRun() { |
1702 |
|
return realCompute(); |
1703 |
|
} catch (Throwable fail) { |
1704 |
|
threadUnexpectedException(fail); |
1724 |
– |
return null; |
1705 |
|
} |
1706 |
+ |
throw new AssertionError("unreached"); |
1707 |
|
} |
1708 |
|
} |
1709 |
|
|
1717 |
|
|
1718 |
|
/** |
1719 |
|
* A CyclicBarrier that uses timed await and fails with |
1720 |
< |
* AssertionFailedErrors instead of throwing checked exceptions. |
1720 |
> |
* AssertionErrors instead of throwing checked exceptions. |
1721 |
|
*/ |
1722 |
|
public static class CheckedBarrier extends CyclicBarrier { |
1723 |
|
public CheckedBarrier(int parties) { super(parties); } |
1726 |
|
try { |
1727 |
|
return super.await(2 * LONG_DELAY_MS, MILLISECONDS); |
1728 |
|
} catch (TimeoutException timedOut) { |
1729 |
< |
throw new AssertionFailedError("timed out"); |
1729 |
> |
throw new AssertionError("timed out"); |
1730 |
|
} catch (Exception fail) { |
1731 |
< |
AssertionFailedError afe = |
1751 |
< |
new AssertionFailedError("Unexpected exception: " + fail); |
1752 |
< |
afe.initCause(fail); |
1753 |
< |
throw afe; |
1731 |
> |
throw new AssertionError("Unexpected exception: " + fail, fail); |
1732 |
|
} |
1733 |
|
} |
1734 |
|
} |
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() { |
1810 |
< |
((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(); |
1820 |
< |
if (o == clone) assertImmutable(o); |
1821 |
< |
assertSame(o.getClass(), clone.getClass()); |
1822 |
< |
return clone; |
1797 |
> |
clone = (T) ois.readObject(); |
1798 |
|
} catch (Throwable fail) { |
1799 |
|
threadUnexpectedException(fail); |
1825 |
– |
return null; |
1800 |
|
} |
1801 |
+ |
if (o == clone) assertImmutable(o); |
1802 |
+ |
else assertSame(o.getClass(), clone.getClass()); |
1803 |
+ |
return clone; |
1804 |
|
} |
1805 |
|
|
1806 |
|
/** |
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 |
|
|
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) { |
1852 |
|
threw = true; |
1853 |
< |
if (!expectedExceptionClass.isInstance(t)) { |
1854 |
< |
AssertionFailedError afe = |
1855 |
< |
new AssertionFailedError |
1856 |
< |
("Expected " + expectedExceptionClass.getName() + |
1857 |
< |
", got " + t.getClass().getName()); |
1881 |
< |
afe.initCause(t); |
1882 |
< |
threadUnexpectedException(afe); |
1883 |
< |
} |
1853 |
> |
if (!expectedExceptionClass.isInstance(t)) |
1854 |
> |
throw new AssertionError( |
1855 |
> |
"Expected " + expectedExceptionClass.getName() + |
1856 |
> |
", got " + t.getClass().getName(), |
1857 |
> |
t); |
1858 |
|
} |
1859 |
|
if (!threw) |
1860 |
|
shouldThrow(expectedExceptionClass.getName()); |
2070 |
|
assertEquals(savedCompletedTaskCount, p.getCompletedTaskCount()); |
2071 |
|
assertEquals(savedQueueSize, p.getQueue().size()); |
2072 |
|
} |
2073 |
+ |
|
2074 |
+ |
void assertCollectionsEquals(Collection<?> x, Collection<?> y) { |
2075 |
+ |
assertEquals(x, y); |
2076 |
+ |
assertEquals(y, x); |
2077 |
+ |
assertEquals(x.isEmpty(), y.isEmpty()); |
2078 |
+ |
assertEquals(x.size(), y.size()); |
2079 |
+ |
if (x instanceof List) { |
2080 |
+ |
assertEquals(x.toString(), y.toString()); |
2081 |
+ |
} |
2082 |
+ |
if (x instanceof List || x instanceof Set) { |
2083 |
+ |
assertEquals(x.hashCode(), y.hashCode()); |
2084 |
+ |
} |
2085 |
+ |
if (x instanceof List || x instanceof Deque) { |
2086 |
+ |
assertTrue(Arrays.equals(x.toArray(), y.toArray())); |
2087 |
+ |
assertTrue(Arrays.equals(x.toArray(new Object[0]), |
2088 |
+ |
y.toArray(new Object[0]))); |
2089 |
+ |
} |
2090 |
+ |
} |
2091 |
+ |
|
2092 |
+ |
/** |
2093 |
+ |
* A weaker form of assertCollectionsEquals which does not insist |
2094 |
+ |
* that the two collections satisfy Object#equals(Object), since |
2095 |
+ |
* they may use identity semantics as Deques do. |
2096 |
+ |
*/ |
2097 |
+ |
void assertCollectionsEquivalent(Collection<?> x, Collection<?> y) { |
2098 |
+ |
if (x instanceof List || x instanceof Set) |
2099 |
+ |
assertCollectionsEquals(x, y); |
2100 |
+ |
else { |
2101 |
+ |
assertEquals(x.isEmpty(), y.isEmpty()); |
2102 |
+ |
assertEquals(x.size(), y.size()); |
2103 |
+ |
assertEquals(new HashSet(x), new HashSet(y)); |
2104 |
+ |
if (x instanceof Deque) { |
2105 |
+ |
assertTrue(Arrays.equals(x.toArray(), y.toArray())); |
2106 |
+ |
assertTrue(Arrays.equals(x.toArray(new Object[0]), |
2107 |
+ |
y.toArray(new Object[0]))); |
2108 |
+ |
} |
2109 |
+ |
} |
2110 |
+ |
} |
2111 |
|
} |