lang/reflect/Field.java

46  * A {@code Field} provides information about, and dynamic access to, a
50  * <p>A {@code Field} permits widening conversions to occur during a get or
66 class Field extends AccessibleObject implements Member {
85     // currently only two levels deep (i.e., one root Field and
86     // potentially many Field objects pointing to it.)
90     private Field               root;
120     Field(Class<?> declaringClass,
139      * ReflectAccess) which returns a copy of this Field. The copy's
140      * "root" field points to this Field.
142     Field copy() {
144         // among Field objects which refer to the same underlying
151             throw new IllegalArgumentException("Can not copy a non-root Field");
153         Field res = new Field(clazz, name, type, modifiers, slot, signature, annotations);
181      * that declares the field represented by this {@code Field} object.
189      * Returns the name of the field represented by this {@code Field} object.
197      * by this {@code Field} object, as an integer. The {@code Modifier} class should
233      * {@code Field} object.
244      * the field represented by this {@code Field} object.
254      *     the field represented by this {@code Field} object
275      * Compares this {@code Field} against the specified object.  Returns
276      * true if the objects are the same.  Two {@code Field} objects are the same if
281         if (obj != null && obj instanceof Field) {
282             Field other = (Field)obj;
291      * Returns a hashcode for this {@code Field}.  This is computed as the
300      * Returns a string describing this {@code Field}.  The format is
317      * @return a string describing this {@code Field}
318      * @jls 8.3.1 Field Modifiers
334      * Returns a string describing this {@code Field}, including
347      * @return a string describing this {@code Field}, including
351      * @jls 8.3.1 Field Modifiers
363      * Returns the value of the field represented by this {@code Field}, on
378      * <p>If this {@code Field} object is enforcing Java language access control, and
398      * @exception IllegalAccessException    if this {@code Field} object
428      * @exception IllegalAccessException    if this {@code Field} object
441      * @see       Field#get
462      * @exception IllegalAccessException    if this {@code Field} object
475      * @see       Field#get
498      * @exception IllegalAccessException    if this {@code Field} object
511      * @see Field#get
534      * @exception IllegalAccessException    if this {@code Field} object
547      * @see       Field#get
570      * @exception IllegalAccessException    if this {@code Field} object
583      * @see       Field#get
606      * @exception IllegalAccessException    if this {@code Field} object
619      * @see       Field#get
642      * @exception IllegalAccessException    if this {@code Field} object
655      * @see Field#get
678      * @exception IllegalAccessException    if this {@code Field} object
691      * @see       Field#get
706      * Sets the field represented by this {@code Field} object on the
722      * <p>If this {@code Field} object is enforcing Java language access control, and
728      * has succeeded for this {@code Field} object
759      * @exception IllegalAccessException    if this {@code Field} object
794      * @exception IllegalAccessException    if this {@code Field} object
805      * @see       Field#set
830      * @exception IllegalAccessException    if this {@code Field} object
841      * @see       Field#set
866      * @exception IllegalAccessException    if this {@code Field} object
877      * @see       Field#set
902      * @exception IllegalAccessException    if this {@code Field} object
913      * @see       Field#set
938      * @exception IllegalAccessException    if this {@code Field} object
949      * @see       Field#set
974      * @exception IllegalAccessException    if this {@code Field} object
985      * @see       Field#set
1010      * @exception IllegalAccessException    if this {@code Field} object
1021      * @see       Field#set
1046      * @exception IllegalAccessException    if this {@code Field} object
1057      * @see       Field#set
1091     // for a given Field. However, avoiding synchronization will
1112     // Returns FieldAccessor for this Field object, not looking up
1118     // Sets the FieldAccessor for this Field object and
1166                     Field root = this.root;
1187      * the declared type of the field represented by this Field.
1189      * represented by this Field