Package org.testng.internal.invokers

Class TestInvoker

java.lang.Object

org.testng.internal.invokers.BaseInvoker

org.testng.internal.invokers.TestInvoker

All Implemented Interfaces:

ITestInvoker

class TestInvoker
extends BaseInvoker
implements ITestInvoker

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	TestInvoker.MethodInvocationAgent
private static class	TestInvoker.StatusHolder

Nested classes/interfaces inherited from interface org.testng.internal.invokers.ITestInvoker

ITestInvoker.FailureContext

Field Summary

Fields

Modifier and Type	Field	Description
private final DataProviderHolder	holder
private final ConfigInvoker	invoker
private final List<IClassListener>	m_classListeners
private final boolean	m_skipFailedInvocationCounts

Fields inherited from class org.testng.internal.invokers.BaseInvoker

m_classInvocationResults, m_configuration, m_notifier, m_suiteState, m_testContext, NULL_OBJECT

Constructor Summary

Constructors

Constructor	Description
TestInvoker(ITestResultNotifier m_notifier, ITestContext m_testContext, SuiteRunState m_suiteState, IConfiguration m_configuration, Collection<IInvokedMethodListener> m_invokedMethodListeners, DataProviderHolder holder, List<IClassListener> m_classListeners, boolean m_skipFailedInvocationCounts, ConfigInvoker invoker, SuiteRunner suiteRunner)

Method Summary

Modifier and Type	Method	Description
private DataProviderHolder	buildDataProviderHolder()
private String	checkDependencies(ITestNGMethod testMethod)	Checks to see of the test method has certain dependencies that prevents TestNG from executing it
private static void	cleanInterruptStatus()
private void	collectResults(ITestNGMethod testMethod, ITestResult result)
private TestInvoker.StatusHolder	considerExceptions(ITestNGMethod tm, ITestResult testResult, ExpectedExceptionsHolder exceptionsHolder, ITestInvoker.FailureContext failure)
private Collection<IDataProviderListener>	dataProviderListeners()
private boolean	failuresPresentInUpstreamDependency(ITestNGMethod testMethod, ITestNGMethod[] methods)
ITestResultNotifier	getNotifier()
private void	handleInvocationResult(ITestNGMethod testMethod, ITestResult testResult, ITestInvoker.FailureContext failure, TestInvoker.StatusHolder holder, boolean willRetry)
void	invokeListenersForSkippedTestResult(ITestResult r, IInvokedMethod invokedMethod)
private ITestResult	invokeMethod(TestMethodArguments arguments, XmlSuite suite, ITestInvoker.FailureContext failureContext)
private List<ITestResult>	invokePooledTestMethods(ITestNGMethod testMethod, Map<String,String> parameters, ConfigurationGroupMethods groupMethods, ITestContext testContext)	Invokes a method that has a specified threadPoolSize.
ITestResult	invokeTestMethod(TestMethodArguments arguments, XmlSuite suite, ITestInvoker.FailureContext failureContext)	invokeTestMethods() eventually converge here to invoke a single @Test method.
List<ITestResult>	invokeTestMethods(ITestNGMethod testMethod, ConfigurationGroupMethods groupMethods, Object instance, ITestContext context)
private Set<ITestResult>	keepSameInstances(ITestNGMethod method, Set<ITestResult> results)
ITestResult	registerSkippedTestResult(ITestNGMethod testMethod, long start, Throwable throwable, ITestResult source)
ITestInvoker.FailureContext	retryFailed(TestMethodArguments arguments, List<ITestResult> result, int failureCount, ITestContext testContext)
private void	runAfterConfigurations(TestMethodArguments arguments, XmlSuite suite, TestResult testResult)
private void	runAfterGroupsConfigurations(TestMethodArguments arguments)
private void	runConfigMethods(TestMethodArguments arguments, XmlSuite suite, TestResult testResult, ITestNGMethod[] teardownConfigMethods)
void	runTestResultListener(ITestResult tr)
private List<ITestResult>	runWorkers(ITestNGMethod testMethod, List<IWorker<ITestNGMethod>> workers, int threadPoolSize, ConfigurationGroupMethods groupMethods, Map<String,String> parameters)	To reduce thread contention and also to correctly handle thread-confinement this method invokes the @BeforeGroups and @AfterGroups corresponding to the current @Test method.
private static void	setTestStatus(ITestResult result, int status)
private boolean	shouldRetryTestMethod(ITestNGMethod testMethod, ITestResult testResult, ITestInvoker.FailureContext failure, TestInvoker.StatusHolder holder)
private static void	updateStatusHolderAccordingToTestResult(ITestResult testResult, TestInvoker.StatusHolder holder)

Methods inherited from class org.testng.internal.invokers.BaseInvoker

annotationFinder, handleException, isSkipExceptionAndSkip, log, runInvokedMethodListeners

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.testng.internal.invokers.ITestInvoker

getRunner, registerSkippedTestResult

Field Details

invoker

private final ConfigInvoker invoker

holder

private final DataProviderHolder holder

m_classListeners

private final List<IClassListener> m_classListeners

m_skipFailedInvocationCounts

private final boolean m_skipFailedInvocationCounts

Constructor Details

TestInvoker

