com.sun.jdi
Interface Field

All Superinterfaces:

Accessible, Comparable, Mirror, TypeComponent

public interface Field

extends TypeComponent, Comparable

A class or instance variable in the target VM. See TypeComponent for general information about Field and Method mirrors.

Since:

1.3

See Also:

ObjectReference, ReferenceType

Method Summary

boolean	equals(Object obj) Compares the specified Object with this field for equality.
int	hashCode() Returns the hash code value for this Field.
boolean	isTransient() Determine if this is a transient field.
boolean	isVolatile() Determine if this is a volatile field.
Type	type() Returns the type of this field.
String	typeName() Returns a text representation of the type of this field.

Methods inherited from interface com.sun.jdi.TypeComponent

declaringType, isFinal, isStatic, isSynthetic, name, signature

Methods inherited from interface com.sun.jdi.Mirror

toString, virtualMachine

Methods inherited from interface com.sun.jdi.Accessible

isPackagePrivate, isPrivate, isProtected, isPublic, modifiers

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

typeName

public String typeName()

Returns a text representation of the type of this field. Where the type is the type specified in the declaration of this field.

This type name is always available even if the type has not yet been created or loaded.

Returns:

a String representing the type of this field.

type

public Type type()
          throws ClassNotLoadedException

Returns the type of this field. Where the type is the type specified in the declaration of this field.

For example, if a target class defines:

    short s;
    Date d;
    byte[] ba;

And the JDI client defines these Field objects:

    Field sField = targetClass.fieldByName("s");
    Field dField = targetClass.fieldByName("d");
    Field baField = targetClass.fieldByName("ba");

to mirror the corresponding fields, then sField.type() is a ShortType, dField.type() is the ReferenceType for java.util.Date and ((ArrayType)(baField.type())).componentType() is a ByteType.

Note: if the type of this field is a reference type (class, interface, or array) and it has not been created or loaded by the declaring type's class loader - that is, declaringType() .classLoader(), then ClassNotLoadedException will be thrown. Also, a reference type may have been loaded but not yet prepared, in which case the type will be returned but attempts to perform some operations on the returned type (e.g. fields()) will throw a ClassNotPreparedException. Use ReferenceType.isPrepared() to determine if a reference type is prepared.

Returns:

the Type of this field.

Throws:

ClassNotLoadedException - if the type has not yet been loaded or created through the appropriate class loader.

See Also:

Type

isTransient

public boolean isTransient()

Determine if this is a transient field.

Returns:

true if this field is transient; false otherwise.

isVolatile

public boolean isVolatile()

Determine if this is a volatile field.

Returns:

true if this field is volatile; false otherwise.

equals

public boolean equals(Object obj)

Compares the specified Object with this field for equality.

Overrides:

equals in class Object

Returns:

true if the Object is a Field and if both mirror the same field (declared in the same class or interface, in the same VM).

hashCode

public int hashCode()

Returns the hash code value for this Field.

Overrides:

hashCode in class Object

Returns:

the integer hash code