如何通过反射获取对象的所有层级属性描述符-js教程-PHP中文网

通过递归遍历对象属性并组合propertydescriptor，可获取所有层级属性描述符（如user.address.city），需处理嵌套类型、集合、泛型、访问权限及循环引用；推荐优先使用spring的beanwrapperimpl。

如何通过反射获取对象的所有层级属性描述符

通过反射获取对象的所有层级属性描述符，核心在于递归遍历对象的属性（包括嵌套对象的属性），并为每个属性构建对应的 PropertyDescriptor（Java）或等效描述结构（如 C# 的 PropertyInfo）。以下以 Java 为主说明通用思路和关键实现要点。

理解“层级属性描述符”的含义

“所有层级”指不仅获取当前对象直接声明的属性（如 user.name），还包括其嵌套对象的属性（如 user.address.city、user.profile.settings.theme）。每个“属性路径”对应一个可读写的描述符，需能支持后续的 get/set 操作。

注意：PropertyDescriptor 本身只描述单层属性（如 name），要支持多级路径（如 address.city），需自行封装路径解析逻辑，或组合多个 PropertyDescriptor 构建链式访问器。

Java 中递归获取嵌套属性描述符

步骤如下：

使用 Introspector.getBeanInfo(clazz) 获取当前类的全部直接属性描述符（PropertyDescriptor[]）
对每个描述符，检查其 getPropertyType() 是否为非基础类型（如不是 String、int、LocalDateTime 等常见不可嵌套类型）且不是集合/数组（除非你明确要展开元素）
若满足嵌套条件（如是自定义 POJO 类），递归调用自身，传入该属性类型，并将当前属性名作为前缀（如 "address."）拼接到子属性名前
收集所有路径（如 "name"、"address.city"、"address.zipCode"）及其对应的访问器（可封装为 PropertyAccessor 或含 getter/setter 方法引用的对象）

示例片段（简化）：

public Map<string propertydescriptor> getAllLevelDescriptors(Object obj) {
    return doGetDescriptors("", obj.getClass(), new LinkedHashMap());
}
private Map<string propertydescriptor> doGetDescriptors(
        String prefix, Class> clazz, Map<string propertydescriptor> result) {
    try {
        for (PropertyDescriptor pd : Introspector.getBeanInfo(clazz).getPropertyDescriptors()) {
            if ("class".equals(pd.getName())) continue;
            String fullPath = prefix.isEmpty() ? pd.getName() : prefix + "." + pd.getName();
            result.put(fullPath, pd);
            Class> nestedType = pd.getPropertyType();
            if (isBeanType(nestedType)) { // 自定义判断：非基本、非字符串、非日期/时间类、非集合
                doGetDescriptors(fullPath, nestedType, result);
            }
        }
    } catch (IntrospectionException e) {
        // 忽略或记录
    }
    return result;
}
</string></string></string>

处理集合、泛型与边界情况

实际应用中需额外考虑：

集合类型：如 List<address></address>，通常不自动展开每个元素，但可约定支持 addresses[0].city 形式——这需要解析方括号语法，并在运行时按索引访问
泛型擦除：反射无法直接获知 List<address></address> 中的 Address，需结合 Field.getGenericType() 和 ParameterizedType 解析
访问权限：私有属性需调用 pd.getReadMethod().setAccessible(true) 才能读取
循环引用：对象 A 引用 B，B 又引用 A —— 必须用 Set<class>></class> 记录已遍历类型，避免无限递归

替代方案：使用成熟工具库

手动实现易出错且难覆盖所有边界。推荐优先使用：

Apache Commons BeanUtils：提供 PropertyUtils.describe(obj)（返回扁平 map），但不直接支持深层路径；可配合 NestedNullException 和自定义 PropertyUtilsBean 扩展
Spring Framework：BeanWrapperImpl 原生支持嵌套路径（如 wrapper.setPropertyValue("address.city", "Shanghai")），其内部已实现完整解析与缓存机制
Objenesis + Reflections：适合元数据扫描场景，但不直接提供运行时属性访问器