Java Class类中getDeclaredFields方法详解

getDeclaredFields() 是 Java 反射 API 中的一个方法，用于获取一个类中声明的所有字段（包括私有、受保护、默认（包）访问和公共字段，但不包括继承的字段）。这个方法返回一个 Field 对象数组，表示该类中声明的所有字段。

方法签名

public Field[] getDeclaredFields() throws SecurityException

参数

• 无参数。

返回值

返回一个 Field 对象数组，表示该类中声明的所有字段。数组中的元素顺序没有保证。

异常

• SecurityException：如果存在安全管理器，且它不允许访问该类的字段。

示例

假设我们有一个名为 Person 的类，它有三个字段：name、age 和 address。

public class Person {
    private String name;
    protected int age;
    String address;
}

我们可以使用 getDeclaredFields() 方法获取 Person 类中声明的所有字段：

import java.lang.reflect.Field;

public class Main {
    public static void main(String[] args) {
        try {
            Class<?> clazz = Person.class;
            Field[] fields = clazz.getDeclaredFields();

            for (Field field : fields) {
                System.out.println("Field name: " + field.getName());
                System.out.println("Field type: " + field.getType());
                System.out.println("Modifiers: " + Modifier.toString(field.getModifiers()));
                System.out.println();
            }
        } catch (SecurityException e) {
            e.printStackTrace();
        }
    }
}

输出结果：

Field name: name
Field type: class java.lang.String
Modifiers: private

Field name: age
Field type: int
Modifiers: protected

Field name: address
Field type: class java.lang.String
Modifiers:

注意事项

• getDeclaredFields() 方法只返回类本身声明的字段，不包括继承的字段。如果需要获取继承的字段，可以使用 getFields() 方法。
• getDeclaredFields() 方法返回的字段数组不包含静态字段。如果需要获取静态字段，可以使用 getDeclaredFields() 方法结合 Modifier.isStatic() 方法进行筛选。
• 使用反射访问私有字段时，可能需要调用 field.setAccessible(true) 方法来绕过 Java 语言的访问控制检查。但请注意，这可能会导致安全问题，因此在使用时要谨慎。