org.testng.internal

Class Parameters

java.lang.Object

org.testng.internal.Parameters

public class Parameters
extends Object

Methods that bind parameters declared in testng.xml to actual values used to invoke methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Parameters.MethodParameters A parameter passing helper class.

Field Summary

Fields

Modifier and Type	Field and Description
static String	NULL_VALUE Deprecated.

Constructor Summary

Constructors

Constructor and Description
Parameters()

Method Summary

Modifier and Type	Method and Description
static Object[]	createConfigurationParameters(Method m, Map<String,String> params, Object[] parameterValues, ITestNGMethod currentTestMethod, IAnnotationFinder finder, XmlSuite xmlSuite, ITestContext ctx, ITestResult testResult) Creates the parameters needed for the specified @Configuration Method .
static Object[]	createInstantiationParameters(Constructor<?> ctor, String methodAnnotation, IAnnotationFinder finder, String[] parameterNames, Map<String,String> params, XmlSuite xmlSuite) Creates the parameters needed for constructing a test class instance.
static Object[]	getParametersFromIndex(Iterator<Object[]> parametersValues, int index)
static ParameterHolder	handleParameters(ITestObjectFactory objectFactory, ITestNGMethod testMethod, Map<String,String> allParameterNames, Object instance, Parameters.MethodParameters methodParams, XmlSuite xmlSuite, IAnnotationFinder annotationFinder, Object fedInstance, DataProviderHolder holder) If the method has parameters, fill them in.
static ParameterHolder	handleParameters(ITestObjectFactory objectFactory, ITestNGMethod testMethod, Map<String,String> allParameterNames, Object instance, Parameters.MethodParameters methodParams, XmlSuite xmlSuite, IAnnotationFinder annotationFinder, Object fedInstance, DataProviderHolder holder, String annotationName) If the method has parameters, fill them in.
static Object[]	injectParameters(Object[] parameterValues, Method method, ITestContext context) Gets an array of parameter values returned by data provider or the ones that are injected based on parameter type.

Methods inherited from class java.lang.Object

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

Field Detail

NULL_VALUE

@Deprecated
public static final String NULL_VALUE

Deprecated.

See Also:

Constant Field Values

Constructor Detail

Parameters

public Parameters()

Method Detail

createInstantiationParameters

public static Object[] createInstantiationParameters(Constructor<?> ctor,
                                                     String methodAnnotation,
                                                     IAnnotationFinder finder,
                                                     String[] parameterNames,
                                                     Map<String,String> params,
                                                     XmlSuite xmlSuite)

Creates the parameters needed for constructing a test class instance.

createConfigurationParameters

public static Object[] createConfigurationParameters(Method m,
                                                     Map<String,String> params,
                                                     Object[] parameterValues,
                                                     @Nullable
                                                     ITestNGMethod currentTestMethod,
                                                     IAnnotationFinder finder,
                                                     XmlSuite xmlSuite,
                                                     ITestContext ctx,
                                                     ITestResult testResult)

Creates the parameters needed for the specified @Configuration Method .

Parameters:

m - the configuraton method

currentTestMethod - the current @Test method or null if no @Test is available (this is not only in case the configuration method is a @Before/@AfterMethod

finder - the annotation finder

handleParameters

public static ParameterHolder handleParameters(ITestObjectFactory objectFactory,
                                               ITestNGMethod testMethod,
                                               Map<String,String> allParameterNames,
                                               Object instance,
                                               Parameters.MethodParameters methodParams,
                                               XmlSuite xmlSuite,
                                               IAnnotationFinder annotationFinder,
                                               Object fedInstance,
                                               DataProviderHolder holder)

If the method has parameters, fill them in. Either by using a @DataProvider if any was provided, or by looking up <parameters> in testng.xml

Returns:

An Iterator over the values for each parameter of this method.

handleParameters

public static ParameterHolder handleParameters(ITestObjectFactory objectFactory,
                                               ITestNGMethod testMethod,
                                               Map<String,String> allParameterNames,
                                               Object instance,
                                               Parameters.MethodParameters methodParams,
                                               XmlSuite xmlSuite,
                                               IAnnotationFinder annotationFinder,
                                               Object fedInstance,
                                               DataProviderHolder holder,
                                               String annotationName)

If the method has parameters, fill them in. Either by using a @DataProvider if any was provided, or by looking up <parameters> in testng.xml

Returns:

An Iterator over the values for each parameter of this method.

injectParameters

public static Object[] injectParameters(Object[] parameterValues,
                                        Method method,
                                        ITestContext context)
                                 throws TestNGException

Gets an array of parameter values returned by data provider or the ones that are injected based on parameter type. The method also checks for NoInjection annotation

Parameters:

parameterValues - parameter values from a data provider

method - method to be invoked

context - test context

Throws:

TestNGException

getParametersFromIndex

public static Object[] getParametersFromIndex(Iterator<Object[]> parametersValues,
                                              int index)