java.beans
인터페이스 BeanInfo

기존의 서브 인터페이스의 일람:

BeanContextServiceProviderBeanInfo

기존의 구현 클래스의 일람:

SimpleBeanInfo

public interface BeanInfo

bean 의 구현자는 이 BeanInfo 인터페이스를 구현하는 BeanInfo 클래스를 제공해, 자신의 bean 의 메소드, 프로퍼티, 이벤트 등에 관한 명시적인 정보를 제공할 수가 있습니다.

bean 의 구현자는 명시적인 정보를 모두 제공할 필요는 없습니다. 제공하는 정보를 선택할 수가 있어 나머지는 bean 클래스의 메소드의 저레벨 리플렉션을 사용한 자동 해석 및 표준의 디자인 패턴의 적용에 의해 취득할 수 있습니다.

유저는 각 Descriptor 클래스의 일부로서 매우 많은 종류의 정보를 제공할 기회가 주어지게 됩니다. 그러나, 각 constructor 이 필요로 하는 최소한의 코어 정보를 제공하는 것만으로도 충분합니다.

BeanInfo 클래스의 편리한 「무조작」base class를 제공하는 SimpleBeanInfo 클래스도 참조해 주세요. 이것을 사용하면(자), 명시적인 정보를 제공하고 싶은 특정의 개소를 오버라이드(override) 할 수 있습니다.

bean 의 모든 동작에 대해 알려면 Introspector 클래스를 참조해 주세요.

필드의 개요

static int	ICON_COLOR_16x16 16×16 의 칼라 아이콘을 나타내는 정수입니다.
static int	ICON_COLOR_32x32 32×32 의 칼라 아이콘을 나타내는 정수입니다.
static int	ICON_MONO_16x16 16×16 의 흑백 아이콘을 나타내는 정수입니다.
static int	ICON_MONO_32x32 32×32 의 흑백 아이콘을 나타내는 정수입니다.

메소드의 개요

BeanInfo []	getAdditionalBeanInfo () 이 메소드는 BeanInfo 오브젝트가, 현재의 bean 에 대한 추가 정보를 제공하는 것 외의 BeanInfo 오브젝트의 임의의 콜렉션을 돌려줄 수가 있게 합니다.
BeanDescriptor	getBeanDescriptor () bean 의 BeanDescriptor 를 취득합니다.
int	getDefaultEventIndex () bean 는 사람이 bean 를 사용할 경우에 가장 많이 사용되는 이벤트를 「디폴트」의 이벤트로서 가질 수가 있습니다.
int	getDefaultPropertyIndex () bean 는 커스터마이즈 될 때에 가장 많이 선택되는 프로퍼티를 「디폴트」의 프로퍼티로서 가질 수가 있습니다.
EventSetDescriptor []	getEventSetDescriptors () bean 의 EventSetDescriptor 를 취득합니다.
Image	getIcon (int iconKind) 이 메소드는 툴 박스나 툴바등으로 bean 를 나타내기 위해서(때문에) 사용할 수 있는 이미지 오브젝트를 돌려줍니다.
MethodDescriptor []	getMethodDescriptors () bean 의 MethodDescriptor 를 취득합니다.
PropertyDescriptor []	getPropertyDescriptors () bean 의 PropertyDescriptor 를 취득합니다.

필드의 상세

ICON_COLOR_16x16

public static final int ICON_COLOR_16x16

16×16 의 칼라 아이콘을 나타내는 정수입니다.

관련 항목:

정수 필드치

ICON_COLOR_32x32

public static final int ICON_COLOR_32x32

32×32 의 칼라 아이콘을 나타내는 정수입니다.

관련 항목:

정수 필드치

ICON_MONO_16x16

public static final int ICON_MONO_16x16

16×16 의 흑백 아이콘을 나타내는 정수입니다.

관련 항목:

정수 필드치

ICON_MONO_32x32

public static final int ICON_MONO_32x32

32×32 의 흑백 아이콘을 나타내는 정수입니다.

관련 항목:

정수 필드치

메소드의 상세

getBeanDescriptor

public BeanDescriptor  getBeanDescriptor()

bean 의 BeanDescriptor 를 취득합니다.

반환값:

bean 의 displayName 나 카스타마이자 등, bean 에 관한 전반적인 정보를 제공하는 BeanDescriptor. 정보를 자동 해석으로 요구할 필요가 있는 경우는 null 를 돌려주는 일이 있다

