Class JavaField

java.lang.Object

com.ibm.dtfj.java.j9.JavaField

All Implemented Interfaces:

JavaField, JavaMember

Direct Known Subclasses:

JavaInstanceField, JavaStaticField

public abstract class JavaField
extends Object
implements JavaField

Field Summary

Fields

Modifier and Type	Field	Description
protected JavaRuntime	_javaVM
protected static final String	ARRAY_PREFIX_SIGNATURE
protected static final String	BOOLEAN_SIGNATURE
protected static final String	BYTE_SIGNATURE
protected static final String	CHAR_SIGNATURE
protected static final String	DOUBLE_SIGNATURE
protected static final String	FLOAT_SIGNATURE
protected static final String	INTEGER_SIGNATURE
protected static final String	LONG_SIGNATURE
protected static final String	OBJECT_PREFIX_SIGNATURE
protected static final String	SHORT_SIGNATURE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	JavaField(JavaRuntime vm, String name, String signature, int modifiers, long declaringClassID)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
Object	get(JavaObject object)	Get the contents of an Object field.
JavaClass	getDeclaringClass()	Get the class which declares this field or method
double	getDouble(JavaObject object)	Get the contents of a double field.
float	getFloat(JavaObject object)	Get the contents of a float field.
int	getInt(JavaObject object)	Get the contents of an int field.
long	getLong(JavaObject object)	Get the contents of a long field.
int	getModifiers()	Get the set of modifiers for this field or method - a set of bits
String	getName()	Get the name of the field or method
protected abstract Object	getReferenceType(JavaObject object)
short	getShort(JavaObject object)	Get the contents of a short field.
String	getSignature()	Get the signature of the field or method
String	getString(JavaObject hostObject)	Get the contents of a string field.
int	hashCode()	Answers an integer hash code for the receiver.

Methods declared in class java.lang.Object

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

Methods declared in interface com.ibm.dtfj.java.JavaField

getBoolean, getByte, getChar, isNestedPacked, isNestedPackedArray

Field Details

BOOLEAN_SIGNATURE

protected static final String BOOLEAN_SIGNATURE

See Also:

• Constant Field Values

BYTE_SIGNATURE

protected static final String BYTE_SIGNATURE

See Also:

• Constant Field Values

CHAR_SIGNATURE

protected static final String CHAR_SIGNATURE

See Also:

• Constant Field Values

SHORT_SIGNATURE

protected static final String SHORT_SIGNATURE

See Also:

• Constant Field Values

INTEGER_SIGNATURE

protected static final String INTEGER_SIGNATURE

See Also:

• Constant Field Values

LONG_SIGNATURE

protected static final String LONG_SIGNATURE

See Also:

• Constant Field Values

FLOAT_SIGNATURE

protected static final String FLOAT_SIGNATURE

See Also:

• Constant Field Values

DOUBLE_SIGNATURE

protected static final String DOUBLE_SIGNATURE

See Also:

• Constant Field Values

OBJECT_PREFIX_SIGNATURE

protected static final String OBJECT_PREFIX_SIGNATURE

See Also:

• Constant Field Values

ARRAY_PREFIX_SIGNATURE

protected static final String ARRAY_PREFIX_SIGNATURE

See Also:

• Constant Field Values

_javaVM

protected JavaRuntime _javaVM

Constructor Details

JavaField

protected JavaField(JavaRuntime vm,
 String name,
 String signature,
 int modifiers,
 long declaringClassID)

Method Details

get

public Object get(JavaObject object)
           throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of an Object field.

Specified by:

get in interface JavaField

Parameters:

object - to fetch the field from. Ignored for static fields.

Returns:

a JavaObject instance for reference type fields, an instance of a subclass of Number, Boolean, or Character for primitive fields, or null for null reference fields This field must be declared in the object's class or in a superclass.

Throws:

CorruptDataException

MemoryAccessException

See Also:

