org.testng.internal

Class ClassHelper

java.lang.Object

org.testng.internal.ClassHelper

public final class ClassHelper
extends Object

Utility class for different class manipulations.

Method Summary

Modifier and Type	Method and Description
static void	addClassLoader(ClassLoader loader) Add a class loader to the searchable loaders.
static Object	createInstance(Class<?> declaringClass, Map<Class<?>,IClass> classes, XmlTest xmlTest, IAnnotationFinder finder, ITestObjectFactory objectFactory, boolean create) Deprecated. - This method is deprecated as of TestNG 7.0.0
static Object	createInstance1(Class<?> declaringClass, Map<Class<?>,IClass> classes, XmlTest xmlTest, IAnnotationFinder finder, IObjectFactory factory, boolean create) Deprecated. - This method is deprecated as of TestNG 7.0.0
static IMethodSelector	createSelector(XmlMethodSelector selector) Deprecated. - This method is deprecated as of TestNG 7.0.0
static IJUnitTestRunner	createTestRunner(TestRunner runner) Deprecated. - This method is deprecated as of TestNG 7.0.0
static Class<?>	fileToClass(String file) Returns the Class object corresponding to the given name.
static XmlClass[]	findClassesInSameTest(Class<?> cls, XmlSuite suite)
static List<ConstructorOrMethod>	findDeclaredFactoryMethods(Class<?> cls, IAnnotationFinder finder) For the given class, returns the method annotated with @Factory or null if none is found.
static Class<?>	forName(String className) Tries to load the specified class using the context ClassLoader or if none, than from the default ClassLoader.
static Set<Method>	getAvailableMethods(Class<?> clazz) Extract all callable methods of a class and all its super (keeping in mind the Java access rules).
static <T> T	newInstance(Class<T> clazz) Deprecated. - This method is deprecated as of TestNG 7.0.0
static <T> T	newInstance(Constructor<T> constructor, Object... parameters) Deprecated. - This method is deprecated as of TestNG 7.0.0
static <T> T	newInstanceOrNull(Class<T> clazz) Deprecated. - This method is deprecated as of TestNG 7.0.0
static <T> T	tryOtherConstructor(Class<T> declaringClass)

Methods inherited from class java.lang.Object

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

Method Detail

addClassLoader

public static void addClassLoader(ClassLoader loader)

Add a class loader to the searchable loaders.

newInstance

@Deprecated
public static <T> T newInstance(Class<T> clazz)

Deprecated. - This method is deprecated as of TestNG 7.0.0

newInstanceOrNull

@Deprecated
public static <T> T newInstanceOrNull(Class<T> clazz)

Deprecated. - This method is deprecated as of TestNG 7.0.0

newInstance

@Deprecated
public static <T> T newInstance(Constructor<T> constructor,
                                            Object... parameters)

Deprecated. - This method is deprecated as of TestNG 7.0.0

forName

public static Class<?> forName(String className)

Tries to load the specified class using the context ClassLoader or if none, than from the default ClassLoader. This method differs from the standard class loading methods in that it does not throw an exception if the class is not found but returns null instead.

Parameters:

className - the class name to be loaded.

Returns:

the class or null if the class is not found.

findDeclaredFactoryMethods

public static List<ConstructorOrMethod> findDeclaredFactoryMethods(Class<?> cls,
                                                                   IAnnotationFinder finder)

For the given class, returns the method annotated with @Factory or null if none is found. This method does not search up the superclass hierarchy. If more than one method is @Factory annotated, a TestNGException is thrown.

Parameters:

cls - The class to search for the @Factory annotation.

finder - The finder (JDK 1.4 or JDK 5.0+) use to search for the annotation.

Returns:

the @Factory methods

getAvailableMethods

public static Set<Method> getAvailableMethods(Class<?> clazz)

Extract all callable methods of a class and all its super (keeping in mind the Java access rules).

createTestRunner

@Deprecated
public static IJUnitTestRunner createTestRunner(TestRunner runner)

Deprecated. - This method is deprecated as of TestNG 7.0.0

createSelector

@Deprecated
public static IMethodSelector createSelector(XmlMethodSelector selector)

Deprecated. - This method is deprecated as of TestNG 7.0.0

createInstance

@Deprecated
public static Object createInstance(Class<?> declaringClass,
                                                Map<Class<?>,IClass> classes,
                                                XmlTest xmlTest,
                                                IAnnotationFinder finder,
                                                ITestObjectFactory objectFactory,
                                                boolean create)

Deprecated. - This method is deprecated as of TestNG 7.0.0

Create an instance for the given class.

createInstance1

@Deprecated
public static Object createInstance1(Class<?> declaringClass,
                                                 Map<Class<?>,IClass> classes,
                                                 XmlTest xmlTest,
                                                 IAnnotationFinder finder,
                                                 IObjectFactory factory,
                                                 boolean create)

Deprecated. - This method is deprecated as of TestNG 7.0.0

tryOtherConstructor

public static <T> T tryOtherConstructor(Class<T> declaringClass)

fileToClass

public static Class<?> fileToClass(String file)

Returns the Class object corresponding to the given name. The name may be of the following form:

• A class name: "org.testng.TestNG"
• A class file name: "/testng/src/org/testng/TestNG.class"
• A class source name: "d:\testng\src\org\testng\TestNG.java"

Parameters:

file - the class name.

Returns:

the class corresponding to the name specified.

findClassesInSameTest

public static XmlClass[] findClassesInSameTest(Class<?> cls,
                                               XmlSuite suite)

Parameters:

cls - - The class to look for.

suite - - The XmlSuite whose <test> tags needs to be searched in.

Returns:

- All the XmlClass objects that share the same <test> tag as the class.