java.lang.Object java.beans.Introspector
public class Introspector
Introspector 类为通过工具学习有关受目标 Java Bean 支持的属性、事件和方法的知识提供了一个标准方法。
对于这三种信息,Introspector 将分别分析 bean 的类和超类,寻找显式或隐式信息,使用这些信息构建一个全面描述目标 bean 的 BeanInfo 对象。
对于每个 "Foo" 类,如果存在相应的 "FooBeanInfo" 类,显式信息可能是可用的,查询这些信息时,FooBeanInfo 类会提供一个非 null 值。通过获得目标 bean 类的完全受限定包名称并追加 "BeanInfo" 形成一个新类,首先查找 BeanInfo 类。如果此操作失败,则采用此名称的最终类名称组件,在 BeanInfo 包搜索路径中指定的每个包中搜索该类。
因此对于某个类,比如说 "sun.xyz.OurButton",首先需要查找称为 "sun.xyz.OurButtonBeanInfo" 的 BeanInfo 类,如果失败,则查找 BeanInfo 搜索路径中的每个包来搜索 OurButtonBeanInfo 类。对于默认搜索路径,这意味着将查找 "sun.beans.infos.OurButtonBeanInfo"。
如果某个类提供有关其自身的显式 BeanInfo,则将它添加到从分析所有派生类得到的 BeanInfo 信息中,并将显式信息视为当前类及其基类的确定的信息,无需进一步深入超类链进行分析。
如果没有在某个类上发现显式 BeanInfo,则使用低层次的反射来研究类的方法,并应用标准设计模式来标识属性存储器、事件源或公共方法。然后深入分析类的超类,从它那里(可能在超类链的顶部)添加信息。
因为 Introspector 缓存 BeanInfo 类来获得更好的性能,所以如果在使用多个类加载器的应用程序中使用它,则需小心谨慎。通常,在破坏一个已用于 introspect 类的 ClassLoader
时,应使用
或 Introspector.flushCaches
方法从缓存中清除所有内省的类。 Introspector.flushFromCaches
有关内省和设计模式的更多信息,请参阅 JavaBeans specification。
字段摘要 | |
---|---|
static int |
IGNORE_ALL_BEANINFO |
static int |
IGNORE_IMMEDIATE_BEANINFO |
static int |
USE_ALL_BEANINFO |
方法摘要 | |
---|---|
static String |
decapitalize(String name) 获得一个字符串并将它转换成普通 Java 变量名称大写形式的实用工具方法。 |
static void |
flushCaches() 刷新所有 Introspector 的内部缓存。 |
static void |
flushFromCaches(Class<?> clz) 刷新给定类的 Introspector 的内部缓存信息。 |
static BeanInfo |
getBeanInfo(Class<?> beanClass) 在 Java Bean 上进行内省,了解其所有属性、公开的方法和事件。 |
static BeanInfo |
getBeanInfo(Class<?> beanClass, Class<?> stopClass) 在给定的“断”点之下,在 Java Bean 上进行内省,了解其所有属性和公开的方法。 |
static BeanInfo |
getBeanInfo(Class<?> beanClass, int flags) 在 Java Bean 上进行内省,了解其所有属性、公开的方法和事件,并将结果用一些控制标记表示。 |
static String[] |
getBeanInfoSearchPath() 获得将用来查找 BeanInfo 类的包名称的列表。 |
static void |
setBeanInfoSearchPath(String[] path) 更改将用来查找 BeanInfo 类的包名称的列表。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
public static final int USE_ALL_BEANINFO
public static final int IGNORE_IMMEDIATE_BEANINFO
public static final int IGNORE_ALL_BEANINFO
方法详细信息 |
---|
public static BeanInfo getBeanInfo(Class<?> beanClass) throws IntrospectionException
如果 Java Bean 的 BeanInfo 类以前已经被内省,则从 BeanInfo 缓存中检索 BeanInfo 类。
beanClass
- 将要分析的 bean 类。
IntrospectionException
- 如果在内省期间发生异常。
flushCaches()
,
flushFromCaches(java.lang.Class
)
public static BeanInfo getBeanInfo(Class<?> beanClass, int flags) throws IntrospectionException
如果 Java Bean 的 BeanInfo 类以前已经基于相同的参数被内省,则从 BeanInfo 缓存中检索 BeanInfo 类。
beanClass
- 将要分析的 bean 类。
flags
- 控制内省的标记。如果 flags == USE_ALL_BEANINFO,则使用可以发现的所有 BeanInfo 类。如果 flags == IGNORE_IMMEDIATE_BEANINFO,则忽略与指定 beanClass 相关联的任何 BeanInfo。如果 flags == IGNORE_ALL_BEANINFO,则忽略与指定 beanClass 相关联的所有 BeanInfo 及其所有父类。
IntrospectionException
- 如果在内省期间发生异常。
public static BeanInfo getBeanInfo(Class<?> beanClass, Class<?> stopClass) throws IntrospectionException
如果 Java Bean 的 BeanInfo 类以前已经基于相同的参数被内省,则从 BeanInfo 缓存中检索 BeanInfo 类。
beanClass
- 将要分析的 bean 类。
stopClass
- 从其所在位置开始停止分析的基类。stopClass 或其基类中的所有方法/属性/事件都将在分析中被忽略。
IntrospectionException
- 如果在内省期间发生异常。
public static String decapitalize(String name)
因此 "FooBah" 变成 "fooBah","X" 变成 "x",但 "URL" 仍然是 "URL"。
name
- 要取消大写化的字符串。
public static String[] getBeanInfoSearchPath()
public static void setBeanInfoSearchPath(String[] path)
如果有安全管理器,则首先调用其 checkPropertiesAccess
方法。这可能会导致 SecurityException 异常。
path
- 包名称数组。
SecurityException
- 如果安全管理器存在并且其
checkPropertiesAccess
方法不允许设置系统属性。
SecurityManager.checkPropertiesAccess()
public static void flushCaches()
public static void flushFromCaches(Class<?> clz)
clz
- 要刷新的 Class 对象。
NullPointerException
- 如果 Class 对象为 null。