希望提供其 bean 的顯式信息的 bean 實(shí)現(xiàn)者可提供實(shí)現(xiàn)該 BeanInfo 接口的
BeanInfo 類和關(guān)于 bean 的方法、特性、事件等的顯式信息。
bean 實(shí)現(xiàn)者不必提供顯式信息的完全集。挑選要提供的信息, 其剩余的通過(guò)使用
bean 類的方法的低級(jí)反應(yīng)和應(yīng)用標(biāo)準(zhǔn)設(shè)計(jì)模式來(lái)自動(dòng)分析獲取。
獲得提供許多不同信息作為各種 XyZDescriptor 類部分的機(jī)會(huì)。但不要擔(dān)心,實(shí)際上僅需提供
各構(gòu)造子必需的最小核心信息。
參見(jiàn)提供 BeanInfo 類某便捷“noop”基類的 SimpleBeanInfo 類,可覆蓋用于返回顯式 info
的特定位置。
關(guān)于 bean 的所有行為參見(jiàn) Introspector 類。
接口 java.beans.BeanInfo
接口 java.beans.BeanInfo
- public interface BeanInfo
變量索引
- ICON_COLOR_16x16
- 指示一個(gè) 16 x 16 色彩圖標(biāo)的 Constant。
- ICON_COLOR_32x32
- 指示一個(gè) 32 x 32 色彩圖標(biāo)的 Constant。
- ICON_MONO_16x16
- 指示一個(gè) 16 x 16 黑白圖標(biāo)的 Constant。
- ICON_MONO_32x32
- 指示一個(gè) 32 x 32 黑白圖標(biāo)的 Constant。
方法索引
- getAdditionalBeanInfo()
- 該方法允許一個(gè) BeanInfo 對(duì)象返回可提供當(dāng)前 bean 上附加信息的其它 BeanInfo 對(duì)
象的任意集合。
- getBeanDescriptor()
-
- getDefaultEventIndex()
- 一個(gè) bean 可以有一個(gè)“缺省”事件,當(dāng)使用 bean 時(shí)用戶通常使用該事件。
- getDefaultPropertyIndex()
- 一個(gè) bean 可以有一個(gè)“缺省”特性,它是定制該 bean
的用戶為了更新而開(kāi)始通常選擇的特性。 - getEventSetDescriptors()
-
- getIcon(int)
- 該方法返回一個(gè)圖像實(shí)體,用于表示工具箱、工具條等的 bean 。
-
href="#getMethodDescriptors()">getMethodDescriptors()
-
- getPropertyDescriptors()
-
變量
ICON_COLOR_16x16
public static final int ICON_COLOR_16x16
- 指示一個(gè) 16 x 16 色彩圖標(biāo)的 Constant 。
ICON_COLOR_32x32
public static final int ICON_COLOR_32x32
- 指示一個(gè) 32 x 32 色彩圖標(biāo)的 Constant 。
ICON_MONO_16x16
public static final int ICON_MONO_16x16
- 指示一個(gè) 16 x 16 黑白圖標(biāo)的 Constant 。
ICON_MONO_32x32
public static final int ICON_MONO_32x32
- 指示一個(gè) 32 x 32 黑白圖標(biāo)的Constant 。
方法
getBeanDescriptor
public abstract
href="java.beans.beandescriptor_dsc.htm#_top_">BeanDescriptor getBeanDescriptor
()
- 返回值:
- BeanDescriptor 提供關(guān)于 bean 的所有信息, 例如其
displayName 、 customizer 等。若信息應(yīng)通過(guò)自動(dòng)分析獲得,則返回 null 。
getEventSetDescriptors
public abstract
href="java.beans.eventsetdescriptor_dsc.htm#_top_">EventSetDescriptor[]
getEventSetDescriptors()
- 返回值:
- 描述該 bean 所激發(fā)的事件種類的 EventSetDescriptors 數(shù)組。若信息應(yīng)通過(guò)自動(dòng)分析獲
得,則可以返回 null 。
getDefaultEventIndex
public abstract int getDefaultEventIndex()
- 一個(gè) bean 可以有一個(gè)“缺省”事件,當(dāng)使用 bean 時(shí)用戶通常使用該事件。
- 返回值:
- getEventSetDescriptors 所返回的 EventSetDescriptor 數(shù)組中的缺省事件索引。
若
無(wú)缺省事件,則返回 -1。
getPropertyDescriptors
public abstract
href="java.beans.propertydescriptor_dsc.htm#_top_">PropertyDescriptor[]
getPropertyDescriptors()
- 返回值:
- 描述該 bean 支持的可編輯特性的 PropertyDescriptors 數(shù)組。若信息應(yīng)通過(guò)自動(dòng)分析獲
得,則可以返回 null。
若某個(gè)特性被索引,則結(jié)果數(shù)組中它的輸入項(xiàng)將屬于 PropertyDescriptor 的
IndexedPropertyDescriptor 子類。getPropertyDescriptors 的客戶能用“
instanceof”來(lái)檢驗(yàn)?zāi)硞€(gè)給定的 PropertyDescriptor 是否為
IndexedPropertyDescriptor。
getDefaultPropertyIndex
public abstract int getDefaultPropertyIndex()
- 一個(gè) bean 可以有一個(gè)“缺省”特性,它是定制該 bean
的用戶為了更新而最經(jīng)常選擇的特性。
- 返回值:
- getPropertyDescriptors 返回的 PropertyDescriptors 數(shù)組中的缺省特性索引。
若無(wú)
缺省特性,則返回 -1。
getMethodDescriptors
public abstract
href="java.beans.methoddescriptor_dsc.htm#_top_">MethodDescriptor[]
getMethodDescriptors()
- 返回值:
- 描述該 bean 所支持的永久可見(jiàn)方法的 MethodDescriptors 數(shù)組。若信息應(yīng)通過(guò)自動(dòng)分析
獲得,則可以返回 null。
getAdditionalBeanInfo
public abstract BeanInfo[] getAdditionalBeanInfo()
- 該方法允許一個(gè) BeanInfo 對(duì)象返回提供當(dāng)前 bean 上附加信息的其它
BeanInfo 對(duì)象的任意集合。
在不同 Beaninfo 對(duì)象提供的信息間若有沖突或重疊,則當(dāng)前 BeanInfo 優(yōu)先于
getAdditionalBeanInfo 對(duì)象,數(shù)組中后面的元素優(yōu)先于前面的。
- 返回值:
- BeanInfo 對(duì)象數(shù)組。可返回 null。
getIcon
public abstract Image getIcon(int
iconKind)
- 該方法返回表示工具箱、工具條等中的 bean 。典型的圖像圖標(biāo)是 GIF
,但將來(lái)可能包含其它格式。Beans 不必提供圖標(biāo)并其且該方法可返回 null。
有四個(gè)可能的圖標(biāo)選項(xiàng) (16x16 色、
32x32 色、 16x16 黑白色、32x32 黑白色) 。若選擇某個(gè) bean 僅支持單個(gè)圖標(biāo),則建議支持
16x16 色。
建議圖標(biāo)有“透明”背景,以便能將其描繪到某個(gè)現(xiàn)存背景上。
- 參數(shù):
- iconKind - 請(qǐng)求圖標(biāo)種類。應(yīng)為常量值 ICON_COLOR_16x16、
ICON_COLOR_32x32、
ICON_MONO_16x16 或 ICON_MONO_32x32 之一。
- 返回值:
- 表示請(qǐng)求圖標(biāo)的一個(gè)圖像實(shí)體。若無(wú)合適圖標(biāo)可用,則返回 null。