testng 7.10.2 · org.testng.internal.ClassHelper

Modifier and Type	Field and Description
private static final String	CLASS_HELPER
private static final List<ClassLoader>	classLoaders The additional class loaders to find classes in.
private static int	lastGoodRootIndex When given a file name to form a class name, the file name is parsed and divided into segments.

Access	Constructor and Description
private	ClassHelper() Hide constructor.

Method Summary

Modifier and Type	Method and Description
public static void	addClassLoader(final ClassLoader loader)
pack-priv static List<ClassLoader>	appendContextualClassLoaders(List<ClassLoader> currentLoaders)
private static void	appendMethod(Map<String, Set<Method>> methods, Method declaredMethod)
private static boolean	canInclude(boolean isSamePackage, Method method, Map<String, Set<Method>> collected)
private static Map<String, Set<Method>>	extractMethods(Class<?> childClass, Class<?> clazz, Map<String, Set<Method>> collected)
public static Class<?>	Returns: the class corresponding to the name specified. fileToClass(String the class name. file) Returns the Class object corresponding to the given name.
public static XmlClass[]	Returns: - All the `XmlClass` objects that share the same <test> tag as the class. findClassesInSameTest(Class<?> - The class to look for. cls, XmlSuite - The `XmlSuite` whose <test> tags needs to be searched in. suite)
private static Collection<XmlClass>	findClassesInSameTest(Class<?> cls, XmlTest xmlTest)
public static List<ConstructorOrMethod>	Returns: the @Factory `methods` findDeclaredFactoryMethods(Class<?> The class to search for the @Factory annotation. cls, IAnnotationFinder The finder (JDK 1.4 or JDK 5.0+) use to search for the annotation. finder) For the given class, returns the method annotated with @Factory or null if none is found.
public static Class<?>	Returns: the class or null if the class is not found. forName(final String the class name to be loaded. className) Tries to load the specified class using the context ClassLoader or if none, than from the default ClassLoader.
public static Set<Method>	getAvailableMethods(Class<?> clazz)
public static Set<Method>	Returns: - A `Set` of `Method` excluding default methods from base class interfaces. getAvailableMethodsExcludingDefaults(Class<?> - The `Class` in which the search is to be done. clazz)
private static boolean	isOverridden(Method method, Map<String, Set<Method>> methodsByName)
private static boolean	isSamePackage(Package childPackage, Package classPackage)
private static void	logClassNotFoundError(String className, Throwable ex)

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

CLASS_HELPER	back to summary
private static final String CLASS_HELPER

classLoaders	back to summary
private static final List<ClassLoader> classLoaders The additional class loaders to find classes in.

lastGoodRootIndex	back to summary
private static int lastGoodRootIndex When given a file name to form a class name, the file name is parsed and divided into segments. For example, "c:/java/classes/com/foo/A.class" would be divided into 6 segments {"C:" "java", "classes", "com", "foo", "A"}. The first segment actually making up the class name is [3]. This value is saved in lastGoodRootIndex so that when we parse the next file name, we will try 3 right away. If 3 fails we will take the long approach. This is just a optimization cache value.

ClassHelper	back to summary
private ClassHelper() Hide constructor.

Method Detail

addClassLoader	back to summary
public static void addClassLoader(final ClassLoader loader)

appendContextualClassLoaders	back to summary
pack-priv static List<ClassLoader> appendContextualClassLoaders(List<ClassLoader> currentLoaders)

appendMethod	back to summary
private static void appendMethod(Map<String, Set<Method>> methods, Method declaredMethod)

canInclude	back to summary
private static boolean canInclude(boolean isSamePackage, Method method, Map<String, Set<Method>> collected)

extractMethods	back to summary
private static Map<String, Set<Method>> extractMethods(Class<?> childClass, Class<?> clazz, Map<String, Set<Method>> collected)

fileToClass	back to summary
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:String the class name. Returns:Class<?> the class corresponding to the name specified.

fileToClass

back to summary

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:String: the class name.

Returns:Class<?>

the class corresponding to the name specified.

findClassesInSameTest	back to summary
public static XmlClass[] findClassesInSameTest(Class<?> cls, XmlSuite suite) Parameters cls:Class<?> - The class to look for. suite:XmlSuite - The `XmlSuite` whose <test> tags needs to be searched in. Returns:XmlClass[] - All the `XmlClass` objects that share the same <test> tag as the class.

findClassesInSameTest	back to summary
private static Collection<XmlClass> findClassesInSameTest(Class<?> cls, XmlTest xmlTest)

findDeclaredFactoryMethods back to summary

findDeclaredFactoryMethods	back to summary
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:Class<?> The class to search for the @Factory annotation. finder:IAnnotationFinder The finder (JDK 1.4 or JDK 5.0+) use to search for the annotation. Returns:List<ConstructorOrMethod> the @Factory `methods`

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:Class<?>: The class to search for the @Factory annotation.
finder:IAnnotationFinder: The finder (JDK 1.4 or JDK 5.0+) use to search for the annotation.

Returns:List<ConstructorOrMethod>

the @Factory methods

forName	back to summary
public static Class<?> forName(final 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:String the class name to be loaded. Returns:Class<?> the class or null if the class is not found.

forName

back to summary

public static Class<?> forName(final 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:String: the class name to be loaded.

Returns:Class<?>

the class or null if the class is not found.

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

getAvailableMethodsExcludingDefaults	back to summary
public static Set<Method> getAvailableMethodsExcludingDefaults(Class<?> clazz) Parameters clazz:Class<?> - The `Class` in which the search is to be done. Returns:Set<Method> - A `Set` of `Method` excluding default methods from base class interfaces.

isOverridden	back to summary
private static boolean isOverridden(Method method, Map<String, Set<Method>> methodsByName)

isSamePackage	back to summary
private static boolean isSamePackage(Package childPackage, Package classPackage)

logClassNotFoundError	back to summary
private static void logClassNotFoundError(String className, Throwable ex)

public final Class ClassHelper

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail