PropertyDescriptor通过getter/setter命名规则精准建模JavaBean属性,不依赖字段而依赖public方法(如getXxx()/isXxx()、setXxx()),提供getReadMethod()/getWriteMethod()供反射调用;Spring借助它与CachedIntrospectionResults实现高效属性填充和数据绑定。

反射能直接操作类的任意成员,内省则专为符合JavaBean规范的类服务,核心落点在 PropertyDescriptor —— 它不是泛泛而谈的“属性描述”,而是对 getter/setter 方法对的精准建模。
PropertyDescriptor 怎么识别一个属性?
它不依赖字段是否存在,只依据方法命名规则推断:
- 有 public 的
getXxx()(布尔类型可用isXxx()),就认为存在名为xxx的可读属性,返回类型即为属性类型 - 有 public 的
setXxx(T value),且参数类型与对应 getter 返回类型一致或为其子类,就认为该属性可写 - getter 和 setter 可单独存在;若只有 setter,
getPropertyType()会返回其参数类型 -
getClass()方法总会被识别为class属性——这是内省的默认行为,不代表真有 class 字段
如何用 PropertyDescriptor 操作属性值?
它本身不执行读写,但提供方法引用,需配合反射调用:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
-
getReadMethod()返回Method对象,传入目标实例即可读取值:readMethod.invoke(obj) -
getWriteMethod()同理,调用时传入实例和待设值:writeMethod.invoke(obj, newValue) - 注意:若方法是 private,需先调用
setAccessible(true)(但 JavaBean 规范要求 getter/setter 为 public,生产环境一般无需此步) - 推荐使用
PropertyEditor或 Spring 的ConversionService处理类型转换,避免手动处理 String ↔ Object
为什么 Spring 大量依赖 PropertyDescriptor?
Spring 的 BeanWrapper 底层就是靠它完成属性填充和数据绑定:
立即学习“Java免费学习笔记(深入)”;
-
BeanWrapperImpl在首次访问某类时调用Introspector.getBeanInfo(),缓存所有PropertyDescriptor - 后续通过属性名字符串(如
"userName")快速查到对应 descriptor,再调用其 read/write method -
CachedIntrospectionResults是 Spring 的优化机制,避免重复解析,提升 IOC 容器启动和 Bean 创建效率 - 若项目禁用内省缓存(
spring.beaninfo.ignore=true),每次都会重新解析,性能明显下降
内省 vs 反射:关键区别在哪?
别把内省当成“简化版反射”——它是语义层的抽象:
- 反射面向的是字节码结构:能看到所有字段、方法、构造器,不管是否符合规范
- 内省面向的是 JavaBean 合约:只关心符合命名规范的 accessor 方法,自动忽略私有字段、静态方法、非标准命名方法
- 内省结果可预测:
getName()→ 属性name;反射要自己解析方法名、匹配参数、判断访问权限 - 内省天然支持事件监听器发现(
addXxxListener)、索引属性(getXxx(int))、约束属性等 Bean 高级特性

















