org.evosuite.testcase.execution

Class TestRunnable

java.lang.Object

org.evosuite.testcase.execution.TestRunnable

All Implemented Interfaces:

Callable<ExecutionResult>, InterfaceTestRunnable

public class TestRunnable
extends Object
implements InterfaceTestRunnable

TestRunnable class.

Author:

Gordon Fraser

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<Integer,Throwable>	exceptionsThrown Map a thrown exception ('value') with the the position ('key') in the test sequence in which it was thrown from.
protected Set<ExecutionObserver>	observers
protected boolean	runFinished
protected ThreadStopper	threadStopper

Constructor Summary

Constructors

Constructor and Description
TestRunnable(TestCase tc, Scope scope, Set<ExecutionObserver> observers) Constructor for TestRunnable.

Method Summary

Modifier and Type	Method and Description
ExecutionResult	call()
Map<Integer,Throwable>	getExceptionsThrown() getExceptionsThrown
protected void	informObservers_after(Statement s, Throwable exceptionThrown) Inform all observers that input statement has been executed
protected void	informObservers_before(Statement s) Inform all observers that we are going to execute the input statement
protected void	informObservers_finished(ExecutionResult result)
boolean	isRunFinished() isRunFinished
void	killAndJoinClientThreads() Try to kill (and then join) the SUT threads.
void	storeCurrentThreads() After the test case is executed, if any SUT thread is still running, we will wait for their termination.

Methods inherited from class java.lang.Object

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

Field Detail

runFinished

protected boolean runFinished

exceptionsThrown

protected Map<Integer,Throwable> exceptionsThrown

Map a thrown exception ('value') with the the position ('key') in the test sequence in which it was thrown from.

observers

protected Set<ExecutionObserver> observers

threadStopper

protected final ThreadStopper threadStopper

Constructor Detail

TestRunnable

public TestRunnable(TestCase tc,
                    Scope scope,
                    Set<ExecutionObserver> observers)

Constructor for TestRunnable.

Parameters:

tc - a TestCase object.

scope - a Scope object.

observers - a Set object.

Method Detail

storeCurrentThreads

public void storeCurrentThreads()

After the test case is executed, if any SUT thread is still running, we will wait for their termination. To identify which thread belong to SUT, before test case execution we should check which are the threads that are running.

WARNING: The sandbox might prevent accessing thread informations, so best to call this method from outside this class

killAndJoinClientThreads

public void killAndJoinClientThreads()
                              throws IllegalStateException

Try to kill (and then join) the SUT threads. Killing the SUT threads is important, because some spawn threads could just wait on objects/locks, and so make the test case executions always last TIMEOUT ms.

Throws:

IllegalStateException

informObservers_before

protected void informObservers_before(Statement s)

Inform all observers that we are going to execute the input statement

Parameters:

s - the statement to execute

informObservers_after

protected void informObservers_after(Statement s,
                                     Throwable exceptionThrown)

Inform all observers that input statement has been executed

Parameters:

s - the executed statement

exceptionThrown - the exception thrown when executing the statement, if any (can be null)

informObservers_finished

protected void informObservers_finished(ExecutionResult result)

call

public ExecutionResult call()

Specified by:

call in interface Callable<ExecutionResult>

getExceptionsThrown

public Map<Integer,Throwable> getExceptionsThrown()

getExceptionsThrown

Specified by:

getExceptionsThrown in interface InterfaceTestRunnable

Returns:

a Map object.

isRunFinished

public boolean isRunFinished()

isRunFinished

Specified by:

isRunFinished in interface InterfaceTestRunnable

Returns:

a boolean.