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.5 by dl, Fri Sep 26 15:33:13 2003 UTC vs.
Revision 1.13 by dl, Sat Dec 27 19:26:43 2003 UTC

# Line 1 | Line 1
1   /*
2 < * Written by members of JCP JSR-166 Expert Group and released to the
3 < * public domain. Use, modify, and redistribute this code in any way
4 < * without acknowledgement. Other contributors include Andrew Wright,
5 < * Jeffrey Hayes, Pat Fischer, Mike Judd.
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
5 > * Other contributors include Andrew Wright, Jeffrey Hayes,
6 > * Pat Fisher, Mike Judd.
7   */
8  
9   import junit.framework.*;
10   import java.util.*;
11   import java.util.concurrent.*;
12   import java.io.*;
13 <
13 > import java.security.*;
14  
15   /**
16   * Base class for JSR166 Junit TCK tests.  Defines some constants,
# Line 34 | Line 35 | import java.io.*;
35   * them. These methods are used to clear and check for thread
36   * assertion failures.</li>
37   *
38 < * <li>All delays and timeouts must use one of the constants {@link
39 < * SHORT_DELAY_MS}, {@link SMALL_DELAY_MS}, {@link MEDIUM_DELAY_MS},
40 < * {@link LONG_DELAY_MS}. The idea here is that a SHORT is always
38 > * <li>All delays and timeouts must use one of the constants <tt>
39 > * SHORT_DELAY_MS</tt>, <tt> SMALL_DELAY_MS</tt>, <tt> MEDIUM_DELAY_MS</tt>,
40 > * <tt> LONG_DELAY_MS</tt>. The idea here is that a SHORT is always
41   * discriminable from zero time, and always allows enough time for the
42   * small amounts of computation (creating a thread, calling a few
43   * methods, etc) needed to reach a timeout point. Similarly, a SMALL
# Line 47 | Line 48 | import java.io.*;
48   *
49   * <li> All threads generated must be joined inside each test case
50   * method (or <tt>fail</tt> to do so) before returning from the
51 < * method. The {@link joinPool} method can be used to do this when
51 > * method. The <tt> joinPool</tt> method can be used to do this when
52   * using Executors.</li>
53   *
54   * </ol>
55 + *
56 + * <p> <b>Other notes</b>
57 + * <ul>
58 + *
59 + * <li> Usually, there is one testcase method per JSR166 method
60 + * covering "normal" operation, and then as many exception-testing
61 + * methods as there are exceptions the method can throw. Sometimes
62 + * there are multiple tests per JSR166 method when the different
63 + * "normal" behaviors differ significantly. And sometimes testcases
64 + * cover multiple methods when they cannot be tested in
65 + * isolation.</li>
66 + *
67 + * <li> The documentation style for testcases is to provide as javadoc
68 + * a simple sentence or two describing the property that the testcase
69 + * method purports to test. The javadocs do not say anything about how
70 + * the property is tested. To find out, read the code.</li>
71 + *
72 + * <li> These tests are "conformance tests", and do not attempt to
73 + * test throughput, latency, scalability or other performance factors
74 + * (see the separate "jtreg" tests for a set intended to check these
75 + * for the most central aspects of functionality.) So, most tests use
76 + * the smallest sensible numbers of threads, collection sizes, etc
77 + * needed to check basic conformance.</li>
78 + *
79 + * <li>The test classes currently do not declare inclusion in
80 + * any particular package to simplify things for people integrating
81 + * them in TCK test suites.</li>
82 + *
83 + * <li> As a convenience, the <tt>main</tt> of this class (JSR166TestCase)
84 + * runs all JSR166 unit tests.</li>
85 + *
86 + * </ul>
87   */
88   public class JSR166TestCase extends TestCase {
89 +    /**
90 +     * Runs all JSR166 unit tests using junit.textui.TestRunner
91 +     */
92 +    public static void main (String[] args) {
93 +        junit.textui.TestRunner.run (suite());
94 +    }
95 +
96 +    /**
97 +     * Collects all JSR166 unit tests as one suite
98 +     */
99 +    public static Test suite ( ) {
100 +        TestSuite suite = new TestSuite("JSR166 Unit Tests");
101 +        
102 +        suite.addTest(new TestSuite(AbstractExecutorServiceTest.class));
103 +        suite.addTest(new TestSuite(ArrayBlockingQueueTest.class));
104 +        suite.addTest(new TestSuite(AtomicBooleanTest.class));
105 +        suite.addTest(new TestSuite(AtomicIntegerArrayTest.class));
106 +        suite.addTest(new TestSuite(AtomicIntegerFieldUpdaterTest.class));
107 +        suite.addTest(new TestSuite(AtomicIntegerTest.class));
108 +        suite.addTest(new TestSuite(AtomicLongArrayTest.class));
109 +        suite.addTest(new TestSuite(AtomicLongFieldUpdaterTest.class));
110 +        suite.addTest(new TestSuite(AtomicLongTest.class));
111 +        suite.addTest(new TestSuite(AtomicMarkableReferenceTest.class));
112 +        suite.addTest(new TestSuite(AtomicReferenceArrayTest.class));
113 +        suite.addTest(new TestSuite(AtomicReferenceFieldUpdaterTest.class));
114 +        suite.addTest(new TestSuite(AtomicReferenceTest.class));
115 +        suite.addTest(new TestSuite(AtomicStampedReferenceTest.class));
116 +        suite.addTest(new TestSuite(ConcurrentHashMapTest.class));
117 +        suite.addTest(new TestSuite(ConcurrentLinkedQueueTest.class));
118 +        suite.addTest(new TestSuite(CopyOnWriteArrayListTest.class));
119 +        suite.addTest(new TestSuite(CopyOnWriteArraySetTest.class));
120 +        suite.addTest(new TestSuite(CountDownLatchTest.class));
121 +        suite.addTest(new TestSuite(CyclicBarrierTest.class));
122 +        suite.addTest(new TestSuite(DelayQueueTest.class));
123 +        suite.addTest(new TestSuite(ExchangerTest.class));
124 +        suite.addTest(new TestSuite(ExecutorsTest.class));
125 +        suite.addTest(new TestSuite(ExecutorCompletionServiceTest.class));
126 +        suite.addTest(new TestSuite(FutureTaskTest.class));
127 +        suite.addTest(new TestSuite(LinkedBlockingQueueTest.class));
128 +        suite.addTest(new TestSuite(LinkedListTest.class));
129 +        suite.addTest(new TestSuite(LockSupportTest.class));
130 +        suite.addTest(new TestSuite(PriorityBlockingQueueTest.class));
131 +        suite.addTest(new TestSuite(PriorityQueueTest.class));
132 +        suite.addTest(new TestSuite(ReentrantLockTest.class));
133 +        suite.addTest(new TestSuite(ReentrantReadWriteLockTest.class));
134 +        suite.addTest(new TestSuite(ScheduledExecutorTest.class));
135 +        suite.addTest(new TestSuite(SemaphoreTest.class));
136 +        suite.addTest(new TestSuite(SynchronousQueueTest.class));
137 +        suite.addTest(new TestSuite(SystemTest.class));
138 +        suite.addTest(new TestSuite(ThreadLocalTest.class));
139 +        suite.addTest(new TestSuite(ThreadPoolExecutorTest.class));
140 +        suite.addTest(new TestSuite(ThreadTest.class));
141 +        suite.addTest(new TestSuite(TimeUnitTest.class));
142 +                
143 +        return suite;
144 +    }
145 +
146  
147      public static long SHORT_DELAY_MS;
148      public static long SMALL_DELAY_MS;
# Line 232 | Line 322 | public class JSR166TestCase extends Test
322      static final Integer m10 = new Integer(-10);
323  
324  
325 +    /**
326 +     * A security policy where new permissions can be dynamically added
327 +     * or all cleared.
328 +     */
329 +    static class AdjustablePolicy extends java.security.Policy {
330 +        Permissions perms = new Permissions();
331 +        AdjustablePolicy() { }
332 +        void addPermission(Permission perm) { perms.add(perm); }
333 +        void clearPermissions() { perms = new Permissions(); }
334 +        public PermissionCollection getPermissions(CodeSource cs) {
335 +            return perms;
336 +        }
337 +        public PermissionCollection getPermissions(ProtectionDomain pd) {
338 +            return perms;
339 +        }
340 +        public boolean implies(ProtectionDomain pd, Permission p) {
341 +            return perms.implies(p);
342 +        }
343 +        public void refresh() {}
344 +    }
345 +
346 +
347      // Some convenient Runnable classes
348  
349      static class NoOpRunnable implements Runnable {
# Line 242 | Line 354 | public class JSR166TestCase extends Test
354          public Object call() { return Boolean.TRUE; }
355      }
356  
357 +    static final String TEST_STRING = "a test string";
358 +
359 +    static class StringTask implements Callable<String> {
360 +        public String call() { return TEST_STRING; }
361 +    }
362 +
363 +    static class NPETask implements Callable<String> {
364 +        public String call() { throw new NullPointerException(); }
365 +    }
366 +
367 +    static class CallableOne implements Callable<Integer> {
368 +        public Integer call() { return one; }
369 +    }
370 +
371      class ShortRunnable implements Runnable {
372          public void run() {
373              try {
# Line 275 | Line 401 | public class JSR166TestCase extends Test
401          }
402      }
403  
404 +    class SmallPossiblyInterruptedRunnable implements Runnable {
405 +        public void run() {
406 +            try {
407 +                Thread.sleep(SMALL_DELAY_MS);
408 +            }
409 +            catch(Exception e) {
410 +            }
411 +        }
412 +    }
413 +
414      class SmallCallable implements Callable {
415          public Object call() {
416              try {
# Line 331 | Line 467 | public class JSR166TestCase extends Test
467          }
468      }
469  
470 +    class LongPossiblyInterruptedRunnable implements Runnable {
471 +        public void run() {
472 +            try {
473 +                Thread.sleep(LONG_DELAY_MS);
474 +            }
475 +            catch(InterruptedException success) {
476 +            }
477 +        }
478 +    }
479 +
480      /**
481       * For use as ThreadFactory in constructors
482       */
# Line 340 | Line 486 | public class JSR166TestCase extends Test
486          }  
487      }
488  
489 <    static class TrackedRunnable implements Runnable {
489 >    static class TrackedShortRunnable implements Runnable {
490          volatile boolean done = false;
491          public void run() {
492              try {
# Line 351 | Line 497 | public class JSR166TestCase extends Test
497          }
498      }
499  
500 +    static class TrackedMediumRunnable implements Runnable {
501 +        volatile boolean done = false;
502 +        public void run() {
503 +            try {
504 +                Thread.sleep(MEDIUM_DELAY_MS);
505 +                done = true;
506 +            } catch(Exception e){
507 +            }
508 +        }
509 +    }
510 +
511 +    static class TrackedLongRunnable implements Runnable {
512 +        volatile boolean done = false;
513 +        public void run() {
514 +            try {
515 +                Thread.sleep(LONG_DELAY_MS);
516 +                done = true;
517 +            } catch(Exception e){
518 +            }
519 +        }
520 +    }
521 +
522 +    static class TrackedNoOpRunnable implements Runnable {
523 +        volatile boolean done = false;
524 +        public void run() {
525 +            done = true;
526 +        }
527 +    }
528 +
529      static class TrackedCallable implements Callable {
530          volatile boolean done = false;
531          public Object call() {

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines