java.beans
인터페이스 BeanInfo

알려진 서브 인터페이스 목록 :

BeanContextServiceProviderBeanInfo

알려진 구현 클래스 목록:

SimpleBeanInfo

public interface BeanInfo

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

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

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

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

static final int ICON_COLOR_16x16

16×16 컬러자식 아이콘을 나타내는 정수입니다.

관련 항목:

정수 필드값

ICON_COLOR_32x32

static final int ICON_COLOR_32x32

32×32 컬러자식 아이콘을 나타내는 정수입니다.

관련 항목:

정수 필드값

ICON_MONO_16x16

static final int ICON_MONO_16x16

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

관련 항목:

정수 필드값

ICON_MONO_32x32

static final int ICON_MONO_32x32

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

관련 항목:

정수 필드값

메서드의 상세

getBeanDescriptor

BeanDescriptor  getBeanDescriptor()

bean BeanDescriptor를 취득합니다.

반환값:

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

getEventSetDescriptors

EventSetDescriptor [] getEventSetDescriptors()

bean EventSetDescriptor를 취득합니다.

반환값:

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

getDefaultEventIndex

int getDefaultEventIndex()

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

반환값:

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

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

getPropertyDescriptors

PropertyDescriptor [] getPropertyDescriptors()

bean PropertyDescriptor를 취득합니다.

반환값:

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

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

getDefaultPropertyIndex

int getDefaultPropertyIndex()

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

반환값:

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

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

getMethodDescriptors

MethodDescriptor [] getMethodDescriptors()

bean MethodDescriptor를 취득합니다.

반환값:

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

getAdditionalBeanInfo

BeanInfo [] getAdditionalBeanInfo()

이 메서드는 BeanInfo 객체가 현재의 bean에 대한 추가 정보를 제공하는 것 외의 BeanInfo 객체의 임의의 컬렉션을 돌려줄 수가 있도록 합니다.

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

반환값:

BeanInfo 객체의 배열. null을 돌려주는 경우가 있다

getIcon

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