java.beans

Class Introspector

java.lang.Object

java.beans.Introspector

public class Introspector
extends Object

Introspector类提供的工具来了解性能，标准的事件，并通过目标java bean支持的方法。

每个人三种信息，Introspector将分别分析bean类和超类寻找明示或隐含的信息并利用这些信息来建立一个BeanInfo对象，全面介绍了目标bean。

对每一类“foo”，明确的信息是可用的如果存在一个相应的“foobeaninfo”类，提供了一个非空值时，查询信息。我们首先寻找BeanInfo类以目标bean类的完全限定名和附加包”的BeanInfo”形成一个新的类的名称。如果失败了，那么我们把这个名字最终类名组成，寻找类中的每个包的搜索路径指定的包BeanInfo。

对于一个类如“太阳。XYZ。OurButton“我们会先找一个BeanInfo类称为“太阳”。XYZ。ourbuttonbeaninfo“如果失败，我们会在每个包的搜索路径的一个ourbuttonbeaninfo BeanInfo类。与默认的搜索路径，这就意味着“太阳”。ourbuttonbeaninfo豆。信息。”。

如果一个类提供了明确的BeanInfo本身然后我们添加到我们从分析任何派生类BeanInfo信息，但我们认为明确的信息是明确当前类的基类，而不进行任何进一步的超链。

如果我们找不到明确的BeanInfo类上，我们使用低反射研究的类的方法和适用标准的设计模式来识别属性访问器，事件源或公共方法。接着我们分析类的父类和添加的信息从它（可能上超链）。

关于反思和设计模式的更多信息，请咨询JavaBeans™ specification。

Field Summary

Fields

Modifier and Type	Field and Description
static int	IGNORE_ALL_BEANINFO 表明忽略所有BeanInfo旗。
static int	IGNORE_IMMEDIATE_BEANINFO 表明忽视立即BeanInfo旗。
static int	USE_ALL_BEANINFO 显示所有使用BeanInfo旗。

方法摘要

Modifier and Type	Method and Description
static String	decapitalize(String name) 本方法需要一个字符串，将其转换为普通java变量名大写。
static void	flushCaches() 冲洗所有的内省的内部缓存。
static void	flushFromCaches(类<?> clz) 同花顺Introspector的内部缓存的信息对于一个给定的类。
static BeanInfo	getBeanInfo(类<?> beanClass) 反思了java bean和了解它的全部属性，方法和事件的暴露。
static BeanInfo	getBeanInfo(类<?> beanClass, 类<?> stopClass) 反思了java bean和学习所有关于它的性质，暴露的方法，在给予“停止点”。
static BeanInfo	getBeanInfo(类<?> beanClass, 类<?> stopClass, int flags) 反思了java bean和了解它的所有属性、方法和事件的暴露，低于一个给定的 stopClass点受到一些控制 flags。
static BeanInfo	getBeanInfo(类<?> beanClass, int flags) 反思了java bean和了解它的全部属性，方法和事件，暴露，受到一些控制标志。
static String[]	getBeanInfoSearchPath() 获取包的名称将用于寻找BeanInfo类列表。
static void	setBeanInfoSearchPath(String[] path) 改变包的名称将用于寻找BeanInfo类列表。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

USE_ALL_BEANINFO

public static final int USE_ALL_BEANINFO

显示所有使用BeanInfo旗。

另请参见：

Constant Field Values

IGNORE_IMMEDIATE_BEANINFO

public static final int IGNORE_IMMEDIATE_BEANINFO

表明忽视立即BeanInfo旗。

另请参见：

Constant Field Values

IGNORE_ALL_BEANINFO

public static final int IGNORE_ALL_BEANINFO

表明忽略所有BeanInfo旗。

另请参见：

Constant Field Values

方法详细信息

getBeanInfo

public static BeanInfo getBeanInfo(类<?> beanClass)
                            throws IntrospectionException

反思了java bean和了解它的全部属性，方法和事件的暴露。

如果一个java bean BeanInfo类先前已反思然后BeanInfo类是从缓存中检索的BeanInfo。

参数

beanClass - bean类进行分析。

结果

一个BeanInfo对象描述目标bean。

异常

IntrospectionException -如果在反思发生异常。

另请参见：

flushCaches()， flushFromCaches(java.lang.Class<?>)

getBeanInfo

public static BeanInfo getBeanInfo(类<?> beanClass,
                                   int flags)
                            throws IntrospectionException

