com.ibm.dtfj.java
Interface JavaClass


public interface JavaClass

Represents a Java class.


Method Summary
 boolean equals(java.lang.Object obj)
           
 JavaClassLoader getClassLoader()
          Fetch the class loader associated with this class.
 JavaClass getComponentType()
          For array classes, returns a JavaClass representing the component type of this array class.
 java.util.Iterator getConstantPoolReferences()
          Java classes may refer to other classes and to String objects via the class's constant pool.
 java.util.Iterator getDeclaredFields()
           
 java.util.Iterator getDeclaredMethods()
           
 ImagePointer getID()
          The ID of a class is a pointer to a section of memory which identifies the class.
 java.util.Iterator getInterfaces()
           
 int getModifiers()
          Return the Java language modifiers for this class.
 java.lang.String getName()
           
 JavaObject getObject()
          Fetch the java.lang.Class object associated with this class.
 JavaClass getSuperclass()
           
 int hashCode()
           
 boolean isArray()
           
 

Method Detail

getObject

public JavaObject getObject()
                     throws CorruptDataException
Fetch the java.lang.Class object associated with this class.

In some implementations this may be null if no object has been created to represent this class, or if the class is synthetic.

Returns:
the java.lang.Class object associated with this class
Throws:
CorruptDataException
See Also:
getID()

getClassLoader

public JavaClassLoader getClassLoader()
                               throws CorruptDataException
Fetch the class loader associated with this class. Classes defined in the bootstrap class loader (including classes represenintg primitive types or void) will always return a JavaClassLoader representing the bootstrap class loader. This assymmetry with java.lang.Class#getClassLoader() is intentional.

Returns:
the JavaClassLoader in which this class was defined
Throws:
CorruptDataException - if the class loader for this class cannot be found (a class cannot exist without a loader so this implies corruption)

getName

public java.lang.String getName()
                         throws CorruptDataException
Returns:
the name of the class in the form: "full/package/class$innerclass"
Throws:
CorruptDataException

getSuperclass

public JavaClass getSuperclass()
                        throws CorruptDataException
Returns:
the immediate superclass of this class, or null if this class has no superclass. For interfaces, Object, primitive types and void null is always returned.
Throws:
CorruptDataException

getInterfaces

public java.util.Iterator getInterfaces()
Returns:
an iterator over the collection of the names of interfaces directly implemented by this class. Some JVM implementations may choose to load interfaces lazily, so only the names are returned. The JavaClass objects may be found through the defining class loader.
See Also:
String, JavaClassLoader.findClass(String), CorruptData

getModifiers

public int getModifiers()
                 throws CorruptDataException
Return the Java language modifiers for this class.

The modifiers are defined by the JVM Specification.

Note that, for inner classes, the actual modifiers are returned, not the synthetic modifiers. For instance, a class will never have its 'protected' modifier set, even if the inner class was a protected member, since 'protected' is not a legal modifier for a class file.

Returns:
the modifiers for this class
Throws:
CorruptDataException

isArray

public boolean isArray()
                throws CorruptDataException
Returns:
true if this class is an array class
Throws:
CorruptDataException

getComponentType

public JavaClass getComponentType()
                           throws CorruptDataException
For array classes, returns a JavaClass representing the component type of this array class.

Returns:
a JavaClass representing the component type of this array class
Throws:
java.lang.IllegalArgumentException - if this JavaClass does not represent an array class
CorruptDataException

getDeclaredFields

public java.util.Iterator getDeclaredFields()
Returns:
an iterator over the collection of fields declared in this class.
See Also:
JavaField, CorruptData

getDeclaredMethods

public java.util.Iterator getDeclaredMethods()
Returns:
an iterator over the collection of methods declared in this class.
See Also:
JavaMethod, CorruptData

getConstantPoolReferences

public java.util.Iterator getConstantPoolReferences()
Java classes may refer to other classes and to String objects via the class's constant pool. These references are followed by the garbage collector, forming edges on the graph of reachable objects. This getConstantPoolReferences() may be used to determine which objects are referred to by the receiver's constant pool.

Although Java VMs typically permit only Class and String objects in the constant pool, some esoteric or future virtual machines may permit other types of objects to occur in the constant pool. This API imposes no restrictions on the types of JavaObjects which might be included in the Iterator.

No assumption should be made about the order in which constant pool references are returned.

Classes may also refer to objects through static variables. These may be found with the getDeclaredFields() API. Objects referenced by static variables are not returned by getConstantPoolReferences() unless the object is also referenced by the costant pool.

Returns:
an iterator over the collection of JavaObjects which are referred to by the constant pool of this class
See Also:
JavaObject, CorruptData

getID

public ImagePointer getID()
The ID of a class is a pointer to a section of memory which identifies the class. The contents of this memory are implementation defined.

In some implementations getID() and getObject().getID() may return the same value. This implies that the class object is also the primary internal representation of the class. DTFJ users should not rely on thie behaviour.

In some implementations, getID() may return null for some classes. This indicates that the class is a synthetic class which has been constructed for DTFJ purposes only. The class has no physical representation in the VM.

Returns:
a pointer to the class

equals

public boolean equals(java.lang.Object obj)
Parameters:
obj -
Returns:
True obj refers to the same Java Class in the image

hashCode

public int hashCode()


Copyright © 2005 IBM. All Rights Reserved.