Java Introspector 的 stopClass 怎样排除继承属性

用 JavaBeans Introspector 读取子类属性时，继承链上的 getter 也会被分析，连 Object.getClass() 对应的 class 属性都可能出现在结果里。要排除某个父类及其更上层的属性，直接使用 Introspector.getBeanInfo(Bean.class, stopClass)：分析会停在指定的 stopClass，该类和它的父类不会进入属性描述集合。

官方 API：https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/beans/Introspector.html

先看默认结果：继承属性从哪里混进来

JavaBeans 的属性不是字段扫描，而是根据公开方法和命名模式识别 getter、setter。假设 BaseBean 提供 getId()，ChildBean 提供 getName()，默认调用会沿父类继续分析。最容易误判的是 Object.getClass()：它满足 getter 形态，所以可能被描述成名为 class 的属性。

排查时先把属性名打印出来，基线应关注集合中的实体，而不是只看属性数量。下面的代码只负责建立对照表，不依赖字段可见性：

import java.beans.BeanInfo;
import java.beans.Introspector;
import java.beans.PropertyDescriptor;

public class BeanProperties {
    public static void main(String[] args) throws Exception {
        // 默认从 ChildBean 一直分析到 Object，建立未截断的基线集合。
        BeanInfo info = Introspector.getBeanInfo(ChildBean.class);
        for (PropertyDescriptor property : info.getPropertyDescriptors()) {
            // 属性名比数量更适合定位 class、id 等继承成员。
            System.out.println(property.getName());
        }
    }
}

stopClass 截断的是哪一段继承链

stopClass 不是“只删除一个同名属性”的过滤器，而是继承分析的停止点。要让子类保留自己的属性、排除 BaseBean 及其父类，调用方式是：

BeanInfo info = Introspector.getBeanInfo(ChildBean.class, BaseBean.class);

for (PropertyDescriptor property : info.getPropertyDescriptors()) {
    // 这里得到的是 ChildBean 这一侧的 JavaBeans 属性描述。
    System.out.println(property.getName());
}

如果只是想去掉 class，常用写法是 Introspector.getBeanInfo(ChildBean.class, Object.class)。文档定义的边界是：stopClass 及其父类中的方法、属性和事件都忽略，因此它必须是目标类继承链中的实际基类；把一个无关类当作停止点，不能替代精确的属性筛选。

用 PropertyDescriptor 核对排除结果

最稳妥的验证是按名称检查返回集合。可以把它理解成下面这张边界表：

如果框架还需要排除某一个不连续的属性，例如只去掉 audit 而保留同一父类的 id，就不要滥用 stopClass，而应在得到描述符后按属性名建立白名单或黑名单。这样能把“继承边界”和“业务字段选择”分成两层，后续维护更清楚。

Set names = new LinkedHashSet();
for (PropertyDescriptor property : info.getPropertyDescriptors()) {
    // 只收集描述符名称，避免把 Method 实例暴露给后续业务层。
    names.add(property.getName());
}
if (names.contains("class")) {
    // 说明当前 stopClass 没有把 Object 排除，先修正边界再过滤字段。
    throw new IllegalStateException("unexpected inherited property: class");
}

实际使用时的边界清单

• getter 才是入口：没有符合 JavaBeans 命名规则的公开访问器，字段本身不会因为存在就自动成为属性。
• stopClass 不是字段黑名单：它按继承层级截断，不能表达“同一父类只排除一个属性”。
• 异常要留在边界：getBeanInfo 可能抛出 IntrospectionException，批量扫描时应记录具体 Bean，而不是吞掉异常。
• 缓存要有意识：同样参数的 BeanInfo 可能被缓存；类元数据发生变化的工具场景，要了解 flushFromCaches 的影响。

相关问题

stopClass 会排除子类自己的属性吗？

不会。它针对的是指定类及其父类；目标 Bean 自己以及停止点以下的子类层级仍属于分析范围。

为什么只写 Object.class 就能去掉 class 属性？

因为 class 来自 Object.getClass()。把 Object 设为停止点后，Object 及其父类不再参与分析。

能否用 stopClass 排除一个接口提供的属性？

stopClass 表达的是基类停止边界，不适合做任意接口属性黑名单；接口默认方法或公开访问器仍应通过最终描述符集合单独核对。