Package org.testng

Class SuiteRunner

java.lang.Object

org.testng.SuiteRunner

All Implemented Interfaces:

IAttributes, ISuite, ISuiteRunnerListener

public class SuiteRunner
extends Object
implements ISuite, ISuiteRunnerListener

SuiteRunner is responsible for running all the tests included in one suite. The test start is triggered by run() method.

Constructor Summary

Constructors

Modifier	Constructor	Description
	SuiteRunner(IConfiguration configuration, XmlSuite suite, String outputDir, ITestRunnerFactory runnerFactory, boolean useDefaultListeners, Comparator<ITestNGMethod> comparator)
protected	SuiteRunner(IConfiguration configuration, XmlSuite suite, String outputDir, ITestRunnerFactory runnerFactory, boolean useDefaultListeners, List<IMethodInterceptor> methodInterceptors, Collection<IInvokedMethodListener> invokedMethodListener, org.testng.SuiteRunner.TestListenersContainer container, Collection<IClassListener> classListeners, DataProviderHolder holder, Comparator<ITestNGMethod> comparator)
	SuiteRunner(IConfiguration configuration, XmlSuite suite, String outputDir, ITestRunnerFactory runnerFactory, Comparator<ITestNGMethod> comparator)

Method Summary

Modifier and Type	Method	Description
protected void	addListener(ISuiteListener reporter)
void	addListener(ITestNGListener listener)
void	afterInvocation(IInvokedMethod method, ITestResult testResult)
void	beforeInvocation(IInvokedMethod method, ITestResult testResult)
List<IInvokedMethod>	getAllInvokedMethods()
List<ITestNGMethod>	getAllMethods()
IAnnotationFinder	getAnnotationFinder()	Returns the annotation finder for the given annotation type.
Object	getAttribute(String name)
Set<String>	getAttributeNames()
Collection<IDataProviderListener>	getDataProviderListeners()
Collection<ITestNGMethod>	getExcludedMethods()
ITestListener	getExitCodeListener()
String	getGuiceStage()
String	getHost()
Map<String,Collection<ITestNGMethod>>	getMethodsByGroups()	Retrieves the map of groups and their associated test methods.
String	getName()
ITestObjectFactory	getObjectFactory()
String	getOutputDirectory()
String	getParallel()
String	getParameter(String parameterName)	FIXME: should be removed?
com.google.inject.Injector	getParentInjector()
String	getParentModule()
List<IReporter>	getReporters()
Map<String,ISuiteResult>	getResults()
SuiteRunState	getSuiteState()	Retrieves the shared state for a suite.
XmlSuite	getXmlSuite()
Object	removeAttribute(String name)	Remove the attribute
void	run()	Triggers the start of running tests included in the suite.
void	setAttribute(String name, Object value)	Set a custom attribute.
void	setHost(String host)
void	setObjectFactory(ITestObjectFactory objectFactory)
void	setParentInjector(com.google.inject.Injector injector)
void	setReportResults(boolean reportResults)
void	setSkipFailedInvocationCounts(Boolean skipFailedInvocationCounts)

Methods inherited from class java.lang.Object

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

Constructor Details

SuiteRunner

public SuiteRunner(IConfiguration configuration,
 XmlSuite suite,
 String outputDir,
 ITestRunnerFactory runnerFactory,
 Comparator<ITestNGMethod> comparator)

SuiteRunner

public SuiteRunner(IConfiguration configuration,
 XmlSuite suite,
 String outputDir,
 ITestRunnerFactory runnerFactory,
 boolean useDefaultListeners,
 Comparator<ITestNGMethod> comparator)

SuiteRunner

protected SuiteRunner(IConfiguration configuration,
 XmlSuite suite,
 String outputDir,
 ITestRunnerFactory runnerFactory,
 boolean useDefaultListeners,
 List<IMethodInterceptor> methodInterceptors,
 Collection<IInvokedMethodListener> invokedMethodListener,
 org.testng.SuiteRunner.TestListenersContainer container,
 Collection<IClassListener> classListeners,
 DataProviderHolder holder,
 Comparator<ITestNGMethod> comparator)

Method Details

getXmlSuite

public XmlSuite getXmlSuite()

Specified by:

getXmlSuite in interface ISuite

Returns:

The representation of the current XML suite file.

getName

public String getName()

Specified by:

getName in interface ISuite

Returns:

the name of this suite.

setObjectFactory

public void setObjectFactory(ITestObjectFactory objectFactory)

setReportResults

public void setReportResults(boolean reportResults)

getExitCodeListener

public ITestListener getExitCodeListener()

Specified by:

getExitCodeListener in interface ISuiteRunnerListener

getParallel

public String getParallel()

Specified by:

