org.jikesrvm.classloader

Class RVMField

java.lang.Object

org.jikesrvm.classloader.AnnotatedElement

org.jikesrvm.classloader.RVMMember

org.jikesrvm.classloader.RVMField

All Implemented Interfaces:

AnnotatedElement

public final class RVMField
extends RVMMember

A field of a java class.

Field Summary

Fields

Modifier and Type	Field and Description
private int	constantValueIndex constant pool index of field's value (0 --> not a "static final constant")
private boolean	madeTraced Has the field been made traced?
private boolean	reference Does the field hold a reference value?
private byte	size The size of the field in bytes

Fields inherited from class org.jikesrvm.classloader.RVMMember

memRef, modifiers, offset

Fields inherited from class org.jikesrvm.classloader.AnnotatedElement

declaredAnnotationDatas

Constructor Summary

Constructors

Modifier	Constructor and Description
private	RVMField(TypeReference declaringClass, MemberReference memRef, short modifiers, Atom signature, int constantValueIndex, RVMAnnotation[] annotations) Create a field.

Method Summary

Modifier and Type	Method and Description
(package private) static RVMField	createAnnotationField(TypeReference annotationClass, MemberReference memRef)
private int	get32Bits(Object obj)
private long	get64Bits(Object obj)
Address	getAddressValueUnchecked(Object obj)
boolean	getBooleanValueUnchecked(Object obj)
byte	getByteValueUnchecked(Object obj)
char	getCharValueUnchecked(Object obj)
(package private) int	getConstantValueIndex() Get index of constant pool entry containing this "static final constant" field's value.
double	getDoubleValueUnchecked(Object obj)
Extent	getExtentValueUnchecked(Object obj)
float	getFloatValueUnchecked(Object obj)
int	getIntValueUnchecked(Object obj)
long	getLongValueUnchecked(Object obj)
int	getNumberOfStackSlots()
Object	getObjectUnchecked(Object obj) Read the contents of the field.
Object	getObjectValueUnchecked(Object obj) Read one object ref from heap using RVM object model, GC safe.
Offset	getOffsetValueUnchecked(Object obj)
boolean	getRuntimeFinalValue() Gets the value from the runtime final field.
short	getShortValueUnchecked(Object obj)
int	getSize()
TypeReference	getType()
Word	getWordValueUnchecked(Object obj)
boolean	isEnumConstant()
boolean	isFinal()
boolean	isReferenceType()
boolean	isRuntimeFinal() Is the field RuntimeFinal?
boolean	isStatic()
boolean	isSynthetic()
boolean	isTraced() Does the field hold a reference?
boolean	isTransient()
boolean	isUntraced()
boolean	isVolatile()
boolean	madeTraced() Does the field hold a made-traced reference?
void	makeTraced() Make this field a traced field by garbage collection.
(package private) static RVMField	readField(TypeReference declaringClass, int[] constantPool, MemberReference memRef, short modifiers, DataInputStream input) Reads and creates a field.
void	setAddressValueUnchecked(Object obj, Address ref)
void	setBooleanValueUnchecked(Object obj, boolean b)
void	setByteValueUnchecked(Object obj, byte b)
void	setCharValueUnchecked(Object obj, char c)
void	setDoubleValueUnchecked(Object obj, double d)
void	setExtentValueUnchecked(Object obj, Extent ref)
void	setFloatValueUnchecked(Object obj, float f)
void	setIntValueUnchecked(Object obj, int i)
void	setLongValueUnchecked(Object obj, long l)
void	setObjectValueUnchecked(Object obj, Object ref) assign one object ref from heap using RVM object model, GC safe.
void	setOffsetValueUnchecked(Object obj, Offset ref)
void	setShortValueUnchecked(Object obj, short i)
void	setWordValueUnchecked(Object obj, Word ref) assign one object ref from heap using RVM object model, GC safe.

Methods inherited from class org.jikesrvm.classloader.RVMMember

getDeclaringClass, getDescriptor, getId, getMemberRef, getModifiers, getName, getOffset, getSignature, hashCode, hasOffset, isPrivate, isProtected, isPublic, setOffset, toString

