Package org.apache.xmlbeans.impl.jam

Class JamUtils

java.lang.Object

org.apache.xmlbeans.impl.jam.JamUtils

public class JamUtils
extends Object

Singleton collection of utility methods which can be very useful in some samples, but not often enough to warrant inclusion in the main APIs.

Most of these are here to help you jump from the JClass hierarchy to the java.lang.reflect hierarchy. This is primarily useful when you find yourself, for example, wanting to actually invoke a method represented by a JMethod.

Method Summary

Modifier and Type	Method	Description
Constructor	getConstructorOn(JConstructor ctor, Class containedin)	Returns the java.lang.Method on a given java.lang.Class which is represented by a given JMethod.
Field	getFieldOn(JField field, Class containedin)	Returns the java.lang.Method on a given java.lang.Class which is represented by a given JMethod.
static JamUtils	getInstance()
Method	getMethodOn(JMethod method, Class containedin)	Returns the java.lang.Method on a given java.lang.Class which is represented by a given JMethod.
Class	loadClass(JClass clazz, ClassLoader inThisClassloader)	Loads the java.lang.Class represented by a given JClass out of a given classloader.
void	placeInSourceOrder(JElement[] elements)	Sorts the given array in place so that the elements are ordered by their sourcePosition's line numbers.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static final JamUtils getInstance()

getMethodOn

public Method getMethodOn(JMethod method,
                          Class containedin)
                   throws NoSuchMethodException,
                          ClassNotFoundException

Returns the java.lang.Method on a given java.lang.Class which is represented by a given JMethod.

Parameters:

containedin - Class to be searched for the method.

Returns:

Throws:

ClassNotFoundException - if one of the paramType classes specified for this MethodName cannot be loaded from the given class' classloader.

NoSuchMethodException - If the named method does not exist on this class.

IllegalArgumentException - if any argument is null

getConstructorOn

public Constructor getConstructorOn(JConstructor ctor,
                                    Class containedin)
                             throws NoSuchMethodException,
                                    ClassNotFoundException

Returns the java.lang.Method on a given java.lang.Class which is represented by a given JMethod.

Parameters:

containedin - Class to be searched for the ctor.

Returns:

Throws:

ClassNotFoundException - if one of the paramType classes specified for this MethodName cannot be loaded from the given class' classloader.

NoSuchMethodException - If the named ctor does not exist on this class.

IllegalArgumentException - if any argument is null

getFieldOn

public Field getFieldOn(JField field,
                        Class containedin)
                 throws NoSuchFieldException

Returns the java.lang.Method on a given java.lang.Class which is represented by a given JMethod.

Parameters:

containedin - Class to be searched for the method.

Returns:

Throws:

NoSuchFieldException - if the field does not exist on the class.

IllegalArgumentException - if any argument is null

loadClass

public Class loadClass(JClass clazz,
                       ClassLoader inThisClassloader)
                throws ClassNotFoundException

Loads the java.lang.Class represented by a given JClass out of a given classloader.

Returns:

Throws:

ClassNotFoundException - If the class is not found in the classloader

placeInSourceOrder

public void placeInSourceOrder(JElement[] elements)

Sorts the given array in place so that the elements are ordered by their sourcePosition's line numbers.