Class.getDeclaredField()

源码

    @CallerSensitive
    public Field getDeclaredField(String name)
        throws NoSuchFieldException, SecurityException {
        checkMemberAccess(Member.DECLARED, Reflection.getCallerClass(), true);
        Field field = searchFields(privateGetDeclaredFields(false), name);
        if (field == null) {
            throw new NoSuchFieldException(name);
        }
        return field;
    }

简述

该函数用于获取类或接口中指定的声明字段的Field对象。函数通过参数name指定字段的简单名称。

`Class.getDeclaredField()` 方法是 Java 中的反射 API 之一，在运行时用于获取指定类中的特定字段（属性）。该方法返回一个 `Field` 对象，表示指定类中的字段。

示例代码

演示如何使用 `Class.getDeclaredField()` 方法获取某个类中的字段：

```java
import java.lang.reflect.Field;

public class Main {
public static void main(String[] args) {
try {
// 获取指定类的 Class 对象
Class<?> clazz = MyClass.class;

// 获取指定字段名为 "name" 的字段
Field field = clazz.getDeclaredField("name");

// 输出字段的名称和类型
System.out.println("Field name: " + field.getName());
System.out.println("Field type: " + field.getType().getName());
} catch (NoSuchFieldException e) {
e.printStackTrace();
}
}
}

class MyClass {
public String name;
private int age;
}
```

在上面的示例中，我们首先获取了 `MyClass` 类的 `Class` 对象，然后使用 `getDeclaredField("name")` 方法获取了该类中名为 "name" 的字段。最后，我们输出了该字段的名称和类型。

需要注意的是，`getDeclaredField()` 方法会查找指定名称的字段，如果该字段不存在或不可访问，则会抛出 `NoSuchFieldException` 异常。因此，在使用时要注意异常的处理。
 

具体来说，该函数执行以下操作：

检查是否有权限访问声明字段，如果没有权限则抛出SecurityException异常。

调用privateGetDeclaredFields(false)方法获取所有声明字段的Field对象数组。

在字段数组中搜索与参数name匹配的字段。

如果找到匹配的字段，则返回该字段的Field对象；否则，抛出NoSuchFieldException异常。

注意

如果该Class对象表示一个数组类型，则该方法不会查找数组类型的length字段。
该函数可能抛出以下异常：
        NoSuchFieldException：如果找不到具有指定名称的字段。
        NullPointerException：如果参数name为null。
        SecurityException：如果存在安全 manager，并且满足以下条件之一：

调用者的类加载器与该类的类加载器不相同，并且通过调用SecurityManager.checkPermission方法使用RuntimePermission("accessDeclaredMembers")拒绝访问声明字段。

调用者的类加载器与当前类的类加载器不相同或不是其祖先，并且通过调用SecurityManager.checkPackageAccess方法拒绝访问该类的包。