Methods inherited from class org.jikesrvm.classloader.AnnotatedElement

getAnnotation, getAnnotations, getAnnotationsInternal, getDeclaredAnnotations, getDeclaredAnnotationsInternal, hasAnnotations, hasBaselineNoRegistersAnnotation, hasBaselineSaveLSRegistersAnnotation, hasInlineAnnotation, hasInterruptibleAnnotation, hasLogicallyUninterruptibleAnnotation, hasNoBoundsCheckAnnotation, hasNoCheckStoreAnnotation, hasNoEscapesAnnotation, hasNoInlineAnnotation, hasNonMovingAllocationAnnotation, hasNonMovingAnnotation, hasNoNullCheckAnnotation, hasNoOptCompileAnnotation, hasPreemptibleAnnotation, hasPureAnnotation, hasRuntimeFinalAnnotation, hasRuntimePureAnnotation, hasUninterruptibleAnnotation, hasUninterruptibleNoWarnAnnotation, hasUnpreemptibleAnnotation, hasUnpreemptibleNoWarnAnnotation, hasUntracedAnnotation, isAnnotationDeclared, isAnnotationPresent, readAnnotations, toAnnotations

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.reflect.AnnotatedElement

getAnnotationsByType, getDeclaredAnnotation, getDeclaredAnnotationsByType

Field Detail

constantValueIndex

private final int constantValueIndex

constant pool index of field's value (0 --> not a "static final constant")

size

private final byte size

The size of the field in bytes

reference

private final boolean reference

Does the field hold a reference value?

madeTraced

private boolean madeTraced

Has the field been made traced?

Constructor Detail

RVMField

private RVMField(TypeReference declaringClass,
                 MemberReference memRef,
                 short modifiers,
                 Atom signature,
                 int constantValueIndex,
                 RVMAnnotation[] annotations)

Create a field.

Parameters:

declaringClass - the TypeReference object of the class that declared this field

memRef - the canonical memberReference for this member.

modifiers - modifiers associated with this field.

signature - generic type of this field.

constantValueIndex - constant pool index of constant value

annotations - array of runtime visible annotations

Method Detail

readField

static RVMField readField(TypeReference declaringClass,
                          int[] constantPool,
                          MemberReference memRef,
                          short modifiers,
                          DataInputStream input)
                   throws IOException

Reads and creates a field. NB only RVMClass is allowed to create an instance of a RVMField.

Parameters:

declaringClass - the TypeReference object of the class that declared this field

constantPool - the constant pool of the class loading this field

memRef - the canonical memberReference for this member.

modifiers - modifiers associated with this member.

input - the DataInputStream to read the field's attributed from

Returns:

the newly created field

Throws:

IOException - when a skip is shorter than expected

createAnnotationField

static RVMField createAnnotationField(TypeReference annotationClass,
                                      MemberReference memRef)

getType

public TypeReference getType()

Returns:

type of this field's value.

getNumberOfStackSlots

public int getNumberOfStackSlots()

Returns:

the number of stackslots that value of this type takes

getSize

public int getSize()

Returns:

the number of bytes of memory words that a value of this type takes

isTraced

public boolean isTraced()

Does the field hold a reference?

Returns:

true if this field needs to be traced by the garbage collector

madeTraced

public boolean madeTraced()

Does the field hold a made-traced reference?

Returns:

true if this field was made traced

isReferenceType

public boolean isReferenceType()

Returns:

true if this field holds a reference

isStatic

public boolean isStatic()

Returns:

true if this field is shared among all instances of this class

isFinal

public boolean isFinal()

Returns:

true if this field may only be assigned once

isVolatile

public boolean isVolatile()

Returns:

true if the value of this field may not be cached in a register

isTransient

public boolean isTransient()

Returns:

true if this field's value is not to be written/read by persistent object manager

isSynthetic

public boolean isSynthetic()

Returns:

true if this field is not present in source code file

isEnumConstant

public boolean isEnumConstant()

Returns:

true if this field is an enum constant

