--- jsr166/src/test/tck/JSR166TestCase.java 2003/09/14 20:42:40 1.1
+++ jsr166/src/test/tck/JSR166TestCase.java 2003/09/26 15:33:13 1.5
@@ -12,11 +12,12 @@ import java.io.*;
/**
- * Base class for JSR166 Junit TCK tests. Defines some constants and
- * utility methods, as well as a simple framework for helping to make
- * sure that assertions failing in generated threads cause the
- * associated test that generated them to itself fail (which JUnit doe
- * not otherwise arrange). The rules for creating such tests are:
+ * Base class for JSR166 Junit TCK tests. Defines some constants,
+ * utility methods and classes, as well as a simple framework for
+ * helping to make sure that assertions failing in generated threads
+ * cause the associated test that generated them to itself fail (which
+ * JUnit doe not otherwise arrange). The rules for creating such
+ * tests are:
*
*
*
@@ -36,14 +37,13 @@ import java.io.*;
* - All delays and timeouts must use one of the constants {@link
* SHORT_DELAY_MS}, {@link SMALL_DELAY_MS}, {@link MEDIUM_DELAY_MS},
* {@link LONG_DELAY_MS}. The idea here is that a SHORT is always
- * discriminatable from zero time, and always allows enough time for
- * the small amounts of computation (creating a thread, calling a few
+ * discriminable from zero time, and always allows enough time for the
+ * small amounts of computation (creating a thread, calling a few
* methods, etc) needed to reach a timeout point. Similarly, a SMALL
* is always discriminable as larger than SHORT and smaller than
* MEDIUM. And so on. These constants are set to conservative values,
- * (100, 500, 1000, 5000 MS) but even so, if there is ever any doubt,
- * they can all be increased in one spot to rerun tests on slower
- * platforms
+ * but even so, if there is ever any doubt, they can all be increased
+ * in one spot to rerun tests on slower platforms
*
* - All threads generated must be joined inside each test case
* method (or fail to do so) before returning from the
@@ -54,15 +54,41 @@ import java.io.*;
*/
public class JSR166TestCase extends TestCase {
+ public static long SHORT_DELAY_MS;
+ public static long SMALL_DELAY_MS;
+ public static long MEDIUM_DELAY_MS;
+ public static long LONG_DELAY_MS;
+
+
+ /**
+ * Return the shortest timed delay. This could
+ * be reimplmented to use for example a Property.
+ */
+ protected long getShortDelay() {
+ return 100;
+ }
+
+
+ /**
+ * Set delays as multiples of SHORT_DELAY.
+ */
+ protected void setDelays() {
+ SHORT_DELAY_MS = getShortDelay();
+ SMALL_DELAY_MS = SHORT_DELAY_MS * 5;
+ MEDIUM_DELAY_MS = SHORT_DELAY_MS * 10;
+ LONG_DELAY_MS = SHORT_DELAY_MS * 50;
+ }
+
/**
* Flag set true if any threadAssert methods fail
*/
- protected volatile boolean threadFailed;
+ volatile boolean threadFailed;
/**
- * Initialize test to indicat that no thread assertions have failed
+ * Initialize test to indicate that no thread assertions have failed
*/
public void setUp() {
+ setDelays();
threadFailed = false;
}
@@ -73,35 +99,62 @@ public class JSR166TestCase extends Test
assertFalse(threadFailed);
}
+ /**
+ * Fail, also setting status to indicate current testcase should fail
+ */
public void threadFail(String reason) {
threadFailed = true;
fail(reason);
}
+ /**
+ * If expression not true, set status to indicate current testcase
+ * should fail
+ */
public void threadAssertTrue(boolean b) {
if (!b) {
threadFailed = true;
assertTrue(b);
}
}
+
+ /**
+ * If expression not false, set status to indicate current testcase
+ * should fail
+ */
public void threadAssertFalse(boolean b) {
if (b) {
threadFailed = true;
assertFalse(b);
}
}
+
+ /**
+ * If argument not null, set status to indicate current testcase
+ * should fail
+ */
public void threadAssertNull(Object x) {
if (x != null) {
threadFailed = true;
assertNull(x);
}
}
+
+ /**
+ * If arguments not equal, set status to indicate current testcase
+ * should fail
+ */
public void threadAssertEquals(long x, long y) {
if (x != y) {
threadFailed = true;
assertEquals(x, y);
}
}
+
+ /**
+ * If arguments not equal, set status to indicate current testcase
+ * should fail
+ */
public void threadAssertEquals(Object x, Object y) {
if (x != y && (x == null || !x.equals(y))) {
threadFailed = true;
@@ -110,6 +163,23 @@ public class JSR166TestCase extends Test
}
/**
+ * threadFail with message "should throw exception"
+ */
+ public void threadShouldThrow() {
+ threadFailed = true;
+ fail("should throw exception");
+ }
+
+ /**
+ * threadFail with message "Unexpected exception"
+ */
+ public void threadUnexpectedException() {
+ threadFailed = true;
+ fail("Unexpected exception");
+ }
+
+
+ /**
* Wait out termination of a thread pool or fail doing so
*/
public void joinPool(ExecutorService exec) {
@@ -117,101 +187,111 @@ public class JSR166TestCase extends Test
exec.shutdown();
assertTrue(exec.awaitTermination(LONG_DELAY_MS, TimeUnit.MILLISECONDS));
} catch(InterruptedException ie) {
- fail("unexpected exception");
+ fail("Unexpected exception");
}
}
- public static final long SHORT_DELAY_MS = 100;
- public static final long SMALL_DELAY_MS = 500;
- public static final long MEDIUM_DELAY_MS = 1000;
- public static final long LONG_DELAY_MS = 5000;
+
+ /**
+ * fail with message "should throw exception"
+ */
+ public void shouldThrow() {
+ fail("Should throw exception");
+ }
+
+ /**
+ * fail with message "Unexpected exception"
+ */
+ public void unexpectedException() {
+ fail("Unexpected exception");
+ }
/**
* The number of elements to place in collections, arrays, etc.
*/
- public static final int SIZE = 20;
+ static final int SIZE = 20;
// Some convenient Integer constants
- public static final Integer zero = new Integer(0);
- public static final Integer one = new Integer(1);
- public static final Integer two = new Integer(2);
- public static final Integer three = new Integer(3);
- public static final Integer four = new Integer(4);
- public static final Integer five = new Integer(5);
- public static final Integer six = new Integer(6);
- public static final Integer seven = new Integer(7);
- public static final Integer eight = new Integer(8);
- public static final Integer nine = new Integer(9);
- public static final Integer m1 = new Integer(-1);
- public static final Integer m2 = new Integer(-2);
- public static final Integer m3 = new Integer(-3);
- public static final Integer m4 = new Integer(-4);
- public static final Integer m5 = new Integer(-5);
- public static final Integer m10 = new Integer(-10);
+ static final Integer zero = new Integer(0);
+ static final Integer one = new Integer(1);
+ static final Integer two = new Integer(2);
+ static final Integer three = new Integer(3);
+ static final Integer four = new Integer(4);
+ static final Integer five = new Integer(5);
+ static final Integer six = new Integer(6);
+ static final Integer seven = new Integer(7);
+ static final Integer eight = new Integer(8);
+ static final Integer nine = new Integer(9);
+ static final Integer m1 = new Integer(-1);
+ static final Integer m2 = new Integer(-2);
+ static final Integer m3 = new Integer(-3);
+ static final Integer m4 = new Integer(-4);
+ static final Integer m5 = new Integer(-5);
+ static final Integer m10 = new Integer(-10);
// Some convenient Runnable classes
- public static class NoOpRunnable implements Runnable {
+ static class NoOpRunnable implements Runnable {
public void run() {}
}
- public static class NoOpCallable implements Callable {
+ static class NoOpCallable implements Callable {
public Object call() { return Boolean.TRUE; }
}
- public class ShortRunnable implements Runnable {
+ class ShortRunnable implements Runnable {
public void run() {
try {
Thread.sleep(SHORT_DELAY_MS);
}
catch(Exception e) {
- threadFail("unexpectedException");
+ threadUnexpectedException();
}
}
}
- public class ShortInterruptedRunnable implements Runnable {
+ class ShortInterruptedRunnable implements Runnable {
public void run() {
try {
Thread.sleep(SHORT_DELAY_MS);
- threadFail("should throw IE");
+ threadShouldThrow();
}
catch(InterruptedException success) {
}
}
}
- public class SmallRunnable implements Runnable {
+ class SmallRunnable implements Runnable {
public void run() {
try {
Thread.sleep(SMALL_DELAY_MS);
}
catch(Exception e) {
- threadFail("unexpectedException");
+ threadUnexpectedException();
}
}
}
- public class SmallCallable implements Callable {
+ class SmallCallable implements Callable {
public Object call() {
try {
Thread.sleep(SMALL_DELAY_MS);
}
catch(Exception e) {
- threadFail("unexpectedException");
+ threadUnexpectedException();
}
return Boolean.TRUE;
}
}
- public class SmallInterruptedRunnable implements Runnable {
+ class SmallInterruptedRunnable implements Runnable {
public void run() {
try {
Thread.sleep(SMALL_DELAY_MS);
- threadFail("should throw IE");
+ threadShouldThrow();
}
catch(InterruptedException success) {
}
@@ -219,29 +299,29 @@ public class JSR166TestCase extends Test
}
- public class MediumRunnable implements Runnable {
+ class MediumRunnable implements Runnable {
public void run() {
try {
Thread.sleep(MEDIUM_DELAY_MS);
}
catch(Exception e) {
- threadFail("unexpectedException");
+ threadUnexpectedException();
}
}
}
- public class MediumInterruptedRunnable implements Runnable {
+ class MediumInterruptedRunnable implements Runnable {
public void run() {
try {
Thread.sleep(MEDIUM_DELAY_MS);
- threadFail("should throw IE");
+ threadShouldThrow();
}
catch(InterruptedException success) {
}
}
}
- public class MediumPossiblyInterruptedRunnable implements Runnable {
+ class MediumPossiblyInterruptedRunnable implements Runnable {
public void run() {
try {
Thread.sleep(MEDIUM_DELAY_MS);
@@ -250,5 +330,45 @@ public class JSR166TestCase extends Test
}
}
}
+
+ /**
+ * For use as ThreadFactory in constructors
+ */
+ static class SimpleThreadFactory implements ThreadFactory{
+ public Thread newThread(Runnable r){
+ return new Thread(r);
+ }
+ }
+
+ static class TrackedRunnable implements Runnable {
+ volatile boolean done = false;
+ public void run() {
+ try {
+ Thread.sleep(SMALL_DELAY_MS);
+ done = true;
+ } catch(Exception e){
+ }
+ }
+ }
+
+ static class TrackedCallable implements Callable {
+ volatile boolean done = false;
+ public Object call() {
+ try {
+ Thread.sleep(SMALL_DELAY_MS);
+ done = true;
+ } catch(Exception e){
+ }
+ return Boolean.TRUE;
+ }
+ }
+
+ /**
+ * For use as RejectedExecutionHandler in constructors
+ */
+ static class NoOpREHandler implements RejectedExecutionHandler{
+ public void rejectedExecution(Runnable r, ThreadPoolExecutor executor){}
+ }
+
}