A Field provides information about, and dynamic access
to, a single field of a class or an interface. The reflected
field may be a class (static) field or an instance field.
A Field permits widening conversions to occur during a
get or set access operation, but throws an
IllegalArgumentException if a narrowing conversion
would occur.
equals
public boolean equals(Object obj)
Compares this Field against the specified object.
Returns true if the objects are the same. Two
Fields are the same if they were declared by the
same class and have the same name and type.
get
public Object get(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Returns the value of the field represented by this
Field, on the specified object. The value is
automatically wrapped in an object if it has a
primitive type.
The underlying field's value is obtained as follows:
If the underlying field is a static field, the object
argument is ignored; it may be null.
Otherwise, the underlying field is an instance
field. If the specified object argument is null, the
method throws a NullPointerException. If the
specified object is not an instance of the class or
interface declaring the underlying field, the
method throws an IllegalArgumentException.
If this Field object enforces Java language access
control, and the underlying field is inaccessible,
the method throws an IllegalAccessException.
Otherwise, the value is retrieved from the
underlying instance or static field. If the field has a
primitive type, the value is wrapped in an object
before being returned, otherwise it is returned as
is.
getBoolean
public boolean getBoolean(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a boolean on specified
object.
getByte
public byte getByte(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a byte on specified
object.
getChar
public char getChar(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a char on specified
object.
getDeclaringClass
public Class getDeclaringClass()
Returns the Class object representing the class or
interface that declares the field represented by this
Field object.
- getDeclaringClass in interface Member
getDouble
public double getDouble(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a double on specified
object.
getFloat
public float getFloat(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a float on specified
object.
getInitializer
public String getInitializer()
Method getInitializer
(getInitializer) @return
getInt
public int getInt(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a int on specified object.
getLong
public long getLong(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a long on specified
object.
getModifiers
public int getModifiers()
Returns the Java language modifiers for the field
represented by this Field object, as an integer. The
Modifier class should be used to decode the
modifiers.
- getModifiers in interface Member
getName
public String getName()
Insert the method's description here.
Creation date: (12-25-99 2:02:26 PM)
getShort
public short getShort(Object obj)
throws IllegalArgumentException,
IllegalAccessException
Get the value of a field as a short on specified
object.
getType
public Class getType()
Returns a Class object that identifies the declared
type for the field represented by this Field object.
hashCode
public int hashCode()
Returns a hashcode for this Field. This is
computed as the exclusive-or of the hashcodes for
the underlying field's declaring class name and its
name.
set
public void set(Object obj,
Object value)
throws IllegalArgumentException,
IllegalAccessException
Sets the field represented by this Field object on
the specified object argument to the specified new
value. The new value is automatically unwrapped
if the underlying field has a primitive type.
The operation proceeds as follows:
If the underlying field is static, the object
argument is ignored; it may be null.
Otherwise the underlying field is an instance field.
If the specified object argument is null, the
method throws a NullPointerException. If the
specified object argument is not an instance of the
class or interface declaring the underlying field,
the method throws an IllegalArgumentException.
If this Field object enforces Java language access
control, and the underlying field is inaccessible,
the method throws an IllegalAccessException.
If the underlying field is final, the method throws
an IllegalAccessException.
If the underlying field is of a primitive type, an
unwrapping conversion is attempted to convert the
new value to a value of a primitive type. If this
attempt fails, the method throws an
IllegalArgumentException.
If, after possible unwrapping, the new value
cannot be converted to the type of the underlying
field by an identity or widening conversion, the
method throws an IllegalArgumentException.
The field is set to the possibly unwrapped and
widened new value.
setBoolean
public void setBoolean(Object obj,
boolean z)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a boolean on specified
object.
setByte
public void setByte(Object obj,
byte b)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a byte on specified
object.
setChar
public void setChar(Object obj,
char c)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a char on specified
object.
setDeclaringClass
public void setDeclaringClass(Class declaringClass)
Returns the Class object representing the class that
declares the constructor represented by this
Constructor object.
- setDeclaringClass in interface Member
setDouble
public void setDouble(Object obj,
double d)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a double on specified
object.
setFloat
public void setFloat(Object obj,
float f)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a float on specified
object.
setInitializer
public void setInitializer(String i)
throws SynthesisException
Method setInitializer
setInt
public void setInt(Object obj,
int i)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as an int on specified
object.
setLong
public void setLong(Object obj,
long l)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a long on specified
object.
setModifiers
public void setModifiers(int modifiers)
throws SynthesisException
Insert the method's description here.
Creation date: (12-25-99 1:28:28 PM)
- setModifiers in interface Member
setShort
public void setShort(Object obj,
short s)
throws IllegalArgumentException,
IllegalAccessException
Set the value of a field as a short on specified
object.
toSource
public String toSource()
Output the Field as Java sourcecode
toString
public String toString()
Return a string describing this Field. The format is
the access modifiers for the field, if any, followed
by the field type, followed by a space, followed by
the fully-qualified name of the class declaring the
field, followed by a period, followed by the name
of the field. For example:
public static final int java.lang.Thread.MIN_PRIORITY
private int java.io.FileDescriptor.fd
The modifiers are placed in canonical order as
specified by "The Java Language Specification".
This is public, protected or private first,
and then other modifiers in the following order:
static, final, transient, volatile.