Modifier and Type	Class and Description
pack-priv static class	Parameters.FilterOutInjectedTypesResult Store the result of parameterTypes and optionalValues after filter out injected types
public static class	Parameters.MethodParameters A parameter passing helper class.

Modifier and Type	Field and Description
private static final List<Class<? extends Annotation>>	annotationList
private static final List<Class<?>>	INJECTED_TYPES
private static final Map<String, List<Class<?>>>	mapping

Access	Constructor and Description
public	Parameters()

Method Summary

Modifier and Type	Method and Description
private static boolean	areAllOptionalValuesNull(String[] optionalValues)
private static boolean	canInject(String annotation)
private static void	checkParameterTypes(String methodName, Class<?>[] parameterTypes, String methodAnnotation, String[] parameterNames)
public static Object[]	createConfigurationParameters(Method the configuraton method m, Map<String, String> params, Object[] parameterValues, ITestNGMethod the current @Test method or `null` if no @Test is available (this is not only in case the configuration method is a @Before/@AfterMethod currentTestMethod, IAnnotationFinder the annotation finder finder, XmlSuite xmlSuite, ITestContext ctx, ITestResult testResult) Creates the parameters needed for the specified `@Configuration` `Method` .
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.
private static Object[]	createParameters(ConstructorOrMethod m, Parameters.MethodParameters params, IAnnotationFinder finder, XmlSuite xmlSuite, String atName)
private static Object[]	createParametersForConstructor(Constructor<?> constructor, Class<?>[] parameterTypes, String[] optionalValues, String methodAnnotation, String[] parameterNames, Parameters.MethodParameters params, XmlSuite xmlSuite)
private static Object[]	Returns: An array of parameters suitable to invoke this method, possibly picked from the property file createParametersForMethod(ConstructorOrMethod method, Class<?>[] parameterTypes, String[] optionalValues, String methodAnnotation, String[] parameterNames, Parameters.MethodParameters params, XmlSuite xmlSuite)
private static List<Object>	createParams(String name, String prefix, String methodAnnotation, Class<?>[] parameterTypes, String[] optionalValues, String[] parameterNames, Parameters.MethodParameters params, XmlSuite xmlSuite)
private static String[]	extractOptionalValues(IAnnotationFinder finder, ConstructorOrMethod consMethod)
private static Parameter[]	extractParameters(ConstructorOrMethod method)
pack-priv static Parameters.FilterOutInjectedTypesResult	Returns: FilterOutInjectedTypesResult filterOutInjectedTypesFromOptionalValues(Class<?>[] - The parameter types to be used parameterTypes, String[] - The optional values to be considered. optionalValues) Remove injected types from parameterTypes and optionalValues
private static IDataProviderMethod	findDataProvider(ITestObjectFactory objectFactory, Object instance, ITestClass clazz, ConstructorOrMethod m, IAnnotationFinder finder, ITestContext context)
private static IDataProviderMethod	findDataProvider(ITestObjectFactory objectFactory, Object instance, ITestClass clazz, IAnnotationFinder finder, String name, Class<?> dataProviderClass, boolean isDynamicDataProvider, ITestContext context) Find a method that has a @DataProvider(name=name)
private static IDataProvidable	findDataProviderInfo(ITestClass clazz, ConstructorOrMethod m, IAnnotationFinder finder) Find the data provider info (data provider name and class) on either @Test(dataProvider), `@Factory(dataProvider)` on a method or @Factory(dataProvider) on a constructor.
private static String	getDataProviderName(IDataProviderAnnotation dp, Method m)
public static ParameterHolder	Returns: An Iterator over the values for each parameter of this method. 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
public static ParameterHolder	Returns: An Iterator over the values for each parameter of this method. 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
public static Object[]	injectParameters(Object[] parameter values from a data provider parameterValues, Method method to be invoked method, ITestContext test context context) Gets an array of parameter values returned by data provider or the ones that are injected based on parameter type.
private static boolean	isDataProviderClassEmpty(ITestAnnotation annotation)
private static boolean	isDataProviderNameEmpty(ITestAnnotation annotation)
private static boolean	isDynamicDataProviderClassEmpty(ITestAnnotation annotation)
private static IDataProvidable	merge(ITestAnnotation methodLevel, ITestAnnotation classLevel)
private static String	prettyFormat(List<Class<?>> classes)
private static Class<? extends Annotation>	retrieveConfigAnnotation(Method m)
private static boolean	validParameters(String methodAnnotation, Class<?>[] parameterTypes)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

annotationList	back to summary
private static final List<Class<? extends Annotation>> annotationList

INJECTED_TYPES	back to summary
private static final List<Class<?>> INJECTED_TYPES

mapping	back to summary
private static final Map<String, List<Class<?>>> mapping

Constructor Detail

Parameters	back to summary
public Parameters()

Method Detail

areAllOptionalValuesNull	back to summary
private static boolean areAllOptionalValuesNull(String[] optionalValues)

canInject	back to summary
private static boolean canInject(String annotation)

checkParameterTypes	back to summary
private static void checkParameterTypes(String methodName, Class<?>[] parameterTypes, String methodAnnotation, String[] parameterNames)

createConfigurationParameters back to summary

createConfigurationParameters	back to summary
public 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` . Parameters m:Method the configuraton method currentTestMethod:ITestNGMethod 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:IAnnotationFinder the annotation finder

public 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 .

Parameters

m:Method: the configuraton method
currentTestMethod:ITestNGMethod: 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:IAnnotationFinder: the annotation finder

createInstantiationParameters	back to summary
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.

createParameters	back to summary
private static Object[] createParameters(ConstructorOrMethod m, Parameters.MethodParameters params, IAnnotationFinder finder, XmlSuite xmlSuite, String atName)

createParametersForConstructor	back to summary
private static Object[] createParametersForConstructor(Constructor<?> constructor, Class<?>[] parameterTypes, String[] optionalValues, String methodAnnotation, String[] parameterNames, Parameters.MethodParameters params, XmlSuite xmlSuite)

createParametersForMethod	back to summary
private static Object[] createParametersForMethod(ConstructorOrMethod method, Class<?>[] parameterTypes, String[] optionalValues, String methodAnnotation, String[] parameterNames, Parameters.MethodParameters params, XmlSuite xmlSuite) Returns:Object[] An array of parameters suitable to invoke this method, possibly picked from the property file

createParams	back to summary
private static List<Object> createParams(String name, String prefix, String methodAnnotation, Class<?>[] parameterTypes, String[] optionalValues, String[] parameterNames, Parameters.MethodParameters params, XmlSuite xmlSuite)

extractOptionalValues	back to summary
private static String[] extractOptionalValues(IAnnotationFinder finder, ConstructorOrMethod consMethod)

extractParameters	back to summary
private static Parameter[] extractParameters(ConstructorOrMethod method)

filterOutInjectedTypesFromOptionalValues	back to summary
pack-priv static Parameters.FilterOutInjectedTypesResult filterOutInjectedTypesFromOptionalValues(Class<?>[] parameterTypes, String[] optionalValues) Remove injected types from parameterTypes and optionalValues Parameters parameterTypes:Class<?>[] - The parameter types to be used optionalValues:String[] - The optional values to be considered. Returns:Parameters.FilterOutInjectedTypesResult FilterOutInjectedTypesResult

filterOutInjectedTypesFromOptionalValues

back to summary

pack-priv static Parameters.FilterOutInjectedTypesResult filterOutInjectedTypesFromOptionalValues(Class<?>[] parameterTypes, String[] optionalValues)

Remove injected types from parameterTypes and optionalValues

Parameters

parameterTypes:Class<?>[]: - The parameter types to be used
optionalValues:String[]: - The optional values to be considered.

Returns:Parameters.FilterOutInjectedTypesResult

FilterOutInjectedTypesResult

findDataProvider	back to summary
private static IDataProviderMethod findDataProvider(ITestObjectFactory objectFactory, Object instance, ITestClass clazz, ConstructorOrMethod m, IAnnotationFinder finder, ITestContext context)

findDataProvider	back to summary
private static IDataProviderMethod findDataProvider(ITestObjectFactory objectFactory, Object instance, ITestClass clazz, IAnnotationFinder finder, String name, Class<?> dataProviderClass, boolean isDynamicDataProvider, ITestContext context) Find a method that has a @DataProvider(name=name)

findDataProviderInfo	back to summary
private static IDataProvidable findDataProviderInfo(ITestClass clazz, ConstructorOrMethod m, IAnnotationFinder finder) Find the data provider info (data provider name and class) on either @Test(dataProvider), `@Factory(dataProvider)` on a method or @Factory(dataProvider) on a constructor.

getDataProviderName	back to summary
private static String getDataProviderName(IDataProviderAnnotation dp, Method m)

handleParameters back to summary

handleParameters	back to summary
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:ParameterHolder An Iterator over the values for each parameter of this method.

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:ParameterHolder: An Iterator over the values for each parameter of this method.

handleParameters back to summary

handleParameters	back to summary
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:ParameterHolder An Iterator over the values for each parameter of this method.

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:ParameterHolder: An Iterator over the values for each parameter of this method.

injectParameters back to summary

injectParameters	back to summary
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:Object[] parameter values from a data provider method:Method method to be invoked context:ITestContext test context

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:Object[]: parameter values from a data provider
method:Method: method to be invoked
context:ITestContext: test context

isDataProviderClassEmpty	back to summary
private static boolean isDataProviderClassEmpty(ITestAnnotation annotation)

isDataProviderNameEmpty	back to summary
private static boolean isDataProviderNameEmpty(ITestAnnotation annotation)

isDynamicDataProviderClassEmpty	back to summary
private static boolean isDynamicDataProviderClassEmpty(ITestAnnotation annotation)

merge	back to summary
private static IDataProvidable merge(ITestAnnotation methodLevel, ITestAnnotation classLevel)

prettyFormat	back to summary
private static String prettyFormat(List<Class<?>> classes)

retrieveConfigAnnotation	back to summary
private static Class<? extends Annotation> retrieveConfigAnnotation(Method m)

validParameters	back to summary
private static boolean validParameters(String methodAnnotation, Class<?>[] parameterTypes)

org.testng.internal back to summary

pack-priv final Class Parameters.FilterOutInjectedTypesResult

Class Inheritance

extends Object

java.lang.Object
org.testng.internal.Parameters.FilterOutInjectedTypesResult

Store the result of parameterTypes and optionalValues after filter out injected types

Field Summary

Modifier and Type	Field and Description
private final String[]	optionalValues
private final Class<?>[]	parameterTypes

Constructor Summary

Access	Constructor and Description
private	FilterOutInjectedTypesResult(Class<?>[] parameterTypes, String[] optionalValues)

Method Summary

Modifier and Type	Method and Description
pack-priv String[]	getOptionalValues()
pack-priv Class<?>[]	getParameterTypes()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

optionalValues	back to summary
private final String[] optionalValues

parameterTypes	back to summary
private final Class<?>[] parameterTypes

Constructor Detail

FilterOutInjectedTypesResult	back to summary
private FilterOutInjectedTypesResult(Class<?>[] parameterTypes, String[] optionalValues)

Method Detail

getOptionalValues	back to summary
pack-priv String[] getOptionalValues()

getParameterTypes	back to summary
pack-priv Class<?>[] getParameterTypes()

org.testng.internal back to summary

public Class Parameters.MethodParameters

Class Inheritance

extends Object

java.lang.Object
org.testng.internal.Parameters.MethodParameters

A parameter passing helper class.

Field Summary

Modifier and Type	Field and Description
private final ITestContext	context
private final Method	currentTestMethod
private final Object[]	parameterValues
private final ITestResult	testResult
private final Map<String, String>	xmlParameters

Constructor Summary

Access	Constructor and Description
public	MethodParameters(Map<String, String> params, Map<String, String> methodParams)
public	MethodParameters(Map<String, String> parameters found in the suite and test tags params, Map<String, String> parameters found in the include tag methodParams, Object[] parameter values to be used. pv, Method the `Method` object. m, ITestContext The `ITestContext` object representing the current test ctx, ITestResult - The `ITestResult` object. tr)

Method Summary

Modifier and Type	Method and Description
public static Parameters.MethodParameters	newInstance(Map<String, String> params, ITestNGMethod testNGMethod, ITestContext context)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

context	back to summary
private final ITestContext context

currentTestMethod	back to summary
private final Method currentTestMethod

parameterValues	back to summary
private final Object[] parameterValues

testResult	back to summary
private final ITestResult testResult

xmlParameters	back to summary
private final Map<String, String> xmlParameters

Constructor Detail

MethodParameters	back to summary
public MethodParameters(Map<String, String> params, Map<String, String> methodParams)

MethodParameters back to summary

public MethodParameters(Map<String, String> params, Map<String, String> methodParams, Object[] pv, Method m, ITestContext ctx, ITestResult tr)

Parameters

params:Map<String, String>: parameters found in the suite and test tags
methodParams:Map<String, String>: parameters found in the include tag
pv:Object[]: parameter values to be used.
m:Method: the Method object.
ctx:ITestContext: The ITestContext object representing the current test
tr:ITestResult: - The ITestResult object.

Method Detail

newInstance	back to summary
public static Parameters.MethodParameters newInstance(Map<String, String> params, ITestNGMethod testNGMethod, ITestContext context)

public Class Parameters

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class Parameters.FilterOutInjectedTypesResult

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class Parameters.MethodParameters

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail