junitExt

Class MultiThreadedTestRunner

java.lang.Object

junitExt.MultiThreadedTestRunner

public class MultiThreadedTestRunner
extends Object

A framework which allows for an array of tests to be run asynchronously. TestCases should reference this class in a test method.

Update for July 9, 2003: now, you can also register TestRunnable instances as monitors (request 771008); these run parallel with the standard TestRunnable instances, but they only quit when all of the standard TestRunnable instances end.

Fixed bugs 771000 and 771001: spawned threads are now Daemon threads, and all "wild threads" (threads that just won't stop) are Thread.stop()ed.

All these changes have made this class rather fragile, as there are many threaded timing issues to deal with. Expect future refactoring with backwards compatibility.

Since:

Jan 14, 2002

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MultiThreadedTestRunner.TestDeathException An exception that declares that the test has been stop()ed.

Constructor Summary

Constructors

Constructor and Description
MultiThreadedTestRunner(TestRunnable[] tr) Create a new utility instance with the given set of parallel runners.
MultiThreadedTestRunner(TestRunnable[] runners, TestRunnable[] monitors) Create a new utility instance with the given set of parallel runners and a set of monitors.

Method Summary

Modifier and Type	Method and Description
void	runTestRunnables() Run each test given in a separate thread.
void	runTestRunnables(long maxTime) Runs each test given in a separate thread.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultiThreadedTestRunner

public MultiThreadedTestRunner(TestRunnable[] tr)

Create a new utility instance with the given set of parallel runners. All runners passed into this method must end on their own, else it's an error.

MultiThreadedTestRunner

public MultiThreadedTestRunner(TestRunnable[] runners,
                               TestRunnable[] monitors)

Create a new utility instance with the given set of parallel runners and a set of monitors. The runners must end on their own, but the monitors can run until told to stop.

Parameters:

runners - a non-null, non-empty collection of test runners.

monitors - a list of monitor runners, which may be null or empty.

Method Detail

runTestRunnables

public void runTestRunnables()
                      throws Throwable

Run each test given in a separate thread. Wait for each thread to finish running, then return.

As of July 9, 2003, this method will not wait forever, but rather will wait for the internal maximum run time, which is by default 24 hours; for most unit testing scenarios, this is more than sufficient.

Throws:

Throwable - thrown on a test run if a threaded task throws an exception.

runTestRunnables

public void runTestRunnables(long maxTime)
                      throws Throwable

Runs each test given in a separate thread. Waits for each thread to finish running (possibly killing them), then returns.

Parameters:

runnables - the list of TestCaseRunnable objects to run asynchronously

maxTime - the maximum amount of milliseconds to wait for the tests to run. If the time is <= 0, then the tests will run until they are complete. Otherwise, any threads that don't complete by the given number of milliseconds will be killed, and a failure will be thrown.

Throws:

Throwable - thrown from the underlying tests if they happen to cause an error.