auxtestlib

Class AbstractControlledThread

java.lang.Object

java.lang.Thread

auxtestlib.AbstractControlledThread

All Implemented Interfaces:

Runnable

Direct Known Subclasses:

ControlledThread

public abstract class AbstractControlledThread
extends Thread

Class implementing a thread with a myRun method which can throw exceptions. The thread will keep any exception thrown and provides some additional features.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
AbstractControlledThread() Creates a new thread.

Method Summary

Modifier and Type	Method and Description
Throwable	get_death_exception() Obtains the throwable that killed the thread.
static void	invoke_all(AbstractControlledThread[] threads) Calls the invoke() method on all threads in the array.
Object	invoke() Simulates a thread "invocation" starting the thread, if it has not yet started and waiting for the thread to die, returning the thread's return value.
abstract Object	my_run() Method that will perform the thread's work.
Object	result() Obtains the execution result (the value returned by my_run)
void	run() run method: just wraps myRun.
static void	start_all(AbstractControlledThread[] threads) Starts all threads in an array.
void	wait_for_end() Waits for the thread to die (or for an interrupt).

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractControlledThread

public AbstractControlledThread()

Creates a new thread.

Method Detail

run

public final void run()

run method: just wraps myRun.

Specified by:

run in interface Runnable

Overrides:

run in class Thread

my_run

public abstract Object my_run()
                       throws Exception

Method that will perform the thread's work.

Returns:

Object any return value that may be useful

Throws:

Exception - execution failed

get_death_exception

public Throwable get_death_exception()

Obtains the throwable that killed the thread.

Returns:

the throwable or null if none

result

public Object result()

Obtains the execution result (the value returned by my_run)

Returns:

the execution result or null if the thread failed with an exception or has not finished yet

wait_for_end

public void wait_for_end()

Waits for the thread to die (or for an interrupt). If the thread hasn't yet started, it will wait for the thread to start and then for it to die.

invoke

public Object invoke()
              throws Exception

Simulates a thread "invocation" starting the thread, if it has not yet started and waiting for the thread to die, returning the thread's return value. If the thread dies with an exception, the exception is thrown by this method too.

Returns:

the thread's return value

Throws:

Exception - the exception thrown by the thread

start_all

public static void start_all(AbstractControlledThread[] threads)

Starts all threads in an array.

Parameters:

threads - the array of threads to start

invoke_all

public static void invoke_all(AbstractControlledThread[] threads)
                       throws Exception

Calls the invoke() method on all threads in the array. If one of the methods fail with an exception, the exception is thrown. If more than one method fails with an exception, one of the exceptions is thrown and the others suppressed.

Parameters:

threads - the thread array

Throws:

Exception - at least one threads failed. This is the exception thrown by the thread