• JavaObject
• Byte
• Double
• Float
• Integer
• Long
• Short
• Character
• Boolean

getLong

public long getLong(JavaObject object)
             throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of a long field.

Specified by:

getLong in interface JavaField

Parameters:

object - to fetch the field from. Ignored for static fields.

Returns:

the field contents

Throws:

CorruptDataException

MemoryAccessException

getDouble

public double getDouble(JavaObject object)
                 throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of a double field.

Specified by:

getDouble in interface JavaField

Parameters:

object - to fetch the field from. Ignored for static fields.

Returns:

the field contents

Throws:

CorruptDataException

MemoryAccessException

getFloat

public float getFloat(JavaObject object)
               throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of a float field.

Specified by:

getFloat in interface JavaField

Parameters:

object - to fetch the field from. Ignored for static fields.

Returns:

the field contents

Throws:

CorruptDataException

MemoryAccessException

getInt

public int getInt(JavaObject object)
           throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of an int field.

Specified by:

getInt in interface JavaField

Parameters:

object - to fetch the field from. Ignored for static fields.

Returns:

the field contents

Throws:

CorruptDataException

MemoryAccessException

getShort

public short getShort(JavaObject object)
               throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of a short field.

Specified by:

getShort in interface JavaField

Parameters:

object - to fetch the field from. Ignored for static fields.

Returns:

the field contents

Throws:

CorruptDataException

MemoryAccessException

getReferenceType

protected abstract Object getReferenceType(JavaObject object)
                                    throws CorruptDataException,
MemoryAccessException

Throws:

CorruptDataException

MemoryAccessException

getModifiers

public int getModifiers()
                 throws CorruptDataException

Description copied from interface: JavaMember

Get the set of modifiers for this field or method - a set of bits

Specified by:

getModifiers in interface JavaMember

Returns:

the modifiers for this field or method. The values for the constants representing the modifiers can be obtained from java.lang.reflect.Modifier.

Throws:

CorruptDataException

getDeclaringClass

public JavaClass getDeclaringClass()
                            throws CorruptDataException

Description copied from interface: JavaMember

Get the class which declares this field or method

Specified by:

getDeclaringClass in interface JavaMember

Returns:

the JavaClass which declared this field or method

Throws:

CorruptDataException

getName

public String getName()
               throws CorruptDataException

Description copied from interface: JavaMember

Get the name of the field or method

Specified by:

getName in interface JavaMember

Returns:

the name of the field or method

Throws:

CorruptDataException

getSignature

public String getSignature()
                    throws CorruptDataException

Description copied from interface: JavaMember

Get the signature of the field or method

Specified by:

getSignature in interface JavaMember

Returns:

the signature of the field or method. e.g. "(Ljava/lang/String;)V"

Throws:

CorruptDataException

getString

public String getString(JavaObject hostObject)
                 throws CorruptDataException,
MemoryAccessException

Description copied from interface: JavaField

Get the contents of a string field.

Specified by:

getString in interface JavaField

Parameters:

hostObject - to fetch the field from. Ignored for static fields.

Returns:

a String representing the value of the String field. Note that the instance returned can be null if the field was null in object.

Throws:

CorruptDataException

MemoryAccessException

equals

public boolean equals(Object obj)

Description copied from class: java.lang.Object

Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison. The implementation in Object answers true only if the argument is the exact same object as the receiver (==).

Specified by:

equals in interface JavaMember

Overrides:

equals in class Object

Parameters:

obj -

Returns:

True if the given object refers to the same Java Member in the image

See Also:

• Object.hashCode()

hashCode

public int hashCode()

Description copied from class: java.lang.Object

Answers an integer hash code for the receiver. Any two objects which answer true when passed to .equals must answer the same value for this method.

Specified by:

hashCode in interface JavaMember

Overrides:

hashCode in class Object

Returns:

the receiver's hash.

See Also:

• Object.equals(java.lang.Object)