getParallel in interface ISuite

Returns:

true if the tests must be run in parallel.

getParentModule

public String getParentModule()

Specified by:

getParentModule in interface ISuite

getGuiceStage

public String getGuiceStage()

Specified by:

getGuiceStage in interface ISuite

getParentInjector

public com.google.inject.Injector getParentInjector()

Specified by:

getParentInjector in interface ISuite

setParentInjector

public void setParentInjector(com.google.inject.Injector injector)

Specified by:

setParentInjector in interface ISuite

run

public void run()

Description copied from interface: ISuite

Triggers the start of running tests included in the suite.

Specified by:

run in interface ISuite

getReporters

public List<IReporter> getReporters()

getDataProviderListeners

public Collection<IDataProviderListener> getDataProviderListeners()

addListener

protected void addListener(ISuiteListener reporter)

Parameters:

reporter - The ISuiteListener interested in reporting the result of the current suite.

addListener

public void addListener(ITestNGListener listener)

Specified by:

addListener in interface ISuite

getOutputDirectory

public String getOutputDirectory()

Specified by:

getOutputDirectory in interface ISuite

Returns:

The output directory used for the reports.

getResults

public Map<String,ISuiteResult> getResults()

Specified by:

getResults in interface ISuite

Returns:

The results for this suite.

getParameter

public String getParameter(String parameterName)

FIXME: should be removed?

Specified by:

getParameter in interface ISuite

Parameters:

parameterName - The name of the parameter

Returns:

The value of this parameter, or null if none was specified.

See Also:

• ISuite.getParameter(java.lang.String)

getMethodsByGroups

public Map<String,Collection<ITestNGMethod>> getMethodsByGroups()

Description copied from interface: ISuite

Retrieves the map of groups and their associated test methods.

Specified by:

getMethodsByGroups in interface ISuite

Returns:

A map where the key is the group and the value is a list of methods used by this group.

See Also:

• ISuite.getMethodsByGroups()

getExcludedMethods

public Collection<ITestNGMethod> getExcludedMethods()

Specified by:

getExcludedMethods in interface ISuite

Returns:

All the methods that were not included in this test run.

See Also:

• ISuite.getExcludedMethods()

getObjectFactory

public ITestObjectFactory getObjectFactory()

Specified by:

getObjectFactory in interface ISuite

Returns:

The object factory used to create all test instances.

getAnnotationFinder

public IAnnotationFinder getAnnotationFinder()

Returns the annotation finder for the given annotation type.

Specified by:

getAnnotationFinder in interface ISuite

Returns:

the annotation finder for the given annotation type.

setHost

public void setHost(String host)

getHost

public String getHost()

Specified by:

getHost in interface ISuite

Returns:

The host where this suite was run, or null if it was run locally. The returned string has the form: host:port

getSuiteState

public SuiteRunState getSuiteState()

Description copied from interface: ISuite

Retrieves the shared state for a suite.

Specified by:

getSuiteState in interface ISuite

Returns:

the share state of the current suite.

See Also:

• ISuite.getSuiteState()

setSkipFailedInvocationCounts

public void setSkipFailedInvocationCounts(Boolean skipFailedInvocationCounts)

getAttribute

public Object getAttribute(String name)

Specified by:

getAttribute in interface IAttributes

Parameters:

name - The name of the attribute to return

Returns:

The attribute

setAttribute

public void setAttribute(String name,
 Object value)

Description copied from interface: IAttributes

Set a custom attribute.

Specified by:

setAttribute in interface IAttributes

Parameters:

name - The attribute name

value - The attribute value

getAttributeNames

public Set<String> getAttributeNames()

Specified by:

getAttributeNames in interface IAttributes

Returns:

all the attributes names.

removeAttribute

public Object removeAttribute(String name)

Description copied from interface: IAttributes

Remove the attribute

Specified by:

removeAttribute in interface IAttributes

Parameters:

name - The attribute name

Returns:

the attribute value if found, null otherwise

afterInvocation

public void afterInvocation(IInvokedMethod method,
 ITestResult testResult)

Specified by:

afterInvocation in interface ISuiteRunnerListener

beforeInvocation

public void beforeInvocation(IInvokedMethod method,
 ITestResult testResult)

Specified by:

beforeInvocation in interface ISuiteRunnerListener

getAllInvokedMethods

public List<IInvokedMethod> getAllInvokedMethods()

Specified by:

getAllInvokedMethods in interface ISuite

Returns:

a list of all the methods that were invoked in this suite.

getAllMethods

public List<ITestNGMethod> getAllMethods()

Specified by:

getAllMethods in interface ISuite

Returns:

the total number of methods found in this suite. The presence of factories or data providers might cause the actual number of test methods run be bigger than this list.