public TestInvoker(ITestResultNotifier m_notifier,
 ITestContext m_testContext,
 SuiteRunState m_suiteState,
 IConfiguration m_configuration,
 Collection<IInvokedMethodListener> m_invokedMethodListeners,
 DataProviderHolder holder,
 List<IClassListener> m_classListeners,
 boolean m_skipFailedInvocationCounts,
 ConfigInvoker invoker,
 SuiteRunner suiteRunner)

Method Details

getNotifier

public ITestResultNotifier getNotifier()

Specified by:

getNotifier in interface ITestInvoker

invokeTestMethods

public List<ITestResult> invokeTestMethods(ITestNGMethod testMethod,
 ConfigurationGroupMethods groupMethods,
 Object instance,
 ITestContext context)

Specified by:

invokeTestMethods in interface ITestInvoker

invokeTestMethod

public ITestResult invokeTestMethod(TestMethodArguments arguments,
 XmlSuite suite,
 ITestInvoker.FailureContext failureContext)

invokeTestMethods() eventually converge here to invoke a single @Test method.

This method is responsible for actually invoking the method. It decides if the invocation must be done:

• through an IHookable
• directly (through reflection)
• in a separate thread (in case it needs to timeout)

This method is also responsible for invoking @BeforeGroup, @BeforeMethod, @AfterMethod, @AfterGroup if it is the case for the passed in @Test method.

Specified by:

invokeTestMethod in interface ITestInvoker

retryFailed

public ITestInvoker.FailureContext retryFailed(TestMethodArguments arguments,
 List<ITestResult> result,
 int failureCount,
 ITestContext testContext)

Specified by:

retryFailed in interface ITestInvoker

runTestResultListener

public void runTestResultListener(ITestResult tr)

Specified by:

runTestResultListener in interface ITestInvoker

dataProviderListeners

private Collection<IDataProviderListener> dataProviderListeners()

buildDataProviderHolder

private DataProviderHolder buildDataProviderHolder()

checkDependencies

private String checkDependencies(ITestNGMethod testMethod)

Checks to see of the test method has certain dependencies that prevents TestNG from executing it

Parameters:

testMethod - test method being checked for

Returns:

error message or null if dependencies have been run successfully

runWorkers

private List<ITestResult> runWorkers(ITestNGMethod testMethod,
 List<IWorker<ITestNGMethod>> workers,
 int threadPoolSize,
 ConfigurationGroupMethods groupMethods,
 Map<String,String> parameters)

To reduce thread contention and also to correctly handle thread-confinement this method invokes the @BeforeGroups and @AfterGroups corresponding to the current @Test method.

failuresPresentInUpstreamDependency

private boolean failuresPresentInUpstreamDependency(ITestNGMethod testMethod,
 ITestNGMethod[] methods)

keepSameInstances

private Set<ITestResult> keepSameInstances(ITestNGMethod method,
 Set<ITestResult> results)

Returns:

the test results that apply to one of the instances of the testMethod.

invokePooledTestMethods

private List<ITestResult> invokePooledTestMethods(ITestNGMethod testMethod,
 Map<String,String> parameters,
 ConfigurationGroupMethods groupMethods,
 ITestContext testContext)

Invokes a method that has a specified threadPoolSize.

collectResults

private void collectResults(ITestNGMethod testMethod,
 ITestResult result)

invokeListenersForSkippedTestResult

public void invokeListenersForSkippedTestResult(ITestResult r,
 IInvokedMethod invokedMethod)

Specified by:

invokeListenersForSkippedTestResult in interface ITestInvoker

setTestStatus

private static void setTestStatus(ITestResult result,
 int status)

handleInvocationResult

private void handleInvocationResult(ITestNGMethod testMethod,
 ITestResult testResult,
 ITestInvoker.FailureContext failure,
 TestInvoker.StatusHolder holder,
 boolean willRetry)

shouldRetryTestMethod

private boolean shouldRetryTestMethod(ITestNGMethod testMethod,
 ITestResult testResult,
 ITestInvoker.FailureContext failure,
 TestInvoker.StatusHolder holder)

invokeMethod

private ITestResult invokeMethod(TestMethodArguments arguments,
 XmlSuite suite,
 ITestInvoker.FailureContext failureContext)

cleanInterruptStatus

private static void cleanInterruptStatus()

runAfterConfigurations

private void runAfterConfigurations(TestMethodArguments arguments,
 XmlSuite suite,
 TestResult testResult)

runAfterGroupsConfigurations

private void runAfterGroupsConfigurations(TestMethodArguments arguments)

runConfigMethods

private void runConfigMethods(TestMethodArguments arguments,
 XmlSuite suite,
 TestResult testResult,
 ITestNGMethod[] teardownConfigMethods)

registerSkippedTestResult

public ITestResult registerSkippedTestResult(ITestNGMethod testMethod,
 long start,
 Throwable throwable,
 ITestResult source)

Specified by:

registerSkippedTestResult in interface ITestInvoker

considerExceptions

private TestInvoker.StatusHolder considerExceptions(ITestNGMethod tm,
 ITestResult testResult,
 ExpectedExceptionsHolder exceptionsHolder,
 ITestInvoker.FailureContext failure)

updateStatusHolderAccordingToTestResult

private static void updateStatusHolderAccordingToTestResult(ITestResult testResult,
 TestInvoker.StatusHolder holder)