getEventSetDescriptors

public EventSetDescriptor [] getEventSetDescriptors()

bean 의 EventSetDescriptor 를 취득합니다.

반환값:

이 bean 가 방아쇠 하는 이벤트의 종류를 나타내는 EventSetDescriptors 의 배열. 정보를 자동 해석으로 요구할 필요가 있는 경우는 null 를 돌려주는 일이 있다

getDefaultEventIndex

public int getDefaultEventIndex()

bean 는 사람이 bean 를 사용할 경우에 가장 많이 사용되는 이벤트를 「디폴트」의 이벤트로서 가질 수가 있습니다.

반환값:

getEventSetDescriptors 가 돌려주는 EventSetDescriptor 배열내의 디폴트 이벤트의 인덱스

디폴트의 이벤트가 없는 경우는 -1

getPropertyDescriptors

public PropertyDescriptor [] getPropertyDescriptors()

bean 의 PropertyDescriptor 를 취득합니다.

반환값:

이 bean 가 서포트하는 편집 가능한 프로퍼티를 기술하는 PropertyDescriptors 의 배열. 정보를 자동 해석으로 요구할 필요가 있는 경우는 null 를 돌려주는 일이 있다

프로퍼티가 인덱스화 되고 있는 경우에는 결과의 배열내의 그 항목은 PropertyDescriptor 의 IndexedPropertyDescriptor 서브 클래스에 속한다. getPropertyDescriptors 의 클라이언트는 "instanceof" 를 사용해, 취득한 PropertyDescriptor 가 IndexedPropertyDescriptor 화도인지를 판정할 수 있다

getDefaultPropertyIndex

public int getDefaultPropertyIndex()

bean 는 커스터마이즈 될 때에 가장 많이 선택되는 프로퍼티를 「디폴트」의 프로퍼티로서 가질 수가 있습니다.

반환값:

getPropertyDescriptors 가 돌려주는 PropertyDescriptor 배열내의 디폴트 프로퍼티의 인덱스

디폴트 프로퍼티가 없는 경우는 -1

getMethodDescriptors

public MethodDescriptor [] getMethodDescriptors()

bean 의 MethodDescriptor 를 취득합니다.

반환값:

이 bean 가 서포트하는 외부로부터 보이는 메소드를 기술하는 MethodDescriptors 의 배열. 정보를 자동 해석으로 요구할 필요가 있는 경우는 null 를 돌려주는 일이 있다

getAdditionalBeanInfo

public BeanInfo [] getAdditionalBeanInfo()

이 메소드는 BeanInfo 오브젝트가, 현재의 bean 에 대한 추가 정보를 제공하는 것 외의 BeanInfo 오브젝트의 임의의 콜렉션을 돌려줄 수가 있게 합니다.

다른 BeanInfo 오브젝트에 의해 제공된 정보의 사이에 불일치 또는 오버랩이 있는 경우는 getAdditionalBeanInfo 오브젝트보다 현재의 BeanInfo 가 우선되어 배열내에 이전부터 있던 요소보다 나중에 들어간 요소가 우선됩니다.

반환값:

BeanInfo 오브젝트의 배열. null 를 돌려주는 경우가 있다

getIcon

public Image  getIcon(int iconKind)

이 메소드는 툴 박스나 툴바등으로 bean 를 나타내기 위해서(때문에) 사용할 수 있는 이미지 오브젝트를 돌려줍니다. 아이콘 이미지는 일반적으로는 GIF 입니다만, 장래는 다른 형식이 포함될 가능성이 있습니다.

반드시 bean 는 아이콘을 제공할 필요는 없고, 이 메소드로 null 를 돌려주는 경우가 있습니다.

아이콘에는 4 개의 종류 (16×16 칼라, 32×32 칼라, 16×16 흑백, 32×32 흑백)가 있습니다. bean 가 1 개의 아이콘 밖에 서포트하지 않는 경우는 16×16 칼라를 추천합니다.

아이콘은 기존의 백그라운드에 표현 할 수 있게, 투명의 백그라운드를 가지는 것을 추천합니다.

파라미터:

iconKind - 요구된 아이콘의 종류. 정수 ICON_COLOR_16 x16, ICON_COLOR_32 x32, ICON_MONO_16 x16, 또는 ICON_MONO_32x32 의 어떤 것인가

반환값:

요구된 아이콘을 나타내는 이미지 오브젝트. 적절한 아이콘이 없는 경우는 null