ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/jsr166/jsr166/src/test/tck/JSR166TestCase.java
(Generate patch)

Comparing jsr166/src/test/tck/JSR166TestCase.java (file contents):
Revision 1.51 by jsr166, Wed Sep 1 06:41:55 2010 UTC vs.
Revision 1.85 by jsr166, Sun May 29 14:18:52 2011 UTC

# Line 1 | Line 1
1   /*
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/licenses/publicdomain
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.*;
10 > import java.io.ByteArrayInputStream;
11 > import java.io.ByteArrayOutputStream;
12 > import java.io.ObjectInputStream;
13 > import java.io.ObjectOutputStream;
14 > import java.util.Arrays;
15 > import java.util.Date;
16 > import java.util.NoSuchElementException;
17 > import java.util.PropertyPermission;
18   import java.util.concurrent.*;
19 + import java.util.concurrent.atomic.AtomicBoolean;
20 + import java.util.concurrent.atomic.AtomicReference;
21   import static java.util.concurrent.TimeUnit.MILLISECONDS;
22 < import java.io.*;
23 < import java.security.*;
22 > import static java.util.concurrent.TimeUnit.NANOSECONDS;
23 > import java.security.CodeSource;
24 > import java.security.Permission;
25 > import java.security.PermissionCollection;
26 > import java.security.Permissions;
27 > import java.security.Policy;
28 > import java.security.ProtectionDomain;
29 > import java.security.SecurityPermission;
30  
31   /**
32   * Base class for JSR166 Junit TCK tests.  Defines some constants,
# Line 90 | Line 105 | public class JSR166TestCase extends Test
105      private static final boolean useSecurityManager =
106          Boolean.getBoolean("jsr166.useSecurityManager");
107  
108 +    protected static final boolean expensiveTests =
109 +        Boolean.getBoolean("jsr166.expensiveTests");
110 +
111 +    /**
112 +     * If true, report on stdout all "slow" tests, that is, ones that
113 +     * take more than profileThreshold milliseconds to execute.
114 +     */
115 +    private static final boolean profileTests =
116 +        Boolean.getBoolean("jsr166.profileTests");
117 +
118 +    /**
119 +     * The number of milliseconds that tests are permitted for
120 +     * execution without being reported, when profileTests is set.
121 +     */
122 +    private static final long profileThreshold =
123 +        Long.getLong("jsr166.profileThreshold", 100);
124 +
125 +    protected void runTest() throws Throwable {
126 +        if (profileTests)
127 +            runTestProfiled();
128 +        else
129 +            super.runTest();
130 +    }
131 +
132 +    protected void runTestProfiled() throws Throwable {
133 +        long t0 = System.nanoTime();
134 +        try {
135 +            super.runTest();
136 +        } finally {
137 +            long elapsedMillis =
138 +                (System.nanoTime() - t0) / (1000L * 1000L);
139 +            if (elapsedMillis >= profileThreshold)
140 +                System.out.printf("%n%s: %d%n", toString(), elapsedMillis);
141 +        }
142 +    }
143 +
144      /**
145       * Runs all JSR166 unit tests using junit.textui.TestRunner
146       */
# Line 99 | Line 150 | public class JSR166TestCase extends Test
150              Policy.setPolicy(permissivePolicy());
151              System.setSecurityManager(new SecurityManager());
152          }
153 <        int iters = 1;
154 <        if (args.length > 0)
104 <            iters = Integer.parseInt(args[0]);
153 >        int iters = (args.length == 0) ? 1 : Integer.parseInt(args[0]);
154 >
155          Test s = suite();
156          for (int i = 0; i < iters; ++i) {
157              junit.textui.TestRunner.run(s);
# Line 111 | Line 161 | public class JSR166TestCase extends Test
161          System.exit(0);
162      }
163  
164 +    public static TestSuite newTestSuite(Object... suiteOrClasses) {
165 +        TestSuite suite = new TestSuite();
166 +        for (Object suiteOrClass : suiteOrClasses) {
167 +            if (suiteOrClass instanceof TestSuite)
168 +                suite.addTest((TestSuite) suiteOrClass);
169 +            else if (suiteOrClass instanceof Class)
170 +                suite.addTest(new TestSuite((Class<?>) suiteOrClass));
171 +            else
172 +                throw new ClassCastException("not a test suite or class");
173 +        }
174 +        return suite;
175 +    }
176 +
177      /**
178 <     * Collects all JSR166 unit tests as one suite
178 >     * Collects all JSR166 unit tests as one suite.
179       */
180      public static Test suite() {
181 <        TestSuite suite = new TestSuite("JSR166 Unit Tests");
182 <
183 <        suite.addTest(new TestSuite(ForkJoinPoolTest.class));
184 <        suite.addTest(new TestSuite(ForkJoinTaskTest.class));
185 <        suite.addTest(new TestSuite(RecursiveActionTest.class));
186 <        suite.addTest(new TestSuite(RecursiveTaskTest.class));
187 <        suite.addTest(new TestSuite(LinkedTransferQueueTest.class));
188 <        suite.addTest(new TestSuite(PhaserTest.class));
189 <        suite.addTest(new TestSuite(ThreadLocalRandomTest.class));
190 <        suite.addTest(new TestSuite(AbstractExecutorServiceTest.class));
191 <        suite.addTest(new TestSuite(AbstractQueueTest.class));
192 <        suite.addTest(new TestSuite(AbstractQueuedSynchronizerTest.class));
193 <        suite.addTest(new TestSuite(AbstractQueuedLongSynchronizerTest.class));
194 <        suite.addTest(new TestSuite(ArrayBlockingQueueTest.class));
195 <        suite.addTest(new TestSuite(ArrayDequeTest.class));
196 <        suite.addTest(new TestSuite(AtomicBooleanTest.class));
197 <        suite.addTest(new TestSuite(AtomicIntegerArrayTest.class));
198 <        suite.addTest(new TestSuite(AtomicIntegerFieldUpdaterTest.class));
199 <        suite.addTest(new TestSuite(AtomicIntegerTest.class));
200 <        suite.addTest(new TestSuite(AtomicLongArrayTest.class));
201 <        suite.addTest(new TestSuite(AtomicLongFieldUpdaterTest.class));
202 <        suite.addTest(new TestSuite(AtomicLongTest.class));
203 <        suite.addTest(new TestSuite(AtomicMarkableReferenceTest.class));
204 <        suite.addTest(new TestSuite(AtomicReferenceArrayTest.class));
205 <        suite.addTest(new TestSuite(AtomicReferenceFieldUpdaterTest.class));
206 <        suite.addTest(new TestSuite(AtomicReferenceTest.class));
207 <        suite.addTest(new TestSuite(AtomicStampedReferenceTest.class));
208 <        suite.addTest(new TestSuite(ConcurrentHashMapTest.class));
209 <        suite.addTest(new TestSuite(ConcurrentLinkedDequeTest.class));
210 <        suite.addTest(new TestSuite(ConcurrentLinkedQueueTest.class));
211 <        suite.addTest(new TestSuite(ConcurrentSkipListMapTest.class));
212 <        suite.addTest(new TestSuite(ConcurrentSkipListSubMapTest.class));
213 <        suite.addTest(new TestSuite(ConcurrentSkipListSetTest.class));
214 <        suite.addTest(new TestSuite(ConcurrentSkipListSubSetTest.class));
215 <        suite.addTest(new TestSuite(CopyOnWriteArrayListTest.class));
216 <        suite.addTest(new TestSuite(CopyOnWriteArraySetTest.class));
217 <        suite.addTest(new TestSuite(CountDownLatchTest.class));
218 <        suite.addTest(new TestSuite(CyclicBarrierTest.class));
219 <        suite.addTest(new TestSuite(DelayQueueTest.class));
220 <        suite.addTest(new TestSuite(EntryTest.class));
221 <        suite.addTest(new TestSuite(ExchangerTest.class));
222 <        suite.addTest(new TestSuite(ExecutorsTest.class));
223 <        suite.addTest(new TestSuite(ExecutorCompletionServiceTest.class));
224 <        suite.addTest(new TestSuite(FutureTaskTest.class));
225 <        suite.addTest(new TestSuite(LinkedBlockingDequeTest.class));
226 <        suite.addTest(new TestSuite(LinkedBlockingQueueTest.class));
227 <        suite.addTest(new TestSuite(LinkedListTest.class));
228 <        suite.addTest(new TestSuite(LockSupportTest.class));
229 <        suite.addTest(new TestSuite(PriorityBlockingQueueTest.class));
230 <        suite.addTest(new TestSuite(PriorityQueueTest.class));
231 <        suite.addTest(new TestSuite(ReentrantLockTest.class));
232 <        suite.addTest(new TestSuite(ReentrantReadWriteLockTest.class));
233 <        suite.addTest(new TestSuite(ScheduledExecutorTest.class));
234 <        suite.addTest(new TestSuite(ScheduledExecutorSubclassTest.class));
235 <        suite.addTest(new TestSuite(SemaphoreTest.class));
236 <        suite.addTest(new TestSuite(SynchronousQueueTest.class));
237 <        suite.addTest(new TestSuite(SystemTest.class));
238 <        suite.addTest(new TestSuite(ThreadLocalTest.class));
239 <        suite.addTest(new TestSuite(ThreadPoolExecutorTest.class));
240 <        suite.addTest(new TestSuite(ThreadPoolExecutorSubclassTest.class));
241 <        suite.addTest(new TestSuite(ThreadTest.class));
242 <        suite.addTest(new TestSuite(TimeUnitTest.class));
243 <        suite.addTest(new TestSuite(TreeMapTest.class));
244 <        suite.addTest(new TestSuite(TreeSetTest.class));
245 <        suite.addTest(new TestSuite(TreeSubMapTest.class));
183 <        suite.addTest(new TestSuite(TreeSubSetTest.class));
184 <
185 <        return suite;
181 >        return newTestSuite(
182 >            ForkJoinPoolTest.suite(),
183 >            ForkJoinTaskTest.suite(),
184 >            RecursiveActionTest.suite(),
185 >            RecursiveTaskTest.suite(),
186 >            LinkedTransferQueueTest.suite(),
187 >            PhaserTest.suite(),
188 >            ThreadLocalRandomTest.suite(),
189 >            AbstractExecutorServiceTest.suite(),
190 >            AbstractQueueTest.suite(),
191 >            AbstractQueuedSynchronizerTest.suite(),
192 >            AbstractQueuedLongSynchronizerTest.suite(),
193 >            ArrayBlockingQueueTest.suite(),
194 >            ArrayDequeTest.suite(),
195 >            AtomicBooleanTest.suite(),
196 >            AtomicIntegerArrayTest.suite(),
197 >            AtomicIntegerFieldUpdaterTest.suite(),
198 >            AtomicIntegerTest.suite(),
199 >            AtomicLongArrayTest.suite(),
200 >            AtomicLongFieldUpdaterTest.suite(),
201 >            AtomicLongTest.suite(),
202 >            AtomicMarkableReferenceTest.suite(),
203 >            AtomicReferenceArrayTest.suite(),
204 >            AtomicReferenceFieldUpdaterTest.suite(),
205 >            AtomicReferenceTest.suite(),
206 >            AtomicStampedReferenceTest.suite(),
207 >            ConcurrentHashMapTest.suite(),
208 >            ConcurrentLinkedDequeTest.suite(),
209 >            ConcurrentLinkedQueueTest.suite(),
210 >            ConcurrentSkipListMapTest.suite(),
211 >            ConcurrentSkipListSubMapTest.suite(),
212 >            ConcurrentSkipListSetTest.suite(),
213 >            ConcurrentSkipListSubSetTest.suite(),
214 >            CopyOnWriteArrayListTest.suite(),
215 >            CopyOnWriteArraySetTest.suite(),
216 >            CountDownLatchTest.suite(),
217 >            CyclicBarrierTest.suite(),
218 >            DelayQueueTest.suite(),
219 >            EntryTest.suite(),
220 >            ExchangerTest.suite(),
221 >            ExecutorsTest.suite(),
222 >            ExecutorCompletionServiceTest.suite(),
223 >            FutureTaskTest.suite(),
224 >            LinkedBlockingDequeTest.suite(),
225 >            LinkedBlockingQueueTest.suite(),
226 >            LinkedListTest.suite(),
227 >            LockSupportTest.suite(),
228 >            PriorityBlockingQueueTest.suite(),
229 >            PriorityQueueTest.suite(),
230 >            ReentrantLockTest.suite(),
231 >            ReentrantReadWriteLockTest.suite(),
232 >            ScheduledExecutorTest.suite(),
233 >            ScheduledExecutorSubclassTest.suite(),
234 >            SemaphoreTest.suite(),
235 >            SynchronousQueueTest.suite(),
236 >            SystemTest.suite(),
237 >            ThreadLocalTest.suite(),
238 >            ThreadPoolExecutorTest.suite(),
239 >            ThreadPoolExecutorSubclassTest.suite(),
240 >            ThreadTest.suite(),
241 >            TimeUnitTest.suite(),
242 >            TreeMapTest.suite(),
243 >            TreeSetTest.suite(),
244 >            TreeSubMapTest.suite(),
245 >            TreeSubSetTest.suite());
246      }
247  
248  
# Line 200 | Line 260 | public class JSR166TestCase extends Test
260          return 50;
261      }
262  
203
263      /**
264       * Sets delays as multiples of SHORT_DELAY.
265       */
266      protected void setDelays() {
267          SHORT_DELAY_MS = getShortDelay();
268 <        SMALL_DELAY_MS = SHORT_DELAY_MS * 5;
268 >        SMALL_DELAY_MS  = SHORT_DELAY_MS * 5;
269          MEDIUM_DELAY_MS = SHORT_DELAY_MS * 10;
270 <        LONG_DELAY_MS = SHORT_DELAY_MS * 50;
270 >        LONG_DELAY_MS   = SHORT_DELAY_MS * 200;
271 >    }
272 >
273 >    /**
274 >     * Returns a timeout in milliseconds to be used in tests that
275 >     * verify that operations block or time out.
276 >     */
277 >    long timeoutMillis() {
278 >        return SHORT_DELAY_MS / 4;
279      }
280  
281      /**
282 <     * Flag set true if any threadAssert methods fail
282 >     * Returns a new Date instance representing a time delayMillis
283 >     * milliseconds in the future.
284       */
285 <    volatile boolean threadFailed;
285 >    Date delayedDate(long delayMillis) {
286 >        return new Date(System.currentTimeMillis() + delayMillis);
287 >    }
288  
289      /**
290 <     * Initializes test to indicate that no thread assertions have failed
290 >     * The first exception encountered if any threadAssertXXX method fails.
291       */
292 +    private final AtomicReference<Throwable> threadFailure
293 +        = new AtomicReference<Throwable>(null);
294 +
295 +    /**
296 +     * Records an exception so that it can be rethrown later in the test
297 +     * harness thread, triggering a test case failure.  Only the first
298 +     * failure is recorded; subsequent calls to this method from within
299 +     * the same test have no effect.
300 +     */
301 +    public void threadRecordFailure(Throwable t) {
302 +        threadFailure.compareAndSet(null, t);
303 +    }
304 +
305      public void setUp() {
306          setDelays();
224        threadFailed = false;
307      }
308  
309      /**
310 <     * Triggers test case failure if any thread assertions have failed
311 <     */
312 <    public void tearDown() {
313 <        assertFalse(threadFailed);
310 >     * Extra checks that get done for all test cases.
311 >     *
312 >     * Triggers test case failure if any thread assertions have failed,
313 >     * by rethrowing, in the test harness thread, any exception recorded
314 >     * earlier by threadRecordFailure.
315 >     *
316 >     * Triggers test case failure if interrupt status is set in the main thread.
317 >     */
318 >    public void tearDown() throws Exception {
319 >        Throwable t = threadFailure.getAndSet(null);
320 >        if (t != null) {
321 >            if (t instanceof Error)
322 >                throw (Error) t;
323 >            else if (t instanceof RuntimeException)
324 >                throw (RuntimeException) t;
325 >            else if (t instanceof Exception)
326 >                throw (Exception) t;
327 >            else {
328 >                AssertionFailedError afe =
329 >                    new AssertionFailedError(t.toString());
330 >                afe.initCause(t);
331 >                throw afe;
332 >            }
333 >        }
334 >
335 >        if (Thread.interrupted())
336 >            throw new AssertionFailedError("interrupt status set in main thread");
337      }
338  
339      /**
340 <     * Fail, also setting status to indicate current testcase should fail
340 >     * Just like fail(reason), but additionally recording (using
341 >     * threadRecordFailure) any AssertionFailedError thrown, so that
342 >     * the current testcase will fail.
343       */
344      public void threadFail(String reason) {
345 <        threadFailed = true;
346 <        fail(reason);
345 >        try {
346 >            fail(reason);
347 >        } catch (AssertionFailedError t) {
348 >            threadRecordFailure(t);
349 >            fail(reason);
350 >        }
351      }
352  
353      /**
354 <     * If expression not true, set status to indicate current testcase
355 <     * should fail
354 >     * Just like assertTrue(b), but additionally recording (using
355 >     * threadRecordFailure) any AssertionFailedError thrown, so that
356 >     * the current testcase will fail.
357       */
358      public void threadAssertTrue(boolean b) {
359 <        if (!b) {
248 <            threadFailed = true;
359 >        try {
360              assertTrue(b);
361 +        } catch (AssertionFailedError t) {
362 +            threadRecordFailure(t);
363 +            throw t;
364          }
365      }
366  
367      /**
368 <     * If expression not false, set status to indicate current testcase
369 <     * should fail
368 >     * Just like assertFalse(b), but additionally recording (using
369 >     * threadRecordFailure) any AssertionFailedError thrown, so that
370 >     * the current testcase will fail.
371       */
372      public void threadAssertFalse(boolean b) {
373 <        if (b) {
259 <            threadFailed = true;
373 >        try {
374              assertFalse(b);
375 +        } catch (AssertionFailedError t) {
376 +            threadRecordFailure(t);
377 +            throw t;
378          }
379      }
380  
381      /**
382 <     * If argument not null, set status to indicate current testcase
383 <     * should fail
382 >     * Just like assertNull(x), but additionally recording (using
383 >     * threadRecordFailure) any AssertionFailedError thrown, so that
384 >     * the current testcase will fail.
385       */
386      public void threadAssertNull(Object x) {
387 <        if (x != null) {
270 <            threadFailed = true;
387 >        try {
388              assertNull(x);
389 +        } catch (AssertionFailedError t) {
390 +            threadRecordFailure(t);
391 +            throw t;
392          }
393      }
394  
395      /**
396 <     * If arguments not equal, set status to indicate current testcase
397 <     * should fail
396 >     * Just like assertEquals(x, y), but additionally recording (using
397 >     * threadRecordFailure) any AssertionFailedError thrown, so that
398 >     * the current testcase will fail.
399       */
400      public void threadAssertEquals(long x, long y) {
401 <        if (x != y) {
281 <            threadFailed = true;
401 >        try {
402              assertEquals(x, y);
403 +        } catch (AssertionFailedError t) {
404 +            threadRecordFailure(t);
405 +            throw t;
406          }
407      }
408  
409      /**
410 <     * If arguments not equal, set status to indicate current testcase
411 <     * should fail
410 >     * Just like assertEquals(x, y), but additionally recording (using
411 >     * threadRecordFailure) any AssertionFailedError thrown, so that
412 >     * the current testcase will fail.
413       */
414      public void threadAssertEquals(Object x, Object y) {
415 <        if (x != y && (x == null || !x.equals(y))) {
292 <            threadFailed = true;
415 >        try {
416              assertEquals(x, y);
417 +        } catch (AssertionFailedError t) {
418 +            threadRecordFailure(t);
419 +            throw t;
420 +        } catch (Throwable t) {
421 +            threadUnexpectedException(t);
422          }
423      }
424  
425      /**
426 <     * threadFail with message "should throw exception"
426 >     * Just like assertSame(x, y), but additionally recording (using
427 >     * threadRecordFailure) any AssertionFailedError thrown, so that
428 >     * the current testcase will fail.
429 >     */
430 >    public void threadAssertSame(Object x, Object y) {
431 >        try {
432 >            assertSame(x, y);
433 >        } catch (AssertionFailedError t) {
434 >            threadRecordFailure(t);
435 >            throw t;
436 >        }
437 >    }
438 >
439 >    /**
440 >     * Calls threadFail with message "should throw exception".
441       */
442      public void threadShouldThrow() {
443 <        threadFailed = true;
302 <        fail("should throw exception");
443 >        threadFail("should throw exception");
444      }
445  
446      /**
447 <     * threadFail with message "should throw" + exceptionName
447 >     * Calls threadFail with message "should throw" + exceptionName.
448       */
449      public void threadShouldThrow(String exceptionName) {
450 <        threadFailed = true;
310 <        fail("should throw " + exceptionName);
450 >        threadFail("should throw " + exceptionName);
451      }
452  
453      /**
454 <     * threadFail with message "Unexpected exception"
454 >     * Records the given exception using {@link #threadRecordFailure},
455 >     * then rethrows the exception, wrapping it in an
456 >     * AssertionFailedError if necessary.
457       */
458 <    public void threadUnexpectedException() {
459 <        threadFailed = true;
460 <        fail("Unexpected exception");
458 >    public void threadUnexpectedException(Throwable t) {
459 >        threadRecordFailure(t);
460 >        t.printStackTrace();
461 >        if (t instanceof RuntimeException)
462 >            throw (RuntimeException) t;
463 >        else if (t instanceof Error)
464 >            throw (Error) t;
465 >        else {
466 >            AssertionFailedError afe =
467 >                new AssertionFailedError("unexpected exception: " + t);
468 >            afe.initCause(t);
469 >            throw afe;
470 >        }
471      }
472  
473      /**
474 <     * threadFail with message "Unexpected exception", with argument
474 >     * Delays, via Thread.sleep, for the given millisecond delay, but
475 >     * if the sleep is shorter than specified, may re-sleep or yield
476 >     * until time elapses.
477       */
478 <    public void threadUnexpectedException(Throwable ex) {
479 <        threadFailed = true;
480 <        ex.printStackTrace();
481 <        fail("Unexpected exception: " + ex);
478 >    static void delay(long millis) throws InterruptedException {
479 >        long startTime = System.nanoTime();
480 >        long ns = millis * 1000 * 1000;
481 >        for (;;) {
482 >            if (millis > 0L)
483 >                Thread.sleep(millis);
484 >            else // too short to sleep
485 >                Thread.yield();
486 >            long d = ns - (System.nanoTime() - startTime);
487 >            if (d > 0L)
488 >                millis = d / (1000 * 1000);
489 >            else
490 >                break;
491 >        }
492      }
493  
494      /**
495 <     * Wait out termination of a thread pool or fail doing so
495 >     * Waits out termination of a thread pool or fails doing so.
496       */
497 <    public void joinPool(ExecutorService exec) {
497 >    void joinPool(ExecutorService exec) {
498          try {
499              exec.shutdown();
500 <            assertTrue(exec.awaitTermination(LONG_DELAY_MS, MILLISECONDS));
500 >            assertTrue("ExecutorService did not terminate in a timely manner",
501 >                       exec.awaitTermination(2 * LONG_DELAY_MS, MILLISECONDS));
502          } catch (SecurityException ok) {
503              // Allowed in case test doesn't have privs
504          } catch (InterruptedException ie) {
# Line 341 | Line 506 | public class JSR166TestCase extends Test
506          }
507      }
508  
509 +    /**
510 +     * Checks that thread does not terminate within the default
511 +     * millisecond delay of {@code timeoutMillis()}.
512 +     */
513 +    void assertThreadStaysAlive(Thread thread) {
514 +        assertThreadStaysAlive(thread, timeoutMillis());
515 +    }
516  
517      /**
518 <     * fail with message "should throw exception"
518 >     * Checks that thread does not terminate within the given millisecond delay.
519       */
520 <    public void shouldThrow() {
521 <        fail("Should throw exception");
520 >    void assertThreadStaysAlive(Thread thread, long millis) {
521 >        try {
522 >            // No need to optimize the failing case via Thread.join.
523 >            delay(millis);
524 >            assertTrue(thread.isAlive());
525 >        } catch (InterruptedException ie) {
526 >            fail("Unexpected InterruptedException");
527 >        }
528      }
529  
530      /**
531 <     * fail with message "should throw " + exceptionName
531 >     * Checks that future.get times out, with the default timeout of
532 >     * {@code timeoutMillis()}.
533       */
534 <    public void shouldThrow(String exceptionName) {
535 <        fail("Should throw " + exceptionName);
534 >    void assertFutureTimesOut(Future future) {
535 >        assertFutureTimesOut(future, timeoutMillis());
536      }
537  
538      /**
539 <     * fail with message "Unexpected exception"
539 >     * Checks that future.get times out, with the given millisecond timeout.
540       */
541 <    public void unexpectedException() {
542 <        fail("Unexpected exception");
541 >    void assertFutureTimesOut(Future future, long timeoutMillis) {
542 >        long startTime = System.nanoTime();
543 >        try {
544 >            future.get(timeoutMillis, MILLISECONDS);
545 >            shouldThrow();
546 >        } catch (TimeoutException success) {
547 >        } catch (Exception e) {
548 >            threadUnexpectedException(e);
549 >        } finally { future.cancel(true); }
550 >        assertTrue(millisElapsedSince(startTime) >= timeoutMillis);
551      }
552  
553      /**
554 <     * fail with message "Unexpected exception", with argument
554 >     * Fails with message "should throw exception".
555       */
556 <    public void unexpectedException(Throwable ex) {
557 <        ex.printStackTrace();
371 <        fail("Unexpected exception: " + ex);
556 >    public void shouldThrow() {
557 >        fail("Should throw exception");
558      }
559  
560 +    /**
561 +     * Fails with message "should throw " + exceptionName.
562 +     */
563 +    public void shouldThrow(String exceptionName) {
564 +        fail("Should throw " + exceptionName);
565 +    }
566  
567      /**
568       * The number of elements to place in collections, arrays, etc.
# Line 483 | Line 675 | public class JSR166TestCase extends Test
675      }
676  
677      /**
678 <     * Sleep until the timeout has elapsed, or interrupted.
679 <     * Does <em>NOT</em> throw InterruptedException.
678 >     * Sleeps until the given time has elapsed.
679 >     * Throws AssertionFailedError if interrupted.
680       */
681 <    void sleepTillInterrupted(long timeoutMillis) {
681 >    void sleep(long millis) {
682          try {
683 <            Thread.sleep(timeoutMillis);
684 <        } catch (InterruptedException wakeup) {}
683 >            delay(millis);
684 >        } catch (InterruptedException ie) {
685 >            AssertionFailedError afe =
686 >                new AssertionFailedError("Unexpected InterruptedException");
687 >            afe.initCause(ie);
688 >            throw afe;
689 >        }
690 >    }
691 >
692 >    /**
693 >     * Waits up to the specified number of milliseconds for the given
694 >     * thread to enter a wait state: BLOCKED, WAITING, or TIMED_WAITING.
695 >     */
696 >    void waitForThreadToEnterWaitState(Thread thread, long timeoutMillis) {
697 >        long timeoutNanos = timeoutMillis * 1000L * 1000L;
698 >        long t0 = System.nanoTime();
699 >        for (;;) {
700 >            Thread.State s = thread.getState();
701 >            if (s == Thread.State.BLOCKED ||
702 >                s == Thread.State.WAITING ||
703 >                s == Thread.State.TIMED_WAITING)
704 >                return;
705 >            else if (s == Thread.State.TERMINATED)
706 >                fail("Unexpected thread termination");
707 >            else if (System.nanoTime() - t0 > timeoutNanos) {
708 >                threadAssertTrue(thread.isAlive());
709 >                return;
710 >            }
711 >            Thread.yield();
712 >        }
713 >    }
714 >
715 >    /**
716 >     * Waits up to LONG_DELAY_MS for the given thread to enter a wait
717 >     * state: BLOCKED, WAITING, or TIMED_WAITING.
718 >     */
719 >    void waitForThreadToEnterWaitState(Thread thread) {
720 >        waitForThreadToEnterWaitState(thread, LONG_DELAY_MS);
721      }
722  
723      /**
724 <     * Returns a new started Thread running the given runnable.
724 >     * Returns the number of milliseconds since time given by
725 >     * startNanoTime, which must have been previously returned from a
726 >     * call to {@link System.nanoTime()}.
727 >     */
728 >    long millisElapsedSince(long startNanoTime) {
729 >        return NANOSECONDS.toMillis(System.nanoTime() - startNanoTime);
730 >    }
731 >
732 >    /**
733 >     * Returns a new started daemon Thread running the given runnable.
734       */
735      Thread newStartedThread(Runnable runnable) {
736          Thread t = new Thread(runnable);
737 +        t.setDaemon(true);
738          t.start();
739          return t;
740      }
741  
742 +    /**
743 +     * Waits for the specified time (in milliseconds) for the thread
744 +     * to terminate (using {@link Thread#join(long)}), else interrupts
745 +     * the thread (in the hope that it may terminate later) and fails.
746 +     */
747 +    void awaitTermination(Thread t, long timeoutMillis) {
748 +        try {
749 +            t.join(timeoutMillis);
750 +        } catch (InterruptedException ie) {
751 +            threadUnexpectedException(ie);
752 +        } finally {
753 +            if (t.getState() != Thread.State.TERMINATED) {
754 +                t.interrupt();
755 +                fail("Test timed out");
756 +            }
757 +        }
758 +    }
759 +
760 +    /**
761 +     * Waits for LONG_DELAY_MS milliseconds for the thread to
762 +     * terminate (using {@link Thread#join(long)}), else interrupts
763 +     * the thread (in the hope that it may terminate later) and fails.
764 +     */
765 +    void awaitTermination(Thread t) {
766 +        awaitTermination(t, LONG_DELAY_MS);
767 +    }
768 +
769      // Some convenient Runnable classes
770  
771      public abstract class CheckedRunnable implements Runnable {
# Line 563 | Line 828 | public class JSR166TestCase extends Test
828                  realRun();
829                  threadShouldThrow("InterruptedException");
830              } catch (InterruptedException success) {
831 +                threadAssertFalse(Thread.interrupted());
832              } catch (Throwable t) {
833                  threadUnexpectedException(t);
834              }
# Line 577 | Line 843 | public class JSR166TestCase extends Test
843                  return realCall();
844              } catch (Throwable t) {
845                  threadUnexpectedException(t);
846 +                return null;
847              }
581            return null;
848          }
849      }
850  
851 <    public abstract class CheckedInterruptedCallable<T> implements Callable<T> {
851 >    public abstract class CheckedInterruptedCallable<T>
852 >        implements Callable<T> {
853          protected abstract T realCall() throws Throwable;
854  
855          public final T call() {
# Line 591 | Line 858 | public class JSR166TestCase extends Test
858                  threadShouldThrow("InterruptedException");
859                  return result;
860              } catch (InterruptedException success) {
861 +                threadAssertFalse(Thread.interrupted());
862              } catch (Throwable t) {
863                  threadUnexpectedException(t);
864              }
# Line 614 | Line 882 | public class JSR166TestCase extends Test
882  
883      public Callable<String> latchAwaitingStringTask(final CountDownLatch latch) {
884          return new CheckedCallable<String>() {
885 <            public String realCall() {
885 >            protected String realCall() {
886                  try {
887                      latch.await();
888                  } catch (InterruptedException quittingTime) {}
# Line 622 | Line 890 | public class JSR166TestCase extends Test
890              }};
891      }
892  
893 +    public Runnable awaiter(final CountDownLatch latch) {
894 +        return new CheckedRunnable() {
895 +            public void realRun() throws InterruptedException {
896 +                await(latch);
897 +            }};
898 +    }
899 +
900 +    public void await(CountDownLatch latch) {
901 +        try {
902 +            assertTrue(latch.await(LONG_DELAY_MS, MILLISECONDS));
903 +        } catch (Throwable t) {
904 +            threadUnexpectedException(t);
905 +        }
906 +    }
907 +
908 + //     /**
909 + //      * Spin-waits up to LONG_DELAY_MS until flag becomes true.
910 + //      */
911 + //     public void await(AtomicBoolean flag) {
912 + //         await(flag, LONG_DELAY_MS);
913 + //     }
914 +
915 + //     /**
916 + //      * Spin-waits up to the specified timeout until flag becomes true.
917 + //      */
918 + //     public void await(AtomicBoolean flag, long timeoutMillis) {
919 + //         long startTime = System.nanoTime();
920 + //         while (!flag.get()) {
921 + //             if (millisElapsedSince(startTime) > timeoutMillis)
922 + //                 throw new AssertionFailedError("timed out");
923 + //             Thread.yield();
924 + //         }
925 + //     }
926 +
927      public static class NPETask implements Callable<String> {
928          public String call() { throw new NullPointerException(); }
929      }
# Line 632 | Line 934 | public class JSR166TestCase extends Test
934  
935      public class ShortRunnable extends CheckedRunnable {
936          protected void realRun() throws Throwable {
937 <            Thread.sleep(SHORT_DELAY_MS);
937 >            delay(SHORT_DELAY_MS);
938          }
939      }
940  
941      public class ShortInterruptedRunnable extends CheckedInterruptedRunnable {
942          protected void realRun() throws InterruptedException {
943 <            Thread.sleep(SHORT_DELAY_MS);
943 >            delay(SHORT_DELAY_MS);
944          }
945      }
946  
947      public class SmallRunnable extends CheckedRunnable {
948          protected void realRun() throws Throwable {
949 <            Thread.sleep(SMALL_DELAY_MS);
949 >            delay(SMALL_DELAY_MS);
950          }
951      }
952  
953      public class SmallPossiblyInterruptedRunnable extends CheckedRunnable {
954          protected void realRun() {
955              try {
956 <                Thread.sleep(SMALL_DELAY_MS);
956 >                delay(SMALL_DELAY_MS);
957              } catch (InterruptedException ok) {}
958          }
959      }
960  
961      public class SmallCallable extends CheckedCallable {
962          protected Object realCall() throws InterruptedException {
963 <            Thread.sleep(SMALL_DELAY_MS);
963 >            delay(SMALL_DELAY_MS);
964              return Boolean.TRUE;
965          }
966      }
967  
666    public class SmallInterruptedRunnable extends CheckedInterruptedRunnable {
667        protected void realRun() throws InterruptedException {
668            Thread.sleep(SMALL_DELAY_MS);
669        }
670    }
671
968      public class MediumRunnable extends CheckedRunnable {
969          protected void realRun() throws Throwable {
970 <            Thread.sleep(MEDIUM_DELAY_MS);
970 >            delay(MEDIUM_DELAY_MS);
971          }
972      }
973  
974      public class MediumInterruptedRunnable extends CheckedInterruptedRunnable {
975          protected void realRun() throws InterruptedException {
976 <            Thread.sleep(MEDIUM_DELAY_MS);
976 >            delay(MEDIUM_DELAY_MS);
977          }
978      }
979  
980 +    public Runnable possiblyInterruptedRunnable(final long timeoutMillis) {
981 +        return new CheckedRunnable() {
982 +            protected void realRun() {
983 +                try {
984 +                    delay(timeoutMillis);
985 +                } catch (InterruptedException ok) {}
986 +            }};
987 +    }
988 +
989      public class MediumPossiblyInterruptedRunnable extends CheckedRunnable {
990          protected void realRun() {
991              try {
992 <                Thread.sleep(MEDIUM_DELAY_MS);
992 >                delay(MEDIUM_DELAY_MS);
993              } catch (InterruptedException ok) {}
994          }
995      }
# Line 692 | Line 997 | public class JSR166TestCase extends Test
997      public class LongPossiblyInterruptedRunnable extends CheckedRunnable {
998          protected void realRun() {
999              try {
1000 <                Thread.sleep(LONG_DELAY_MS);
1000 >                delay(LONG_DELAY_MS);
1001              } catch (InterruptedException ok) {}
1002          }
1003      }
# Line 706 | Line 1011 | public class JSR166TestCase extends Test
1011          }
1012      }
1013  
1014 +    public interface TrackedRunnable extends Runnable {
1015 +        boolean isDone();
1016 +    }
1017 +
1018 +    public static TrackedRunnable trackedRunnable(final long timeoutMillis) {
1019 +        return new TrackedRunnable() {
1020 +                private volatile boolean done = false;
1021 +                public boolean isDone() { return done; }
1022 +                public void run() {
1023 +                    try {
1024 +                        delay(timeoutMillis);
1025 +                        done = true;
1026 +                    } catch (InterruptedException ok) {}
1027 +                }
1028 +            };
1029 +    }
1030 +
1031      public static class TrackedShortRunnable implements Runnable {
1032          public volatile boolean done = false;
1033          public void run() {
1034              try {
1035 <                Thread.sleep(SMALL_DELAY_MS);
1035 >                delay(SHORT_DELAY_MS);
1036 >                done = true;
1037 >            } catch (InterruptedException ok) {}
1038 >        }
1039 >    }
1040 >
1041 >    public static class TrackedSmallRunnable implements Runnable {
1042 >        public volatile boolean done = false;
1043 >        public void run() {
1044 >            try {
1045 >                delay(SMALL_DELAY_MS);
1046                  done = true;
1047              } catch (InterruptedException ok) {}
1048          }
# Line 720 | Line 1052 | public class JSR166TestCase extends Test
1052          public volatile boolean done = false;
1053          public void run() {
1054              try {
1055 <                Thread.sleep(MEDIUM_DELAY_MS);
1055 >                delay(MEDIUM_DELAY_MS);
1056                  done = true;
1057              } catch (InterruptedException ok) {}
1058          }
# Line 730 | Line 1062 | public class JSR166TestCase extends Test
1062          public volatile boolean done = false;
1063          public void run() {
1064              try {
1065 <                Thread.sleep(LONG_DELAY_MS);
1065 >                delay(LONG_DELAY_MS);
1066                  done = true;
1067              } catch (InterruptedException ok) {}
1068          }
# Line 747 | Line 1079 | public class JSR166TestCase extends Test
1079          public volatile boolean done = false;
1080          public Object call() {
1081              try {
1082 <                Thread.sleep(SMALL_DELAY_MS);
1082 >                delay(SMALL_DELAY_MS);
1083                  done = true;
1084              } catch (InterruptedException ok) {}
1085              return Boolean.TRUE;
1086          }
1087      }
1088  
1089 +    /**
1090 +     * Analog of CheckedRunnable for RecursiveAction
1091 +     */
1092 +    public abstract class CheckedRecursiveAction extends RecursiveAction {
1093 +        protected abstract void realCompute() throws Throwable;
1094 +
1095 +        public final void compute() {
1096 +            try {
1097 +                realCompute();
1098 +            } catch (Throwable t) {
1099 +                threadUnexpectedException(t);
1100 +            }
1101 +        }
1102 +    }
1103 +
1104 +    /**
1105 +     * Analog of CheckedCallable for RecursiveTask
1106 +     */
1107 +    public abstract class CheckedRecursiveTask<T> extends RecursiveTask<T> {
1108 +        protected abstract T realCompute() throws Throwable;
1109 +
1110 +        public final T compute() {
1111 +            try {
1112 +                return realCompute();
1113 +            } catch (Throwable t) {
1114 +                threadUnexpectedException(t);
1115 +                return null;
1116 +            }
1117 +        }
1118 +    }
1119  
1120      /**
1121       * For use as RejectedExecutionHandler in constructors
# Line 763 | Line 1125 | public class JSR166TestCase extends Test
1125                                        ThreadPoolExecutor executor) {}
1126      }
1127  
1128 +    /**
1129 +     * A CyclicBarrier that fails with AssertionFailedErrors instead
1130 +     * of throwing checked exceptions.
1131 +     */
1132 +    public class CheckedBarrier extends CyclicBarrier {
1133 +        public CheckedBarrier(int parties) { super(parties); }
1134 +
1135 +        public int await() {
1136 +            try {
1137 +                return super.await();
1138 +            } catch (Exception e) {
1139 +                AssertionFailedError afe =
1140 +                    new AssertionFailedError("Unexpected exception: " + e);
1141 +                afe.initCause(e);
1142 +                throw afe;
1143 +            }
1144 +        }
1145 +    }
1146 +
1147 +    void checkEmpty(BlockingQueue q) {
1148 +        try {
1149 +            assertTrue(q.isEmpty());
1150 +            assertEquals(0, q.size());
1151 +            assertNull(q.peek());
1152 +            assertNull(q.poll());
1153 +            assertNull(q.poll(0, MILLISECONDS));
1154 +            assertEquals(q.toString(), "[]");
1155 +            assertTrue(Arrays.equals(q.toArray(), new Object[0]));
1156 +            assertFalse(q.iterator().hasNext());
1157 +            try {
1158 +                q.element();
1159 +                shouldThrow();
1160 +            } catch (NoSuchElementException success) {}
1161 +            try {
1162 +                q.iterator().next();
1163 +                shouldThrow();
1164 +            } catch (NoSuchElementException success) {}
1165 +            try {
1166 +                q.remove();
1167 +                shouldThrow();
1168 +            } catch (NoSuchElementException success) {}
1169 +        } catch (InterruptedException ie) {
1170 +            threadUnexpectedException(ie);
1171 +        }
1172 +    }
1173 +
1174 +    @SuppressWarnings("unchecked")
1175 +    <T> T serialClone(T o) {
1176 +        try {
1177 +            ByteArrayOutputStream bos = new ByteArrayOutputStream();
1178 +            ObjectOutputStream oos = new ObjectOutputStream(bos);
1179 +            oos.writeObject(o);
1180 +            oos.flush();
1181 +            oos.close();
1182 +            ByteArrayInputStream bin =
1183 +                new ByteArrayInputStream(bos.toByteArray());
1184 +            ObjectInputStream ois = new ObjectInputStream(bin);
1185 +            return (T) ois.readObject();
1186 +        } catch (Throwable t) {
1187 +            threadUnexpectedException(t);
1188 +            return null;
1189 +        }
1190 +    }
1191   }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines