org.testng

Interface ISuite

All Superinterfaces:

IAttributes, Serializable

All Known Implementing Classes:

SuiteRunner

public interface ISuite
extends IAttributes

Interface defining a Test Suite.

Author:

Cedric Beust, Aug 6, 2004

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(ITestNGListener listener)
List<IInvokedMethod>	getAllInvokedMethods()
List<ITestNGMethod>	getAllMethods()
org.testng.internal.annotations.IAnnotationFinder	getAnnotationFinder()
Collection<ITestNGMethod>	getExcludedMethods()
String	getHost()
Collection<ITestNGMethod>	getInvokedMethods() Deprecated. Use getAllInvokedMthods().
Map<String,Collection<ITestNGMethod>>	getMethodsByGroups() Retrieves the map of groups and their associated test methods.
String	getName()
IObjectFactory	getObjectFactory()
IObjectFactory2	getObjectFactory2()
String	getOutputDirectory()
String	getParallel()
String	getParameter(String parameterName)
Map<String,ISuiteResult>	getResults()
SuiteRunState	getSuiteState() Retrieves the shared state for a suite.
XmlSuite	getXmlSuite()
void	run() Triggers the start of running tests included in the suite.

Methods inherited from interface org.testng.IAttributes

getAttribute, getAttributeNames, removeAttribute, setAttribute

Method Detail

getName

String getName()

Returns:

the name of this suite.

getResults

Map<String,ISuiteResult> getResults()

Returns:

The results for this suite.

getObjectFactory

IObjectFactory getObjectFactory()

Returns:

The object factory used to create all test instances.

getObjectFactory2

IObjectFactory2 getObjectFactory2()

getOutputDirectory

String getOutputDirectory()

Returns:

The output directory used for the reports.

getParallel

String getParallel()

Returns:

true if the tests must be run in parallel.

getParameter

String getParameter(String parameterName)

Returns:

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

getMethodsByGroups

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

Retrieves the map of groups and their associated test methods.

Returns:

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

getInvokedMethods

@Deprecated
Collection<ITestNGMethod> getInvokedMethods()

Deprecated. Use getAllInvokedMthods().

Retrieves the list of all the methods that were invoked during this run.

Returns:

a collection of ITestNGMethods belonging to all tests included in the suite.

getAllInvokedMethods

List<IInvokedMethod> getAllInvokedMethods()

Returns:

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

getExcludedMethods

Collection<ITestNGMethod> getExcludedMethods()

Returns:

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

run

void run()

Triggers the start of running tests included in the suite.

getHost

String getHost()

Returns:

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

getSuiteState

SuiteRunState getSuiteState()

Retrieves the shared state for a suite.

Returns:

the share state of the current suite.

getAnnotationFinder

org.testng.internal.annotations.IAnnotationFinder getAnnotationFinder()

Returns:

the annotation finder used for the specified type (JDK5 or javadoc)

getXmlSuite

XmlSuite getXmlSuite()

Returns:

The representation of the current XML suite file.

addListener

void addListener(ITestNGListener listener)

getAllMethods

List<ITestNGMethod> getAllMethods()

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.