jtr.runners
Interface IRunner

All Superinterfaces:

IRunnerClean, IRunnerParameterized, IRunnerPooled, java.lang.Runnable

All Known Subinterfaces:

IRunnerJMS, IRunnerWs

All Known Implementing Classes:

AbstractJMSRunner, AbstractRunner, AbstractRunnerAncestor, AbstractWsRunner, JUnitFacadeRunner

public interface IRunner
extends IRunnerPooled

This interface represents a runner in its RUNNING state.
All the states in which a java.lang.Thread might be are now reachable from this state. Furthermore a RUNNING runner can go into the REQUIRES_NEW_PARAMETER state and become elegible for clean-up and re-parameterization.

Since:

1.0

Version:

5.0

Author:

Francesco Russo (frusso@dev.java.net)

Method Summary

IRunnerClean	clean() This method is invoked everytime an IRunner passes from its RUNNING state to the REQUIRES_NEW_PARAMETERS state. The concrete IRunner implementation is responsible for its own clean-up.
int	getFailures() Returns the number of total failures experienced by the runner.
int	getSuccesses() Returns the number of successes experienced by the runner.
void	receiveFailureNotification(java.lang.Throwable t, java.lang.String msg) Callback method for receiving notification of occourred errors.
void	test() This method starts the test logic.

Methods inherited from interface jtr.runners.IRunnerPooled

afterTest, beforeTest, cleanupResources, getPool, run

Methods inherited from interface jtr.runners.IRunnerParameterized

setPool

Methods inherited from interface jtr.runners.IRunnerClean

getCurrentRun, getDefaultName, getEnterprise, getEpoch, getFqn, getInstanceCount, getInstanceID, getName, getOutcomeFactory, getParameters, getParamsAssigner, getRuns, getSleepTime, getStatFunction, getTestOutcomeTable, setCurrentRun, setEnterprise, setEpoch, setFqn, setInstanceCount, setInstanceID, setName, setOutcomeFactory, setParameters, setParamsAssigner, setRuns, setSleepTime, setStatFunction, setTestCompletionListener, setTestOutcomeTable

Method Detail

test

void test()
          throws java.lang.Throwable

This method starts the test logic.

Throws:

java.lang.Throwable

getFailures

int getFailures()

Returns the number of total failures experienced by the runner.

Returns:

int

getSuccesses

int getSuccesses()

Returns the number of successes experienced by the runner.

Returns:

int

receiveFailureNotification

void receiveFailureNotification(java.lang.Throwable t,
                                java.lang.String msg)

Callback method for receiving notification of occourred errors.

Parameters:

t - Throwable

msg - String

clean

IRunnerClean clean()

This method is invoked everytime an IRunner passes from its RUNNING state to the REQUIRES_NEW_PARAMETERS state.
The concrete IRunner implementation is responsible for its own clean-up.

Returns:

IRunnerClean