jdk-sandbox: comparison jdk/src/share/classes/java/lang/reflect/Field.java

equal deleted inserted replaced

-:5cf29386a520
+:b2e8758b10fd
 * specified {@code obj} argument is null, the method throws a
 * {@code NullPointerException}. If the specified object is not an
 * instance of the class or interface declaring the underlying
 * field, the method throws an {@code IllegalArgumentException}.
 *
-* <p>If this {@code Field} object enforces Java language access control, and
+* <p>If this {@code Field} object is enforcing Java language access control, and
 * the underlying field is inaccessible, the method throws an
 * {@code IllegalAccessException}.
 * If the underlying field is static, the class that declared the
 * field is initialized if it has not already been initialized.
 *
 * to be extracted
 * @return the value of the represented field in object
 * {@code obj}; primitive values are wrapped in an appropriate
 * object before being returned
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof).
 * @exception NullPointerException      if the specified object is null
 *              and the field is an instance field.
 *
 * @param obj the object to extract the {@code boolean} value
 * from
 * @return the value of the {@code boolean} field
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code boolean} by a
 *
 * @param obj the object to extract the {@code byte} value
 * from
 * @return the value of the {@code byte} field
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code byte} by a
 *
 * @param obj the object to extract the {@code char} value
 * from
 * @return the value of the field converted to type {@code char}
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code char} by a
 *
 * @param obj the object to extract the {@code short} value
 * from
 * @return the value of the field converted to type {@code short}
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code short} by a
 *
 * @param obj the object to extract the {@code int} value
 * from
 * @return the value of the field converted to type {@code int}
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code int} by a
 *
 * @param obj the object to extract the {@code long} value
 * from
 * @return the value of the field converted to type {@code long}
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code long} by a
 *
 * @param obj the object to extract the {@code float} value
 * from
 * @return the value of the field converted to type {@code float}
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code float} by a
 *
 * @param obj the object to extract the {@code double} value
 * from
 * @return the value of the field converted to type {@code double}
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is inaccessible.
 * @exception IllegalArgumentException  if the specified object is not
 *              an instance of the class or interface declaring the
 *              underlying field (or a subclass or implementor
 *              thereof), or if the field value cannot be
 *              converted to the type {@code double} by a
 * specified object argument is null, the method throws a
 * {@code NullPointerException}.  If the specified object argument is not
 * an instance of the class or interface declaring the underlying
 * field, the method throws an {@code IllegalArgumentException}.
 *
-* <p>If this {@code Field} object enforces Java language access control, and
+* <p>If this {@code Field} object is enforcing Java language access control, and
 * the underlying field is inaccessible, the method throws an
 * {@code IllegalAccessException}.
 *
 * <p>If the underlying field is final, the method throws an
-* {@code IllegalAccessException} unless
+* {@code IllegalAccessException} unless {@code setAccessible(true)}
-* {@code setAccessible(true)} has succeeded for this field
+* has succeeded for this {@code Field} object
-* and this field is non-static. Setting a final field in this way
+* and the field is non-static. Setting a final field in this way
 * is meaningful only during deserialization or reconstruction of
 * instances of classes with blank final fields, before they are
 * made available for access by other parts of a program. Use in
 * any other context may have unpredictable effects, including cases
 * in which other parts of a program continue to use the original
 *
 * @param obj the object whose field should be modified
 * @param value the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param z   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param b   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param c   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param s   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param i   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param l   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param f   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null
 *
 * @param obj the object whose field should be modified
 * @param d   the new value for the field of {@code obj}
 * being modified
 *
-* @exception IllegalAccessException    if the underlying field
+* @exception IllegalAccessException    if this {@code Field} object
-*              is inaccessible.
+*              is enforcing Java language access control and the underlying
+*              field is either inaccessible or final.
 * @exception IllegalArgumentException  if the specified object is not an
 *              instance of the class or interface declaring the underlying
 *              field (or a subclass or implementor thereof),
 *              or if an unwrapping conversion fails.
 * @exception NullPointerException      if the specified object is null

changeset 9022	b2e8758b10fd
parent 5506	202f599c92aa
child 9029	e92fcf58f684