反思了java bean和了解它的全部属性，方法和事件，暴露，受到一些控制标志。

如果一个java bean BeanInfo类先前已对基于相同的论点然后BeanInfo类是从缓存中检索的BeanInfo。

参数

beanClass - bean类进行分析。

flags -标志控制的反思。如果国旗= = use_all_beaninfo然后我们使用所有的BeanInfo类我们可以发现。如果国旗= = ignore_immediate_beaninfo然后我们忽略任何与指定的beanclass BeanInfo。如果国旗= = ignore_all_beaninfo然后我们忽略所有的BeanInfo与指定的beanclass或其任何父类。

结果

一个BeanInfo对象描述目标bean。

异常

IntrospectionException -如果在反思发生异常。

getBeanInfo

public static BeanInfo getBeanInfo(类<?> beanClass,
                                   类<?> stopClass)
                            throws IntrospectionException

反思了java bean和学习所有关于它的性质，暴露的方法，在给予“停止点”。

如果一个java bean BeanInfo类先前已对基于同样的理由，然后BeanInfo类从缓存中检索BeanInfo。

参数

beanClass - bean类进行分析。

stopClass的基类，停止分析。任何方法或属性在stopclass或在其baseclasses事件会在分析中忽略。

结果

为豆BeanInfo

异常

IntrospectionException -如果在反思发生异常。

getBeanInfo

public static BeanInfo getBeanInfo(类<?> beanClass,
                                   类<?> stopClass,
                                   int flags)
                            throws IntrospectionException

反思了java bean和了解它的所有属性、方法和事件的暴露，低于一个给定的 stopClass点受到一些控制 flags。

use_all_beaninfo

任何的BeanInfo可以发现将使用。

ignore_immediate_beaninfo

用指定的 beanClass相关的任何BeanInfo将被忽略。

ignore_all_beaninfo

用指定的 beanClass或其任何父类相关的任何BeanInfo将被忽略。

任何方法或属性在 stopClass或在它的父类将在分析中忽略的事件/。

如果一个java bean BeanInfo类先前已对基于相同的论点然后BeanInfo类是从缓存中检索的BeanInfo。

参数

beanClass - bean类进行分析

stopClass -父类，停止分析

flags -标志控制的反思

结果

一个BeanInfo对象描述目标bean

异常

IntrospectionException -如果在反思发生异常

从以下版本开始：

一点七

decapitalize

public static String decapitalize(String name)

本方法需要一个字符串，将其转换为普通java变量名大写。这通常意味着将第一个字符转换为较低的情况下，但在（不寻常）的特殊情况下，有一个以上的字符，无论是第一和第二个字符是上的情况下，我们离开它单独。

因此，“foobah”变成了“foobah”和“X”变成了“X”，但“URL”停留在“URL”。

参数

name要decapitalized字符串。

结果

的decapitalized版本的字符串。

getBeanInfoSearchPath

public static String[] getBeanInfoSearchPath()

获取包的名称将用于寻找BeanInfo类列表。

结果

包名，将搜索以找到BeanInfo类数组。此数组的默认值是依赖于实现的；例如太阳实现最初集{“太阳。豆。信息”}。

setBeanInfoSearchPath

public static void setBeanInfoSearchPath(String[] path)

改变包的名称将用于寻找BeanInfo类列表。如果参数路径为空，则此方法的行为是不确定的。

首先，如果存在安全管理器，它的checkPropertiesAccess方法称为。这可能导致SecurityException。

参数

path -包名的数组。

异常

SecurityException -如果存在一个安全管理及其 checkPropertiesAccess方法不允许系统属性的设置。

另请参见：

SecurityManager.checkPropertiesAccess()

flushCaches

public static void flushCaches()

冲洗所有的内省的内部缓存。这种方法通常不需要。它通常只需要利用先进的工具，更新现有的“类”的物体的地方和需要做出自省重新现有类的对象分析。

flushFromCaches

public static void flushFromCaches(类<?> clz)

同花顺Introspector的内部缓存的信息对于一个给定的类。这种方法通常不需要。它通常只需要利用先进的工具，更新现有的“类”的物体的地方和需要做出自省重新分析现有的类对象。请注意，只有与目标类对象相关联的直接状态被刷新。我们不为同一个名称的其他类对象刷新状态，也不为任何相关的类对象（如子类）刷新状态，即使它们的状态可能包括从目标类对象间接获得的信息。

参数

clz级对象被刷新。

异常

NullPointerException -如果类对象为空。