This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git
commit f6b50840f1f91e83cec2a26fd8d91f1d4b2c0714
Author: Gary D. Gregory <garydgreg...@gmail.com>
AuthorDate: Fri Mar 21 09:39:14 2025 -0400
Javadoc
---
.../apache/commons/lang3/reflect/FieldUtils.java | 294 ++++++++++-----------
1 file changed, 147 insertions(+), 147 deletions(-)
diff --git a/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
b/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
index d185bcb9a..05476e051 100644
--- a/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
+++ b/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
@@ -51,7 +51,7 @@ public class FieldUtils {
* the {@link Class} to query
* @return an array of Fields (possibly empty).
* @throws NullPointerException
- * if the class is {@code null}
+ * if the class is {@code null}.
* @since 3.2
*/
public static Field[] getAllFields(final Class<?> cls) {
@@ -65,7 +65,7 @@ public static Field[] getAllFields(final Class<?> cls) {
* the {@link Class} to query
* @return a list of Fields (possibly empty).
* @throws NullPointerException
- * if the class is {@code null}
+ * if the class is {@code null}.
* @since 3.2
*/
public static List<Field> getAllFieldsList(final Class<?> cls) {
@@ -86,12 +86,12 @@ public static List<Field> getAllFieldsList(final Class<?>
cls) {
* @param cls
* the {@link Class} to reflect, must not be {@code null}
* @param fieldName
- * the field name to obtain
- * @return the Field object
+ * the field name to obtain.
+ * @return the Field object.
* @throws NullPointerException
- * if the class is {@code null}
+ * if the class is {@code null}.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, or empty
+ * if the field name is {@code null}, blank, or empty.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -104,18 +104,18 @@ public static Field getDeclaredField(final Class<?> cls,
final String fieldName)
* considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @return the Field object
* @throws NullPointerException
- * if the class is {@code null}
+ * if the class is {@code null}.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, or empty
+ * if the field name is {@code null}, blank, or empty.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -142,12 +142,12 @@ public static Field getDeclaredField(final Class<?> cls,
final String fieldName,
* Gets an accessible {@link Field} by name respecting scope.
Superclasses/interfaces will be considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
- * @return the Field object
+ * the field name to obtain.
+ * @return the Field object.
* @throws NullPointerException
- * if the class is {@code null}
+ * if the class is {@code null}.
* @throws IllegalArgumentException
* if the field name is {@code null}, blank, or empty
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -162,17 +162,17 @@ public static Field getField(final Class<?> cls, final
String fieldName) {
* considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
- * @return the Field object
- * @throws NullPointerException if the class is {@code null}
+ * @return the Field object.
+ * @throws NullPointerException if the class is {@code null}.
* @throws IllegalArgumentException if the field name is blank or empty or
is matched at multiple places
- * in the inheritance hierarchy
+ * in the inheritance hierarchy.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -230,12 +230,12 @@ public static Field getField(final Class<?> cls, final
String fieldName, final b
/**
* Gets all fields of the given class and its parents (if any) that are
annotated with the given annotation.
* @param cls
- * the {@link Class} to query
+ * the {@link Class} to query.
* @param annotationCls
- * the {@link Annotation} that must be present on a field to be
matched
+ * the {@link Annotation} that must be present on a field to be
matched.
* @return a list of Fields (possibly empty).
* @throws NullPointerException
- * if the class or annotation are {@code null}
+ * if the class or annotation are {@code null}.
* @since 3.4
*/
public static List<Field> getFieldsListWithAnnotation(final Class<?> cls,
final Class<? extends Annotation> annotationCls) {
@@ -246,12 +246,12 @@ public static List<Field>
getFieldsListWithAnnotation(final Class<?> cls, final
/**
* Gets all fields of the given class and its parents (if any) that are
annotated with the given annotation.
* @param cls
- * the {@link Class} to query
+ * the {@link Class} to query.
* @param annotationCls
* the {@link Annotation} that must be present on a field to be
matched
* @return an array of Fields (possibly empty).
* @throws NullPointerException
- * if the class or annotation are {@code null}
+ * if the class or annotation are {@code null}.
* @since 3.4
*/
public static Field[] getFieldsWithAnnotation(final Class<?> cls, final
Class<? extends Annotation> annotationCls) {
@@ -262,14 +262,14 @@ public static Field[] getFieldsWithAnnotation(final
Class<?> cls, final Class<?
* Reads the named {@code public} {@link Field}. Only the class of the
specified object will be considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
- * @return the value of the field
+ * the field name to obtain.
+ * @return the value of the field.
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
- * if {@code fieldName} is {@code null}, blank or empty, or
could not be found
+ * if {@code fieldName} is {@code null}, blank or empty, or
could not be found.
* @throws IllegalAccessException
* if the named field is not {@code public}
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -283,20 +283,20 @@ public static Object readDeclaredField(final Object
target, final String fieldNa
* Gets a {@link Field} value by name. Only the class of the specified
object will be considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match public fields.
- * @return the Field object
+ * @return the Field object.
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
- * if {@code fieldName} is {@code null}, blank or empty, or
could not be found
+ * if {@code fieldName} is {@code null}, blank or empty, or
could not be found.
* @throws IllegalAccessException
- * if the field is not made accessible
+ * if the field is not made accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -314,14 +314,14 @@ public static Object readDeclaredField(final Object
target, final String fieldNa
* class will be considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
- * @return the value of the field
+ * the field name to obtain.
+ * @return the value of the field.
* @throws NullPointerException
- * if the class is {@code null}, or the field could not be
found
+ * if the class is {@code null}, or the field could not be
found.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, empty, or is not
{@code static}
+ * if the field name is {@code null}, blank, empty, or is not
{@code static}.
* @throws IllegalAccessException
* if the field is not accessible
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -335,18 +335,18 @@ public static Object readDeclaredStaticField(final
Class<?> cls, final String fi
* Gets the value of a {@code static} {@link Field} by name. Only the
specified class will be considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @return the Field object
* @throws NullPointerException
- * if the class is {@code null}, or the field could not be
found
+ * if the class is {@code null}, or the field could not be
found.
* @throws IllegalArgumentException
- * if the field name is blank or empty, is not {@code static}
+ * if the field name is blank or empty, is not {@code static}.
* @throws IllegalAccessException
* if the field is not made accessible
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -363,14 +363,14 @@ public static Object readDeclaredStaticField(final
Class<?> cls, final String fi
* Reads an accessible {@link Field}.
*
* @param field
- * the field to use
+ * the field to use.
* @param target
- * the object to call on, may be {@code null} for {@code
static} fields
+ * the object to call on, may be {@code null} for {@code
static} fields.
* @return the field value
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalAccessException
- * if the field is not accessible
+ * if the field is not accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -382,17 +382,17 @@ public static Object readField(final Field field, final
Object target) throws Il
* Reads a {@link Field}.
*
* @param field
- * the field to use
+ * the field to use.
* @param target
- * the object to call on, may be {@code null} for {@code
static} fields
+ * the object to call on, may be {@code null} for {@code
static} fields.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
* @return the field value
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalAccessException
- * if the field is not made accessible
+ * if the field is not made accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -412,16 +412,16 @@ public static Object readField(final Field field, final
Object target, final boo
* Reads the named {@code public} {@link Field}. Superclasses will be
considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
- * @return the value of the field
+ * the field name to obtain.
+ * @return the value of the field.
* @throws NullPointerException
- * if the target is {@code null}
+ * if the target is {@code null}.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, empty, or could
not be found
+ * if the field name is {@code null}, blank, empty, or could
not be found.
* @throws IllegalAccessException
- * if the named field is not {@code public}
+ * if the named field is not {@code public}.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -433,20 +433,20 @@ public static Object readField(final Object target, final
String fieldName) thro
* Reads the named {@link Field}. Superclasses will be considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @return the field value
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, empty, or could
not be found
+ * if the field name is {@code null}, blank, empty, or could
not be found.
* @throws IllegalAccessException
- * if the named field is not made accessible
+ * if the named field is not made accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -463,16 +463,16 @@ public static Object readField(final Object target, final
String fieldName, fina
* Reads the named {@code public static} {@link Field}. Superclasses will
be considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
- * @return the value of the field
+ * the field name to obtain.
+ * @return the value of the field.
* @throws NullPointerException
- * if the class is {@code null}, or the field could not be
found
+ * if the class is {@code null}, or the field could not be
found.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank or empty, or is
not {@code static}
+ * if the field name is {@code null}, blank or empty, or is
not {@code static}.
* @throws IllegalAccessException
- * if the field is not accessible
+ * if the field is not accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -484,20 +484,20 @@ public static Object readStaticField(final Class<?> cls,
final String fieldName)
* Reads the named {@code static} {@link Field}. Superclasses will be
considered.
*
* @param cls
- * the {@link Class} to reflect, must not be {@code null}
+ * the {@link Class} to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
- * @return the Field object
+ * @return the Field object.
* @throws NullPointerException
- * if the class is {@code null}, or the field could not be
found
+ * if the class is {@code null}, or the field could not be
found.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank or empty, or is
not {@code static}
+ * if the field name is {@code null}, blank or empty, or is
not {@code static}.
* @throws IllegalAccessException
- * if the field is not made accessible
+ * if the field is not made accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -512,12 +512,12 @@ public static Object readStaticField(final Class<?> cls,
final String fieldName,
* Reads an accessible {@code static} {@link Field}.
*
* @param field
- * to read
- * @return the field value
+ * to read.
+ * @return the field value.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalArgumentException
- * if the field is not {@code static}
+ * if the field is not {@code static}.
* @throws IllegalAccessException
* if the field is not accessible
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -531,17 +531,17 @@ public static Object readStaticField(final Field field)
throws IllegalAccessExce
* Reads a static {@link Field}.
*
* @param field
- * to read
+ * to read.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
- * @return the field value
+ * @return the field value.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalArgumentException
- * if the field is not {@code static}
+ * if the field is not {@code static}.
* @throws IllegalAccessException
- * if the field is not made accessible
+ * if the field is not made accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -555,9 +555,9 @@ public static Object readStaticField(final Field field,
final boolean forceAcces
* Removes the final modifier from a {@link Field}.
*
* @param field
- * to remove the final modifier
+ * to remove the final modifier.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
* @since 3.2
@@ -570,13 +570,13 @@ public static void removeFinalModifier(final Field field)
{
* Removes the final modifier from a {@link Field}.
*
* @param field
- * to remove the final modifier
+ * to remove the final modifier.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
* @deprecated As of Java 12, we can no longer drop the {@code final}
modifier, thus
@@ -619,16 +619,16 @@ public static void removeFinalModifier(final Field field,
final boolean forceAcc
* Writes a {@code public} {@link Field}. Only the specified class will be
considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param value
- * to set
+ * the new value.
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
* if {@code fieldName} is {@code null}, blank or empty, or
could not be found,
- * or {@code value} is not assignable
+ * or {@code value} is not assignable.
* @throws IllegalAccessException
* if the field is not made accessible
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -642,11 +642,11 @@ public static void writeDeclaredField(final Object
target, final String fieldNam
* Writes a {@code public} {@link Field}. Only the specified class will be
considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param value
- * to set
+ * the new value.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
@@ -673,15 +673,15 @@ public static void writeDeclaredField(final Object
target, final String fieldNam
* Writes a named {@code public static} {@link Field}. Only the specified
class will be considered.
*
* @param cls
- * {@link Class} on which the field is to be found
+ * {@link Class} on which the field is to be found.
* @param fieldName
- * to write
+ * to write.
* @param value
- * to set
+ * the new value.
* @throws NullPointerException
- * if {@code cls} is {@code null} or the field cannot be
located
+ * if {@code cls} is {@code null} or the field cannot be
located.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, empty, not {@code
static}, or {@code value} is not assignable
+ * if the field name is {@code null}, blank, empty, not {@code
static}, or {@code value} is not assignable.
* @throws IllegalAccessException
* if the field is not {@code public} or is {@code final}
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -695,18 +695,18 @@ public static void writeDeclaredStaticField(final
Class<?> cls, final String fie
* Writes a named {@code static} {@link Field}. Only the specified class
will be considered.
*
* @param cls
- * {@link Class} on which the field is to be found
+ * {@link Class} on which the field is to be found.
* @param fieldName
* to write
* @param value
- * to set
+ * the new value.
* @param forceAccess
* whether to break scope restrictions using the {@code
AccessibleObject#setAccessible(boolean)} method.
* {@code false} will only match {@code public} fields.
* @throws NullPointerException
- * if {@code cls} is {@code null} or the field cannot be
located
+ * if {@code cls} is {@code null} or the field cannot be
located.
* @throws IllegalArgumentException
- * if the field name is {@code null}, blank, empty, not {@code
static}, or {@code value} is not assignable
+ * if the field name is {@code null}, blank, empty, not {@code
static}, or {@code value} is not assignable.
* @throws IllegalAccessException
* if the field is not made accessible or is {@code final}
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -724,17 +724,17 @@ public static void writeDeclaredStaticField(final
Class<?> cls, final String fie
* Writes an accessible {@link Field}.
*
* @param field
- * to write
+ * to write.
* @param target
- * the object to call on, may be {@code null} for {@code
static} fields
+ * the object to call on, may be {@code null} for {@code
static} fields.
* @param value
- * to set
+ * the new value.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalArgumentException
- * if {@code value} is not assignable
+ * if {@code value} is not assignable.
* @throws IllegalAccessException
- * if the field is not accessible or is {@code final}
+ * if the field is not accessible or is {@code final}.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -746,19 +746,19 @@ public static void writeField(final Field field, final
Object target, final Obje
* Writes a {@link Field}.
*
* @param field
- * to write
+ * to write.
* @param target
* the object to call on, may be {@code null} for {@code
static} fields
* @param value
- * to set
+ * the new value.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalArgumentException
- * if {@code value} is not assignable
+ * if {@code value} is not assignable.
* @throws IllegalAccessException
* if the field is not made accessible or is {@code final}
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -779,18 +779,18 @@ public static void writeField(final Field field, final
Object target, final Obje
* Writes a {@code public} {@link Field}. Superclasses will be considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param value
- * to set
+ * the new value.
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
* if {@code fieldName} is {@code null}, blank, empty, or
could not be found,
- * or {@code value} is not assignable
+ * or {@code value} is not assignable.
* @throws IllegalAccessException
- * if the field is not accessible
+ * if the field is not accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -802,22 +802,22 @@ public static void writeField(final Object target, final
String fieldName, final
* Writes a {@link Field}. Superclasses will be considered.
*
* @param target
- * the object to reflect, must not be {@code null}
+ * the object to reflect, must not be {@code null}.
* @param fieldName
- * the field name to obtain
+ * the field name to obtain.
* @param value
- * to set
+ * the new value.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
* if {@code fieldName} is {@code null}, blank, empty, or
could not be found,
- * or {@code value} is not assignable
+ * or {@code value} is not assignable.
* @throws IllegalAccessException
- * if the field is not made accessible
+ * if the field is not made accessible.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -835,16 +835,16 @@ public static void writeField(final Object target, final
String fieldName, final
* Writes a named {@code public static} {@link Field}. Superclasses will
be considered.
*
* @param cls
- * {@link Class} on which the field is to be found
+ * {@link Class} on which the field is to be found.
* @param fieldName
- * to write
+ * to write.
* @param value
- * to set
+ * the new value.
* @throws NullPointerException
- * if {@code target} is {@code null}
+ * if {@code target} is {@code null}.
* @throws IllegalArgumentException
* if {@code fieldName} is {@code null}, blank or empty, the
field cannot be located or is
- * not {@code static}, or {@code value} is not assignable
+ * not {@code static}, or {@code value} is not assignable.
* @throws IllegalAccessException
* if the field is not {@code public} or is {@code final}
* @throws SecurityException if an underlying accessible object's method
denies the request.
@@ -858,21 +858,21 @@ public static void writeStaticField(final Class<?> cls,
final String fieldName,
* Writes a named {@code static} {@link Field}. Superclasses will be
considered.
*
* @param cls
- * {@link Class} on which the field is to be found
+ * {@link Class} on which the field is to be found.
* @param fieldName
- * to write
+ * to write.
* @param value
- * to set
+ * the new value.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @throws NullPointerException
- * if {@code cls} is {@code null} or the field cannot be
located
+ * if {@code cls} is {@code null} or the field cannot be
located.
* @throws IllegalArgumentException
- * if {@code fieldName} is {@code null}, blank or empty, the
field not {@code static}, or {@code value} is not assignable
+ * if {@code fieldName} is {@code null}, blank or empty, the
field not {@code static}, or {@code value} is not assignable.
* @throws IllegalAccessException
- * if the field is not made accessible or is {@code final}
+ * if the field is not made accessible or is {@code final}.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -888,15 +888,15 @@ public static void writeStaticField(final Class<?> cls,
final String fieldName,
* Writes a {@code public static} {@link Field}.
*
* @param field
- * to write
+ * to write.
* @param value
- * to set
+ * the new value.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalArgumentException
- * if the field is not {@code static}, or {@code value} is
not assignable
+ * if the field is not {@code static}, or {@code value} is
not assignable.
* @throws IllegalAccessException
- * if the field is not {@code public} or is {@code final}
+ * if the field is not {@code public} or is {@code final}.
* @throws SecurityException if an underlying accessible object's method
denies the request.
* @see SecurityManager#checkPermission
*/
@@ -908,17 +908,17 @@ public static void writeStaticField(final Field field,
final Object value) throw
* Writes a static {@link Field}.
*
* @param field
- * to write
+ * to write.
* @param value
- * to set
+ * the new value.
* @param forceAccess
* whether to break scope restrictions using the
* {@link AccessibleObject#setAccessible(boolean)} method.
{@code false} will only
* match {@code public} fields.
* @throws NullPointerException
- * if the field is {@code null}
+ * if the field is {@code null}.
* @throws IllegalArgumentException
- * if the field is not {@code static}, or {@code value} is
not assignable
+ * if the field is not {@code static}, or {@code value} is
not assignable.
* @throws IllegalAccessException
* if the field is not made accessible or is {@code final}
* @throws SecurityException if an underlying accessible object's method
denies the request.
