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.38 by jsr166, Wed Aug 5 00:43:59 2009 UTC vs.
Revision 1.59 by jsr166, Wed Oct 6 02:58:04 2010 UTC

# Line 7 | Line 7
7   */
8  
9   import junit.framework.*;
10 < import java.util.*;
10 > import java.util.PropertyPermission;
11   import java.util.concurrent.*;
12 + import java.util.concurrent.atomic.AtomicReference;
13   import static java.util.concurrent.TimeUnit.MILLISECONDS;
14 < import java.io.*;
15 < import java.security.*;
14 > import java.security.CodeSource;
15 > import java.security.Permission;
16 > import java.security.PermissionCollection;
17 > import java.security.Permissions;
18 > import java.security.Policy;
19 > import java.security.ProtectionDomain;
20 > import java.security.SecurityPermission;
21  
22   /**
23   * Base class for JSR166 Junit TCK tests.  Defines some constants,
# Line 26 | Line 32 | import java.security.*;
32   * <li> All assertions in code running in generated threads must use
33   * the forms {@link #threadFail}, {@link #threadAssertTrue}, {@link
34   * #threadAssertEquals}, or {@link #threadAssertNull}, (not
35 < * <tt>fail</tt>, <tt>assertTrue</tt>, etc.) It is OK (but not
35 > * {@code fail}, {@code assertTrue}, etc.) It is OK (but not
36   * particularly recommended) for other code to use these forms too.
37   * Only the most typically used JUnit assertion methods are defined
38   * this way, but enough to live with.</li>
39   *
40   * <li> If you override {@link #setUp} or {@link #tearDown}, make sure
41 < * to invoke <tt>super.setUp</tt> and <tt>super.tearDown</tt> within
41 > * to invoke {@code super.setUp} and {@code super.tearDown} within
42   * them. These methods are used to clear and check for thread
43   * assertion failures.</li>
44   *
45 < * <li>All delays and timeouts must use one of the constants <tt>
46 < * SHORT_DELAY_MS</tt>, <tt> SMALL_DELAY_MS</tt>, <tt> MEDIUM_DELAY_MS</tt>,
47 < * <tt> LONG_DELAY_MS</tt>. The idea here is that a SHORT is always
45 > * <li>All delays and timeouts must use one of the constants {@code
46 > * SHORT_DELAY_MS}, {@code SMALL_DELAY_MS}, {@code MEDIUM_DELAY_MS},
47 > * {@code LONG_DELAY_MS}. The idea here is that a SHORT is always
48   * discriminable from zero time, and always allows enough time for the
49   * small amounts of computation (creating a thread, calling a few
50   * methods, etc) needed to reach a timeout point. Similarly, a SMALL
# Line 48 | Line 54 | import java.security.*;
54   * in one spot to rerun tests on slower platforms.</li>
55   *
56   * <li> All threads generated must be joined inside each test case
57 < * method (or <tt>fail</tt> to do so) before returning from the
58 < * method. The <tt> joinPool</tt> method can be used to do this when
57 > * method (or {@code fail} to do so) before returning from the
58 > * method. The {@code joinPool} method can be used to do this when
59   * using Executors.</li>
60   *
61   * </ol>
# Line 81 | Line 87 | import java.security.*;
87   * any particular package to simplify things for people integrating
88   * them in TCK test suites.</li>
89   *
90 < * <li> As a convenience, the <tt>main</tt> of this class (JSR166TestCase)
90 > * <li> As a convenience, the {@code main} of this class (JSR166TestCase)
91   * runs all JSR166 unit tests.</li>
92   *
93   * </ul>
94   */
95   public class JSR166TestCase extends TestCase {
96 +    private static final boolean useSecurityManager =
97 +        Boolean.getBoolean("jsr166.useSecurityManager");
98 +
99      /**
100       * Runs all JSR166 unit tests using junit.textui.TestRunner
101       */
102 <    public static void main (String[] args) {
103 <        int iters = 1;
104 <        if (args.length > 0)
105 <            iters = Integer.parseInt(args[0]);
102 >    public static void main(String[] args) {
103 >        if (useSecurityManager) {
104 >            System.err.println("Setting a permissive security manager");
105 >            Policy.setPolicy(permissivePolicy());
106 >            System.setSecurityManager(new SecurityManager());
107 >        }
108 >        int iters = (args.length == 0) ? 1 : Integer.parseInt(args[0]);
109 >
110          Test s = suite();
111          for (int i = 0; i < iters; ++i) {
112 <            junit.textui.TestRunner.run (s);
112 >            junit.textui.TestRunner.run(s);
113              System.gc();
114              System.runFinalization();
115          }
# Line 106 | Line 119 | public class JSR166TestCase extends Test
119      /**
120       * Collects all JSR166 unit tests as one suite
121       */
122 <    public static Test suite ( ) {
122 >    public static Test suite() {
123          TestSuite suite = new TestSuite("JSR166 Unit Tests");
124  
125 <        suite.addTest(new TestSuite(ForkJoinPoolTest.class));
126 <        suite.addTest(new TestSuite(ForkJoinTaskTest.class));
127 <        suite.addTest(new TestSuite(RecursiveActionTest.class));
128 <        suite.addTest(new TestSuite(RecursiveTaskTest.class));
129 <        suite.addTest(new TestSuite(LinkedTransferQueueTest.class));
130 <        suite.addTest(new TestSuite(PhaserTest.class));
131 <        suite.addTest(new TestSuite(ThreadLocalRandomTest.class));
132 <        suite.addTest(new TestSuite(AbstractExecutorServiceTest.class));
133 <        suite.addTest(new TestSuite(AbstractQueueTest.class));
134 <        suite.addTest(new TestSuite(AbstractQueuedSynchronizerTest.class));
135 <        suite.addTest(new TestSuite(AbstractQueuedLongSynchronizerTest.class));
136 <        suite.addTest(new TestSuite(ArrayBlockingQueueTest.class));
137 <        suite.addTest(new TestSuite(ArrayDequeTest.class));
138 <        suite.addTest(new TestSuite(AtomicBooleanTest.class));
139 <        suite.addTest(new TestSuite(AtomicIntegerArrayTest.class));
140 <        suite.addTest(new TestSuite(AtomicIntegerFieldUpdaterTest.class));
141 <        suite.addTest(new TestSuite(AtomicIntegerTest.class));
142 <        suite.addTest(new TestSuite(AtomicLongArrayTest.class));
143 <        suite.addTest(new TestSuite(AtomicLongFieldUpdaterTest.class));
144 <        suite.addTest(new TestSuite(AtomicLongTest.class));
145 <        suite.addTest(new TestSuite(AtomicMarkableReferenceTest.class));
146 <        suite.addTest(new TestSuite(AtomicReferenceArrayTest.class));
147 <        suite.addTest(new TestSuite(AtomicReferenceFieldUpdaterTest.class));
148 <        suite.addTest(new TestSuite(AtomicReferenceTest.class));
149 <        suite.addTest(new TestSuite(AtomicStampedReferenceTest.class));
150 <        suite.addTest(new TestSuite(ConcurrentHashMapTest.class));
151 <        suite.addTest(new TestSuite(ConcurrentLinkedQueueTest.class));
152 <        suite.addTest(new TestSuite(ConcurrentSkipListMapTest.class));
153 <        suite.addTest(new TestSuite(ConcurrentSkipListSubMapTest.class));
154 <        suite.addTest(new TestSuite(ConcurrentSkipListSetTest.class));
155 <        suite.addTest(new TestSuite(ConcurrentSkipListSubSetTest.class));
156 <        suite.addTest(new TestSuite(CopyOnWriteArrayListTest.class));
157 <        suite.addTest(new TestSuite(CopyOnWriteArraySetTest.class));
158 <        suite.addTest(new TestSuite(CountDownLatchTest.class));
159 <        suite.addTest(new TestSuite(CyclicBarrierTest.class));
160 <        suite.addTest(new TestSuite(DelayQueueTest.class));
161 <        suite.addTest(new TestSuite(EntryTest.class));
162 <        suite.addTest(new TestSuite(ExchangerTest.class));
163 <        suite.addTest(new TestSuite(ExecutorsTest.class));
164 <        suite.addTest(new TestSuite(ExecutorCompletionServiceTest.class));
165 <        suite.addTest(new TestSuite(FutureTaskTest.class));
166 <        suite.addTest(new TestSuite(LinkedBlockingDequeTest.class));
167 <        suite.addTest(new TestSuite(LinkedBlockingQueueTest.class));
168 <        suite.addTest(new TestSuite(LinkedListTest.class));
169 <        suite.addTest(new TestSuite(LockSupportTest.class));
170 <        suite.addTest(new TestSuite(PriorityBlockingQueueTest.class));
171 <        suite.addTest(new TestSuite(PriorityQueueTest.class));
172 <        suite.addTest(new TestSuite(ReentrantLockTest.class));
173 <        suite.addTest(new TestSuite(ReentrantReadWriteLockTest.class));
174 <        suite.addTest(new TestSuite(ScheduledExecutorTest.class));
175 <        suite.addTest(new TestSuite(ScheduledExecutorSubclassTest.class));
176 <        suite.addTest(new TestSuite(SemaphoreTest.class));
177 <        suite.addTest(new TestSuite(SynchronousQueueTest.class));
178 <        suite.addTest(new TestSuite(SystemTest.class));
179 <        suite.addTest(new TestSuite(ThreadLocalTest.class));
180 <        suite.addTest(new TestSuite(ThreadPoolExecutorTest.class));
181 <        suite.addTest(new TestSuite(ThreadPoolExecutorSubclassTest.class));
182 <        suite.addTest(new TestSuite(ThreadTest.class));
183 <        suite.addTest(new TestSuite(TimeUnitTest.class));
184 <        suite.addTest(new TestSuite(TreeMapTest.class));
185 <        suite.addTest(new TestSuite(TreeSetTest.class));
186 <        suite.addTest(new TestSuite(TreeSubMapTest.class));
187 <        suite.addTest(new TestSuite(TreeSubSetTest.class));
125 >        suite.addTest(ForkJoinPoolTest.suite());
126 >        suite.addTest(ForkJoinTaskTest.suite());
127 >        suite.addTest(RecursiveActionTest.suite());
128 >        suite.addTest(RecursiveTaskTest.suite());
129 >        suite.addTest(LinkedTransferQueueTest.suite());
130 >        suite.addTest(PhaserTest.suite());
131 >        suite.addTest(ThreadLocalRandomTest.suite());
132 >        suite.addTest(AbstractExecutorServiceTest.suite());
133 >        suite.addTest(AbstractQueueTest.suite());
134 >        suite.addTest(AbstractQueuedSynchronizerTest.suite());
135 >        suite.addTest(AbstractQueuedLongSynchronizerTest.suite());
136 >        suite.addTest(ArrayBlockingQueueTest.suite());
137 >        suite.addTest(ArrayDequeTest.suite());
138 >        suite.addTest(AtomicBooleanTest.suite());
139 >        suite.addTest(AtomicIntegerArrayTest.suite());
140 >        suite.addTest(AtomicIntegerFieldUpdaterTest.suite());
141 >        suite.addTest(AtomicIntegerTest.suite());
142 >        suite.addTest(AtomicLongArrayTest.suite());
143 >        suite.addTest(AtomicLongFieldUpdaterTest.suite());
144 >        suite.addTest(AtomicLongTest.suite());
145 >        suite.addTest(AtomicMarkableReferenceTest.suite());
146 >        suite.addTest(AtomicReferenceArrayTest.suite());
147 >        suite.addTest(AtomicReferenceFieldUpdaterTest.suite());
148 >        suite.addTest(AtomicReferenceTest.suite());
149 >        suite.addTest(AtomicStampedReferenceTest.suite());
150 >        suite.addTest(ConcurrentHashMapTest.suite());
151 >        suite.addTest(ConcurrentLinkedDequeTest.suite());
152 >        suite.addTest(ConcurrentLinkedQueueTest.suite());
153 >        suite.addTest(ConcurrentSkipListMapTest.suite());
154 >        suite.addTest(ConcurrentSkipListSubMapTest.suite());
155 >        suite.addTest(ConcurrentSkipListSetTest.suite());
156 >        suite.addTest(ConcurrentSkipListSubSetTest.suite());
157 >        suite.addTest(CopyOnWriteArrayListTest.suite());
158 >        suite.addTest(CopyOnWriteArraySetTest.suite());
159 >        suite.addTest(CountDownLatchTest.suite());
160 >        suite.addTest(CyclicBarrierTest.suite());
161 >        suite.addTest(DelayQueueTest.suite());
162 >        suite.addTest(EntryTest.suite());
163 >        suite.addTest(ExchangerTest.suite());
164 >        suite.addTest(ExecutorsTest.suite());
165 >        suite.addTest(ExecutorCompletionServiceTest.suite());
166 >        suite.addTest(FutureTaskTest.suite());
167 >        suite.addTest(LinkedBlockingDequeTest.suite());
168 >        suite.addTest(LinkedBlockingQueueTest.suite());
169 >        suite.addTest(LinkedListTest.suite());
170 >        suite.addTest(LockSupportTest.suite());
171 >        suite.addTest(PriorityBlockingQueueTest.suite());
172 >        suite.addTest(PriorityQueueTest.suite());
173 >        suite.addTest(ReentrantLockTest.suite());
174 >        suite.addTest(ReentrantReadWriteLockTest.suite());
175 >        suite.addTest(ScheduledExecutorTest.suite());
176 >        suite.addTest(ScheduledExecutorSubclassTest.suite());
177 >        suite.addTest(SemaphoreTest.suite());
178 >        suite.addTest(SynchronousQueueTest.suite());
179 >        suite.addTest(SystemTest.suite());
180 >        suite.addTest(ThreadLocalTest.suite());
181 >        suite.addTest(ThreadPoolExecutorTest.suite());
182 >        suite.addTest(ThreadPoolExecutorSubclassTest.suite());
183 >        suite.addTest(ThreadTest.suite());
184 >        suite.addTest(TimeUnitTest.suite());
185 >        suite.addTest(TreeMapTest.suite());
186 >        suite.addTest(TreeSetTest.suite());
187 >        suite.addTest(TreeSubMapTest.suite());
188 >        suite.addTest(TreeSubSetTest.suite());
189  
190          return suite;
191      }
# Line 195 | Line 209 | public class JSR166TestCase extends Test
209      /**
210       * Sets delays as multiples of SHORT_DELAY.
211       */
212 <    protected  void setDelays() {
212 >    protected void setDelays() {
213          SHORT_DELAY_MS = getShortDelay();
214 <        SMALL_DELAY_MS = SHORT_DELAY_MS * 5;
214 >        SMALL_DELAY_MS  = SHORT_DELAY_MS * 5;
215          MEDIUM_DELAY_MS = SHORT_DELAY_MS * 10;
216 <        LONG_DELAY_MS = SHORT_DELAY_MS * 50;
216 >        LONG_DELAY_MS   = SHORT_DELAY_MS * 50;
217      }
218  
219      /**
220 <     * Flag set true if any threadAssert methods fail
220 >     * The first exception encountered if any threadAssertXXX method fails.
221       */
222 <    volatile boolean threadFailed;
222 >    private final AtomicReference<Throwable> threadFailure
223 >        = new AtomicReference<Throwable>(null);
224  
225      /**
226 <     * Initializes test to indicate that no thread assertions have failed
226 >     * Records an exception so that it can be rethrown later in the test
227 >     * harness thread, triggering a test case failure.  Only the first
228 >     * failure is recorded; subsequent calls to this method from within
229 >     * the same test have no effect.
230       */
231 +    public void threadRecordFailure(Throwable t) {
232 +        threadFailure.compareAndSet(null, t);
233 +    }
234 +
235      public void setUp() {
236          setDelays();
215        threadFailed = false;
237      }
238  
239      /**
240 <     * Triggers test case failure if any thread assertions have failed
241 <     */
242 <    public void tearDown() {
243 <        assertFalse(threadFailed);
240 >     * Triggers test case failure if any thread assertions have failed,
241 >     * by rethrowing, in the test harness thread, any exception recorded
242 >     * earlier by threadRecordFailure.
243 >     */
244 >    public void tearDown() throws Exception {
245 >        Throwable t = threadFailure.get();
246 >        if (t != null) {
247 >            if (t instanceof Error)
248 >                throw (Error) t;
249 >            else if (t instanceof RuntimeException)
250 >                throw (RuntimeException) t;
251 >            else if (t instanceof Exception)
252 >                throw (Exception) t;
253 >            else {
254 >                AssertionFailedError afe =
255 >                    new AssertionFailedError(t.toString());
256 >                afe.initCause(t);
257 >                throw afe;
258 >            }
259 >        }
260      }
261  
262      /**
263 <     * Fail, also setting status to indicate current testcase should fail
263 >     * Just like fail(reason), but additionally recording (using
264 >     * threadRecordFailure) any AssertionFailedError thrown, so that
265 >     * the current testcase will fail.
266       */
267      public void threadFail(String reason) {
268 <        threadFailed = true;
269 <        fail(reason);
268 >        try {
269 >            fail(reason);
270 >        } catch (AssertionFailedError t) {
271 >            threadRecordFailure(t);
272 >            fail(reason);
273 >        }
274      }
275  
276      /**
277 <     * If expression not true, set status to indicate current testcase
278 <     * should fail
277 >     * Just like assertTrue(b), but additionally recording (using
278 >     * threadRecordFailure) any AssertionFailedError thrown, so that
279 >     * the current testcase will fail.
280       */
281      public void threadAssertTrue(boolean b) {
282 <        if (!b) {
239 <            threadFailed = true;
282 >        try {
283              assertTrue(b);
284 +        } catch (AssertionFailedError t) {
285 +            threadRecordFailure(t);
286 +            throw t;
287          }
288      }
289  
290      /**
291 <     * If expression not false, set status to indicate current testcase
292 <     * should fail
291 >     * Just like assertFalse(b), but additionally recording (using
292 >     * threadRecordFailure) any AssertionFailedError thrown, so that
293 >     * the current testcase will fail.
294       */
295      public void threadAssertFalse(boolean b) {
296 <        if (b) {
250 <            threadFailed = true;
296 >        try {
297              assertFalse(b);
298 +        } catch (AssertionFailedError t) {
299 +            threadRecordFailure(t);
300 +            throw t;
301          }
302      }
303  
304      /**
305 <     * If argument not null, set status to indicate current testcase
306 <     * should fail
305 >     * Just like assertNull(x), but additionally recording (using
306 >     * threadRecordFailure) any AssertionFailedError thrown, so that
307 >     * the current testcase will fail.
308       */
309      public void threadAssertNull(Object x) {
310 <        if (x != null) {
261 <            threadFailed = true;
310 >        try {
311              assertNull(x);
312 +        } catch (AssertionFailedError t) {
313 +            threadRecordFailure(t);
314 +            throw t;
315          }
316      }
317  
318      /**
319 <     * If arguments not equal, set status to indicate current testcase
320 <     * should fail
319 >     * Just like assertEquals(x, y), but additionally recording (using
320 >     * threadRecordFailure) any AssertionFailedError thrown, so that
321 >     * the current testcase will fail.
322       */
323      public void threadAssertEquals(long x, long y) {
324 <        if (x != y) {
272 <            threadFailed = true;
324 >        try {
325              assertEquals(x, y);
326 +        } catch (AssertionFailedError t) {
327 +            threadRecordFailure(t);
328 +            throw t;
329          }
330      }
331  
332      /**
333 <     * If arguments not equal, set status to indicate current testcase
334 <     * should fail
333 >     * Just like assertEquals(x, y), but additionally recording (using
334 >     * threadRecordFailure) any AssertionFailedError thrown, so that
335 >     * the current testcase will fail.
336       */
337      public void threadAssertEquals(Object x, Object y) {
338 <        if (x != y && (x == null || !x.equals(y))) {
283 <            threadFailed = true;
338 >        try {
339              assertEquals(x, y);
340 +        } catch (AssertionFailedError t) {
341 +            threadRecordFailure(t);
342 +            throw t;
343 +        } catch (Throwable t) {
344 +            threadUnexpectedException(t);
345 +        }
346 +    }
347 +
348 +    /**
349 +     * Just like assertSame(x, y), but additionally recording (using
350 +     * threadRecordFailure) any AssertionFailedError thrown, so that
351 +     * the current testcase will fail.
352 +     */
353 +    public void threadAssertSame(Object x, Object y) {
354 +        try {
355 +            assertSame(x, y);
356 +        } catch (AssertionFailedError t) {
357 +            threadRecordFailure(t);
358 +            throw t;
359          }
360      }
361  
362      /**
363 <     * threadFail with message "should throw exception"
363 >     * Calls threadFail with message "should throw exception".
364       */
365      public void threadShouldThrow() {
366 <        threadFailed = true;
293 <        fail("should throw exception");
366 >        threadFail("should throw exception");
367      }
368  
369      /**
370 <     * threadFail with message "Unexpected exception"
370 >     * Calls threadFail with message "should throw" + exceptionName.
371       */
372 <    public void threadUnexpectedException() {
373 <        threadFailed = true;
301 <        fail("Unexpected exception");
372 >    public void threadShouldThrow(String exceptionName) {
373 >        threadFail("should throw " + exceptionName);
374      }
375  
376      /**
377 <     * threadFail with message "Unexpected exception", with argument
377 >     * Records the given exception using {@link #threadRecordFailure},
378 >     * then rethrows the exception, wrapping it in an
379 >     * AssertionFailedError if necessary.
380       */
381 <    public void threadUnexpectedException(Throwable ex) {
382 <        threadFailed = true;
383 <        ex.printStackTrace();
384 <        fail("Unexpected exception: " + ex);
381 >    public void threadUnexpectedException(Throwable t) {
382 >        threadRecordFailure(t);
383 >        t.printStackTrace();
384 >        if (t instanceof RuntimeException)
385 >            throw (RuntimeException) t;
386 >        else if (t instanceof Error)
387 >            throw (Error) t;
388 >        else {
389 >            AssertionFailedError afe =
390 >                new AssertionFailedError("unexpected exception: " + t);
391 >            t.initCause(t);
392 >            throw afe;
393 >        }
394      }
395  
396      /**
397 <     * Wait out termination of a thread pool or fail doing so
397 >     * Waits out termination of a thread pool or fails doing so.
398       */
399      public void joinPool(ExecutorService exec) {
400          try {
401              exec.shutdown();
402 <            assertTrue(exec.awaitTermination(LONG_DELAY_MS, MILLISECONDS));
402 >            assertTrue("ExecutorService did not terminate in a timely manner",
403 >                       exec.awaitTermination(LONG_DELAY_MS, MILLISECONDS));
404          } catch (SecurityException ok) {
405              // Allowed in case test doesn't have privs
406          } catch (InterruptedException ie) {
407 <            fail("Unexpected exception");
407 >            fail("Unexpected InterruptedException");
408          }
409      }
410  
411  
412      /**
413 <     * fail with message "should throw exception"
413 >     * Fails with message "should throw exception".
414       */
415      public void shouldThrow() {
416          fail("Should throw exception");
417      }
418  
419      /**
420 <     * fail with message "Unexpected exception"
337 <     */
338 <    public void unexpectedException() {
339 <        fail("Unexpected exception");
340 <    }
341 <
342 <    /**
343 <     * fail with message "Unexpected exception", with argument
420 >     * Fails with message "should throw " + exceptionName.
421       */
422 <    public void unexpectedException(Throwable ex) {
423 <        ex.printStackTrace();
347 <        fail("Unexpected exception: " + ex);
422 >    public void shouldThrow(String exceptionName) {
423 >        fail("Should throw " + exceptionName);
424      }
425  
350
426      /**
427       * The number of elements to place in collections, arrays, etc.
428       */
429 <    static final int SIZE = 20;
429 >    public static final int SIZE = 20;
430  
431      // Some convenient Integer constants
432  
433 <    static final Integer zero = new Integer(0);
434 <    static final Integer one = new Integer(1);
435 <    static final Integer two = new Integer(2);
436 <    static final Integer three  = new Integer(3);
437 <    static final Integer four  = new Integer(4);
438 <    static final Integer five  = new Integer(5);
439 <    static final Integer six = new Integer(6);
440 <    static final Integer seven = new Integer(7);
441 <    static final Integer eight = new Integer(8);
442 <    static final Integer nine = new Integer(9);
443 <    static final Integer m1  = new Integer(-1);
444 <    static final Integer m2  = new Integer(-2);
445 <    static final Integer m3  = new Integer(-3);
446 <    static final Integer m4 = new Integer(-4);
447 <    static final Integer m5 = new Integer(-5);
448 <    static final Integer m6 = new Integer(-6);
449 <    static final Integer m10 = new Integer(-10);
433 >    public static final Integer zero  = new Integer(0);
434 >    public static final Integer one   = new Integer(1);
435 >    public static final Integer two   = new Integer(2);
436 >    public static final Integer three = new Integer(3);
437 >    public static final Integer four  = new Integer(4);
438 >    public static final Integer five  = new Integer(5);
439 >    public static final Integer six   = new Integer(6);
440 >    public static final Integer seven = new Integer(7);
441 >    public static final Integer eight = new Integer(8);
442 >    public static final Integer nine  = new Integer(9);
443 >    public static final Integer m1  = new Integer(-1);
444 >    public static final Integer m2  = new Integer(-2);
445 >    public static final Integer m3  = new Integer(-3);
446 >    public static final Integer m4  = new Integer(-4);
447 >    public static final Integer m5  = new Integer(-5);
448 >    public static final Integer m6  = new Integer(-6);
449 >    public static final Integer m10 = new Integer(-10);
450  
451  
452      /**
453 +     * Runs Runnable r with a security policy that permits precisely
454 +     * the specified permissions.  If there is no current security
455 +     * manager, the runnable is run twice, both with and without a
456 +     * security manager.  We require that any security manager permit
457 +     * getPolicy/setPolicy.
458 +     */
459 +    public void runWithPermissions(Runnable r, Permission... permissions) {
460 +        SecurityManager sm = System.getSecurityManager();
461 +        if (sm == null) {
462 +            r.run();
463 +            Policy savedPolicy = Policy.getPolicy();
464 +            try {
465 +                Policy.setPolicy(permissivePolicy());
466 +                System.setSecurityManager(new SecurityManager());
467 +                runWithPermissions(r, permissions);
468 +            } finally {
469 +                System.setSecurityManager(null);
470 +                Policy.setPolicy(savedPolicy);
471 +            }
472 +        } else {
473 +            Policy savedPolicy = Policy.getPolicy();
474 +            AdjustablePolicy policy = new AdjustablePolicy(permissions);
475 +            Policy.setPolicy(policy);
476 +
477 +            try {
478 +                r.run();
479 +            } finally {
480 +                policy.addPermission(new SecurityPermission("setPolicy"));
481 +                Policy.setPolicy(savedPolicy);
482 +            }
483 +        }
484 +    }
485 +
486 +    /**
487 +     * Runs a runnable without any permissions.
488 +     */
489 +    public void runWithoutPermissions(Runnable r) {
490 +        runWithPermissions(r);
491 +    }
492 +
493 +    /**
494       * A security policy where new permissions can be dynamically added
495       * or all cleared.
496       */
497 <    static class AdjustablePolicy extends java.security.Policy {
497 >    public static class AdjustablePolicy extends java.security.Policy {
498          Permissions perms = new Permissions();
499 <        AdjustablePolicy() { }
499 >        AdjustablePolicy(Permission... permissions) {
500 >            for (Permission permission : permissions)
501 >                perms.add(permission);
502 >        }
503          void addPermission(Permission perm) { perms.add(perm); }
504          void clearPermissions() { perms = new Permissions(); }
505 <        public PermissionCollection getPermissions(CodeSource cs) {
506 <            return perms;
507 <        }
508 <        public PermissionCollection getPermissions(ProtectionDomain pd) {
509 <            return perms;
510 <        }
511 <        public boolean implies(ProtectionDomain pd, Permission p) {
512 <            return perms.implies(p);
513 <        }
514 <        public void refresh() {}
505 >        public PermissionCollection getPermissions(CodeSource cs) {
506 >            return perms;
507 >        }
508 >        public PermissionCollection getPermissions(ProtectionDomain pd) {
509 >            return perms;
510 >        }
511 >        public boolean implies(ProtectionDomain pd, Permission p) {
512 >            return perms.implies(p);
513 >        }
514 >        public void refresh() {}
515 >    }
516 >
517 >    /**
518 >     * Returns a policy containing all the permissions we ever need.
519 >     */
520 >    public static Policy permissivePolicy() {
521 >        return new AdjustablePolicy
522 >            // Permissions j.u.c. needs directly
523 >            (new RuntimePermission("modifyThread"),
524 >             new RuntimePermission("getClassLoader"),
525 >             new RuntimePermission("setContextClassLoader"),
526 >             // Permissions needed to change permissions!
527 >             new SecurityPermission("getPolicy"),
528 >             new SecurityPermission("setPolicy"),
529 >             new RuntimePermission("setSecurityManager"),
530 >             // Permissions needed by the junit test harness
531 >             new RuntimePermission("accessDeclaredMembers"),
532 >             new PropertyPermission("*", "read"),
533 >             new java.io.FilePermission("<<ALL FILES>>", "read"));
534      }
535  
536      /**
537 <     * Sleep until the timeout has elapsed, or interrupted.
537 >     * Sleeps until the timeout has elapsed, or interrupted.
538       * Does <em>NOT</em> throw InterruptedException.
539       */
540      void sleepTillInterrupted(long timeoutMillis) {
541          try {
542              Thread.sleep(timeoutMillis);
543 <        } catch (InterruptedException wakeup) {
406 <        }
543 >        } catch (InterruptedException wakeup) {}
544      }
545  
546      /**
547 <     * Returns a new started Thread running the given runnable.
547 >     * Returns a new started daemon Thread running the given runnable.
548       */
549      Thread newStartedThread(Runnable runnable) {
550          Thread t = new Thread(runnable);
551 +        t.setDaemon(true);
552          t.start();
553          return t;
554      }
555  
556 +    /**
557 +     * Waits for the specified time (in milliseconds) for the thread
558 +     * to terminate (using {@link Thread#join(long)}), else interrupts
559 +     * the thread (in the hope that it may terminate later) and fails.
560 +     */
561 +    void awaitTermination(Thread t, long timeoutMillis) {
562 +        try {
563 +            t.join(timeoutMillis);
564 +        } catch (InterruptedException ie) {
565 +            threadUnexpectedException(ie);
566 +        } finally {
567 +            if (t.isAlive()) {
568 +                t.interrupt();
569 +                fail("Test timed out");
570 +            }
571 +        }
572 +    }
573 +
574      // Some convenient Runnable classes
575  
576 <    abstract class CheckedRunnable implements Runnable {
577 <        abstract void realRun() throws Throwable;
576 >    public abstract class CheckedRunnable implements Runnable {
577 >        protected abstract void realRun() throws Throwable;
578  
579          public final void run() {
580              try {
# Line 429 | Line 585 | public class JSR166TestCase extends Test
585          }
586      }
587  
588 <    abstract class CheckedInterruptedRunnable implements Runnable {
589 <        abstract void realRun() throws Throwable;
588 >    public abstract class RunnableShouldThrow implements Runnable {
589 >        protected abstract void realRun() throws Throwable;
590 >
591 >        final Class<?> exceptionClass;
592 >
593 >        <T extends Throwable> RunnableShouldThrow(Class<T> exceptionClass) {
594 >            this.exceptionClass = exceptionClass;
595 >        }
596 >
597 >        public final void run() {
598 >            try {
599 >                realRun();
600 >                threadShouldThrow(exceptionClass.getSimpleName());
601 >            } catch (Throwable t) {
602 >                if (! exceptionClass.isInstance(t))
603 >                    threadUnexpectedException(t);
604 >            }
605 >        }
606 >    }
607 >
608 >    public abstract class ThreadShouldThrow extends Thread {
609 >        protected abstract void realRun() throws Throwable;
610 >
611 >        final Class<?> exceptionClass;
612 >
613 >        <T extends Throwable> ThreadShouldThrow(Class<T> exceptionClass) {
614 >            this.exceptionClass = exceptionClass;
615 >        }
616 >
617 >        public final void run() {
618 >            try {
619 >                realRun();
620 >                threadShouldThrow(exceptionClass.getSimpleName());
621 >            } catch (Throwable t) {
622 >                if (! exceptionClass.isInstance(t))
623 >                    threadUnexpectedException(t);
624 >            }
625 >        }
626 >    }
627 >
628 >    public abstract class CheckedInterruptedRunnable implements Runnable {
629 >        protected abstract void realRun() throws Throwable;
630  
631          public final void run() {
632              try {
633                  realRun();
634 <                threadShouldThrow();
634 >                threadShouldThrow("InterruptedException");
635              } catch (InterruptedException success) {
636              } catch (Throwable t) {
637                  threadUnexpectedException(t);
# Line 443 | Line 639 | public class JSR166TestCase extends Test
639          }
640      }
641  
642 <    abstract class CheckedCallable<T> implements Callable<T> {
643 <        abstract T realCall() throws Throwable;
642 >    public abstract class CheckedCallable<T> implements Callable<T> {
643 >        protected abstract T realCall() throws Throwable;
644  
645          public final T call() {
646              try {
# Line 456 | Line 652 | public class JSR166TestCase extends Test
652          }
653      }
654  
655 <    static class NoOpRunnable implements Runnable {
655 >    public abstract class CheckedInterruptedCallable<T>
656 >        implements Callable<T> {
657 >        protected abstract T realCall() throws Throwable;
658 >
659 >        public final T call() {
660 >            try {
661 >                T result = realCall();
662 >                threadShouldThrow("InterruptedException");
663 >                return result;
664 >            } catch (InterruptedException success) {
665 >            } catch (Throwable t) {
666 >                threadUnexpectedException(t);
667 >            }
668 >            return null;
669 >        }
670 >    }
671 >
672 >    public static class NoOpRunnable implements Runnable {
673          public void run() {}
674      }
675  
676 <    static class NoOpCallable implements Callable {
676 >    public static class NoOpCallable implements Callable {
677          public Object call() { return Boolean.TRUE; }
678      }
679  
680 <    static final String TEST_STRING = "a test string";
680 >    public static final String TEST_STRING = "a test string";
681  
682 <    static class StringTask implements Callable<String> {
682 >    public static class StringTask implements Callable<String> {
683          public String call() { return TEST_STRING; }
684      }
685  
686 <    static class NPETask implements Callable<String> {
686 >    public Callable<String> latchAwaitingStringTask(final CountDownLatch latch) {
687 >        return new CheckedCallable<String>() {
688 >            public String realCall() {
689 >                try {
690 >                    latch.await();
691 >                } catch (InterruptedException quittingTime) {}
692 >                return TEST_STRING;
693 >            }};
694 >    }
695 >
696 >    public static class NPETask implements Callable<String> {
697          public String call() { throw new NullPointerException(); }
698      }
699  
700 <    static class CallableOne implements Callable<Integer> {
700 >    public static class CallableOne implements Callable<Integer> {
701          public Integer call() { return one; }
702      }
703  
704 <    class ShortRunnable extends CheckedRunnable {
705 <        void realRun() throws Throwable {
704 >    public class ShortRunnable extends CheckedRunnable {
705 >        protected void realRun() throws Throwable {
706              Thread.sleep(SHORT_DELAY_MS);
707          }
708      }
709  
710 <    class ShortInterruptedRunnable extends CheckedInterruptedRunnable {
711 <        void realRun() throws InterruptedException {
710 >    public class ShortInterruptedRunnable extends CheckedInterruptedRunnable {
711 >        protected void realRun() throws InterruptedException {
712              Thread.sleep(SHORT_DELAY_MS);
713          }
714      }
715  
716 <    class SmallRunnable extends CheckedRunnable {
717 <        void realRun() throws Throwable {
716 >    public class SmallRunnable extends CheckedRunnable {
717 >        protected void realRun() throws Throwable {
718              Thread.sleep(SMALL_DELAY_MS);
719          }
720      }
721  
722 <    class SmallPossiblyInterruptedRunnable extends CheckedRunnable {
723 <        void realRun() {
722 >    public class SmallPossiblyInterruptedRunnable extends CheckedRunnable {
723 >        protected void realRun() {
724              try {
725                  Thread.sleep(SMALL_DELAY_MS);
726 <            }
504 <            catch (InterruptedException ok) {
505 <            }
726 >            } catch (InterruptedException ok) {}
727          }
728      }
729  
730 <    class SmallCallable extends CheckedCallable {
731 <        Object realCall() throws Throwable {
730 >    public class SmallCallable extends CheckedCallable {
731 >        protected Object realCall() throws InterruptedException {
732              Thread.sleep(SMALL_DELAY_MS);
733              return Boolean.TRUE;
734          }
735      }
736  
737 <    class SmallInterruptedRunnable extends CheckedInterruptedRunnable {
738 <        void realRun() throws InterruptedException {
518 <            Thread.sleep(SMALL_DELAY_MS);
519 <        }
520 <    }
521 <
522 <    class MediumRunnable extends CheckedRunnable {
523 <        void realRun() throws Throwable {
737 >    public class MediumRunnable extends CheckedRunnable {
738 >        protected void realRun() throws Throwable {
739              Thread.sleep(MEDIUM_DELAY_MS);
740          }
741      }
742  
743 <    class MediumInterruptedRunnable extends CheckedInterruptedRunnable {
744 <        void realRun() throws InterruptedException {
743 >    public class MediumInterruptedRunnable extends CheckedInterruptedRunnable {
744 >        protected void realRun() throws InterruptedException {
745              Thread.sleep(MEDIUM_DELAY_MS);
746          }
747      }
748  
749 <    class MediumPossiblyInterruptedRunnable extends CheckedRunnable {
750 <        void realRun() {
749 >    public class MediumPossiblyInterruptedRunnable extends CheckedRunnable {
750 >        protected void realRun() {
751              try {
752                  Thread.sleep(MEDIUM_DELAY_MS);
753 <            }
539 <            catch (InterruptedException ok) {
540 <            }
753 >            } catch (InterruptedException ok) {}
754          }
755      }
756  
757 <    class LongPossiblyInterruptedRunnable extends CheckedRunnable {
758 <        void realRun() {
757 >    public class LongPossiblyInterruptedRunnable extends CheckedRunnable {
758 >        protected void realRun() {
759              try {
760                  Thread.sleep(LONG_DELAY_MS);
761 <            }
549 <            catch (InterruptedException ok) {
550 <            }
761 >            } catch (InterruptedException ok) {}
762          }
763      }
764  
765      /**
766       * For use as ThreadFactory in constructors
767       */
768 <    static class SimpleThreadFactory implements ThreadFactory {
768 >    public static class SimpleThreadFactory implements ThreadFactory {
769          public Thread newThread(Runnable r) {
770              return new Thread(r);
771          }
772      }
773  
774 <    static class TrackedShortRunnable implements Runnable {
775 <        volatile boolean done = false;
774 >    public static class TrackedShortRunnable implements Runnable {
775 >        public volatile boolean done = false;
776          public void run() {
777              try {
778                  Thread.sleep(SMALL_DELAY_MS);
779                  done = true;
780 <            } catch (Exception e) {
570 <            }
780 >            } catch (InterruptedException ok) {}
781          }
782      }
783  
784 <    static class TrackedMediumRunnable implements Runnable {
785 <        volatile boolean done = false;
784 >    public static class TrackedMediumRunnable implements Runnable {
785 >        public volatile boolean done = false;
786          public void run() {
787              try {
788                  Thread.sleep(MEDIUM_DELAY_MS);
789                  done = true;
790 <            } catch (Exception e) {
581 <            }
790 >            } catch (InterruptedException ok) {}
791          }
792      }
793  
794 <    static class TrackedLongRunnable implements Runnable {
795 <        volatile boolean done = false;
794 >    public static class TrackedLongRunnable implements Runnable {
795 >        public volatile boolean done = false;
796          public void run() {
797              try {
798                  Thread.sleep(LONG_DELAY_MS);
799                  done = true;
800 <            } catch (Exception e) {
592 <            }
800 >            } catch (InterruptedException ok) {}
801          }
802      }
803  
804 <    static class TrackedNoOpRunnable implements Runnable {
805 <        volatile boolean done = false;
804 >    public static class TrackedNoOpRunnable implements Runnable {
805 >        public volatile boolean done = false;
806          public void run() {
807              done = true;
808          }
809      }
810  
811 <    static class TrackedCallable implements Callable {
812 <        volatile boolean done = false;
811 >    public static class TrackedCallable implements Callable {
812 >        public volatile boolean done = false;
813          public Object call() {
814              try {
815                  Thread.sleep(SMALL_DELAY_MS);
816                  done = true;
817 <            } catch (Exception e) {
610 <            }
817 >            } catch (InterruptedException ok) {}
818              return Boolean.TRUE;
819          }
820      }
821  
822 +    /**
823 +     * Analog of CheckedRunnable for RecursiveAction
824 +     */
825 +    public abstract class CheckedRecursiveAction extends RecursiveAction {
826 +        protected abstract void realCompute() throws Throwable;
827 +
828 +        public final void compute() {
829 +            try {
830 +                realCompute();
831 +            } catch (Throwable t) {
832 +                threadUnexpectedException(t);
833 +            }
834 +        }
835 +    }
836 +
837 +    /**
838 +     * Analog of CheckedCallable for RecursiveTask
839 +     */
840 +    public abstract class CheckedRecursiveTask<T> extends RecursiveTask<T> {
841 +        protected abstract T realCompute() throws Throwable;
842 +
843 +        public final T compute() {
844 +            try {
845 +                return realCompute();
846 +            } catch (Throwable t) {
847 +                threadUnexpectedException(t);
848 +                return null;
849 +            }
850 +        }
851 +    }
852  
853      /**
854       * For use as RejectedExecutionHandler in constructors
855       */
856 <    static class NoOpREHandler implements RejectedExecutionHandler {
856 >    public static class NoOpREHandler implements RejectedExecutionHandler {
857          public void rejectedExecution(Runnable r,
858                                        ThreadPoolExecutor executor) {}
859      }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines