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 가 지원하는 편집 가능한 프로퍼티을 기술한다 PropertyDescriptor 의 배열. 정보를 자동 해석으로 요구할 필요가 있는 경우는 null 를 돌려주는 일이 있다

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

getDefaultPropertyIndex

int getDefaultPropertyIndex()

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

반환값:

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

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

getMethodDescriptors

MethodDescriptor [] getMethodDescriptors()

Bean 의 MethodDescriptor 를 가져옵니다.

반환값:

이 Bean 가 지원하는, 외부로부터 보인다 메소드를 기술하는 MethodDescriptor 의 배열. 정보를 자동 해석으로 요구할 필요가 있는 경우는 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 칼라를 추천합니다.

아이콘은, 기존의 백그라운드에 draw 할 수 있도록(듯이), 투명의 백그라운드를 가지는 것을 추천합니다.

파라미터:

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

반환값:

요구된 아이콘을 나타내는 이미지 객체. 적절한 아이콘이 없는 경우는 null 를 돌려주는 일이 있다