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

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)
com.google.inject.Injector	getParentInjector()
String	getParentModule()
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.
void	setParentInjector(com.google.inject.Injector injector)

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.

getParentModule

String getParentModule()

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)

getParentInjector

com.google.inject.Injector getParentInjector()

setParentInjector

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

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.