JavaBean属性通过public的getXXX()/setXXX()方法名推断,不扫描private字段;只读/只写属性取决于方法存在性;setter需满足命名、void返回、单参数等规范;调用前须判空并捕获异常;缓存可能导致属性信息未更新,可调用flushCaches()或USE_ALL_BEANINFO绕过。

Introspector 不是直接操作字段,而是通过方法名推断属性——它看的是 getXXX() 和 setXXX() 方法,不是私有变量本身。一个方法存在,就可能被识别为一个属性;缺少配套方法,就可能只有读或只有写能力。
JavaBean 属性是怎么被识别出来的
内省机制不扫描 private 字段,而是遍历所有 public 方法,按命名规则提取属性名:
- 遇到
public String getName()→ 推断出属性name,类型为String - 遇到
public void setAge(int a)→ 推断出属性age,类型为int - 只存在
getCD()没有setCD(...)→ 属性cd是只读的 - 只存在
setAB(...)没有getAB()→ 属性ab是只写的(但部分 JDK 版本可能忽略) -
getClass()总是存在 → 内省默认识别出class属性(即使你没定义字段)
PropertyDescriptor.getWriteMethod() 返回 null 的原因
这不是 bug,而是 JavaBeans 规范的硬性要求:setter 必须严格满足以下全部条件,否则内省不会认作有效写入方法:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 方法名必须是
setXxx,且Xxx首字母大写(如setName,不能是Setname或setname) - 返回类型必须是
void(若写成public Person setName(String)就无效) - 有且仅有一个参数,且参数类型需与对应 getter 的返回类型一致(或为其子类)
- 访问修饰符必须是
public(protected、private或包级都不行) - 字段为
final时,IDE 常只生成 getter,容易漏掉 setter
安全调用 getter/setter 的正确姿势
不能假设 getReadMethod() 或 getWriteMethod() 一定非空,必须显式判空并处理异常:
- 先检查
pd.getReadMethod() != null,再调用invoke(target) - 先检查
pd.getWriteMethod() != null,再调用invoke(target, value),注意传参类型要匹配 - 捕获
IllegalAccessException(权限不足)和InvocationTargetException(目标方法抛异常) - 若需获取原始异常,用
e.getCause()提取
修改代码后属性信息没更新?可能是缓存惹的祸
Introspector 默认启用全局静态缓存,编译后重新运行仍可能拿到旧的 PropertyDescriptor:
- 开发/测试阶段:每次变更 Bean 类后,手动调用
Introspector.flushCaches() - 生产环境避免频繁刷新,可改用
Introspector.getBeanInfo(clazz, Introspector.USE_ALL_BEANINFO)绕过缓存(性能开销略高) - Spring 等主流框架已内置缓存管理逻辑,自研工具类务必自行处理
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