isRuntimeFinal

public boolean isRuntimeFinal()

Is the field RuntimeFinal? That is can the annotation value be used in place a reading the field.

Returns:

whether the method is final at runtime

isUntraced

public boolean isUntraced()

Returns:

true if this this field is invisible to the memory management system.

makeTraced

public void makeTraced()

Make this field a traced field by garbage collection. Affects all subclasses of the class in which this field is defined.

getRuntimeFinalValue

public boolean getRuntimeFinalValue()

Gets the value from the runtime final field.

Returns:

the value of the field, i.e. if the method is final at runtime or not

getConstantValueIndex

int getConstantValueIndex()

Get index of constant pool entry containing this "static final constant" field's value.

Returns:

constant pool index (0 --> field is not a "static final constant")

getObjectUnchecked

public Object getObjectUnchecked(Object obj)

Read the contents of the field. If the contents of this field is an object, return that object. If the contents of this field is a primitive, get the value and wrap it in an object.

Parameters:

obj - the object whose field is to be read

Returns:

the value of this field. For primitiv types, a boxed value is used.

getObjectValueUnchecked

public Object getObjectValueUnchecked(Object obj)

Read one object ref from heap using RVM object model, GC safe.

Parameters:

obj - the object whose field is to be read, or null if the field is static.

Returns:

the reference described by this RVMField from the given object.

getWordValueUnchecked

public Word getWordValueUnchecked(Object obj)

getAddressValueUnchecked

public Address getAddressValueUnchecked(Object obj)

getOffsetValueUnchecked

public Offset getOffsetValueUnchecked(Object obj)

getExtentValueUnchecked

public Extent getExtentValueUnchecked(Object obj)

getBooleanValueUnchecked

public boolean getBooleanValueUnchecked(Object obj)

getByteValueUnchecked

public byte getByteValueUnchecked(Object obj)

getCharValueUnchecked

public char getCharValueUnchecked(Object obj)

getShortValueUnchecked

public short getShortValueUnchecked(Object obj)

getIntValueUnchecked

public int getIntValueUnchecked(Object obj)

getLongValueUnchecked

public long getLongValueUnchecked(Object obj)

getFloatValueUnchecked

public float getFloatValueUnchecked(Object obj)

getDoubleValueUnchecked

public double getDoubleValueUnchecked(Object obj)

get32Bits

private int get32Bits(Object obj)

get64Bits

private long get64Bits(Object obj)

setObjectValueUnchecked

public void setObjectValueUnchecked(Object obj,
                                    Object ref)

assign one object ref from heap using RVM object model, GC safe.

Parameters:

obj - the object whose field is to be modified, or null if the field is static.

ref - the object reference to be assigned.

setWordValueUnchecked

public void setWordValueUnchecked(Object obj,
                                  Word ref)

assign one object ref from heap using RVM object model, GC safe.

Parameters:

obj - the object whose field is to be modified, or null if the field is static.

ref - the object reference to be assigned.

setAddressValueUnchecked

public void setAddressValueUnchecked(Object obj,
                                     Address ref)

setExtentValueUnchecked

public void setExtentValueUnchecked(Object obj,
                                    Extent ref)

setOffsetValueUnchecked

public void setOffsetValueUnchecked(Object obj,
                                    Offset ref)

setBooleanValueUnchecked

public void setBooleanValueUnchecked(Object obj,
                                     boolean b)

setByteValueUnchecked

public void setByteValueUnchecked(Object obj,
                                  byte b)

setCharValueUnchecked

public void setCharValueUnchecked(Object obj,
                                  char c)

setShortValueUnchecked

public void setShortValueUnchecked(Object obj,
                                   short i)

setIntValueUnchecked

public void setIntValueUnchecked(Object obj,
                                 int i)

setFloatValueUnchecked

public void setFloatValueUnchecked(Object obj,
                                   float f)

setLongValueUnchecked

public void setLongValueUnchecked(Object obj,
                                  long l)

setDoubleValueUnchecked

public void setDoubleValueUnchecked(Object obj,
                                    double d)