패키지 java.beans

Bean (JavaBeans^TM 아키텍쳐에 근거한 컴퍼넌트)의 개발에 관련된 클래스가 포함되어 있습니다.

참조처:
설명

인터페이스 개요

AppletInitializer	이 인터페이스는 java.beans.Beans.instantiate와 함께 동작하도록 설계되고 있습니다.
BeanInfo	bean 구현자는 이 BeanInfo 인터페이스를 구현하는 BeanInfo 클래스를 제공해, 자신의 bean 메서드, 프로퍼티, 이벤트 등에 관한 명시적인 정보를 제공할 수 있습니다 .
Customizer	카스타마이자크라스는 타겟 Java Bean를 커스터마이즈하기 위한 완전한 커스텀 GUI를 제공합니다.
DesignMode	이 인터페이스는 java.beans.beancontext.BeanContextChild 인스턴스의 상자가 되어 있는 계층에 현재의 designTime 프로퍼티를 보내기 위해서 java.beans.beancontext.BeanContext 인스턴스에 의해 구현, 또는 java.beans.beancontext.BeanContext 인스턴스로부터 위양 됩니다.
ExceptionListener	ExceptionListener는 내부 예외의 통지를 받습니다.
PropertyChangeListener	PropertyChange 이벤트는 bean가 「바운드」프로퍼티를 변경할 때마다 트리거 됩니다.
PropertyEditor	PropertyEditor 클래스는 사용자가 지정의 형태의 프로퍼티치를 편집하기 위한 GUI 지원를 제공합니다.
VetoableChangeListener	VetoableChange 이벤트는 bean가 「제약」프로퍼티를 변경할 때마다 트리거 됩니다.
Visibility	사용하는 환경에 따라서는 bean는 GUI를 사용할 수 없는 서버상에서의 실행도 가능합니다.

클래스 개요

BeanDescriptor	BeanDescriptor 은 bean Java 클래스나 displayName 등을 포함한 「bean」에 대한 글로벌 정보를 제공합니다.
Beans	이 클래스는 몇개의 다목적 bean 제어 메서드를 제공합니다.
DefaultPersistenceDelegate	DefaultPersistenceDelegate는 추상 클래스 PersistenceDelegate 고정 구현이며, 정보를 얻을 수 없는 클래스가 디폴트로 사용하는 위양입니다.
Encoder	Encoder 클래스는 공개 API를 사용해 복수의 JavaBeans 상태를 encode 하는 파일 또는 스트림을 작성할 때에 사용됩니다.
EventHandler	EventHandler 클래스는 수신 이벤트 객체와 타겟 객체를 포함한 단순한 문장을 실행하는 메서드를 가지는 이벤트 리스너의 동적 생성을 지원합니다.
EventSetDescriptor	EventSetDescriptor는 지정된 JavaBean가 트리거 하는 이벤트의 그룹을 기술합니다.
Expression	Expression객체는 타겟과 복수의 인수에 단일의 메서드를 적용하는 것으로써, 단일의 반환값 ("a.getFoo()"인 경우와 같이)를 얻을 수 있는 원시적식입니다.
FeatureDescriptor	FeatureDescriptor 클래스는 PropertyDescriptor, EventSetDescriptor, MethodDescriptor 등이 일반적인 base class입니다.
IndexedPropertyChangeEvent	「IndexedPropertyChange」이벤트는 JavaBeans 사양에 준거한 컴퍼넌트 (Bean)가 인덱스 첨부의 바운드 프로퍼티로 변경을 더할 때마다 전달됩니다.
IndexedPropertyDescriptor	IndexPropertyDescriptor는 배열과 같은 기능을 가지는 프로퍼티를 기술함과 함께, 배열내의 특정의 요소에의 액세스에 사용하는 인덱스 첨부의 read 메서드나 출력메서드를 갖추고 있습니다.
Introspector	Introspector 클래스는 툴을 사용해, 타겟 JavaBean가 지원하는 프로퍼티, 이벤트, 메서드를 조사하는 표준적인 수법을 제공합니다.
MethodDescriptor	MethodDescriptor는 Java Bean가 다른 컴퍼넌트로부터의 외부 액세스를 가능하게 하기 위해서 지원하고 있는 메서드입니다.
ParameterDescriptor	Bean 구현자는 ParameterDescriptor 클래스를 이용하는 것으로써, 각 파라미터에 대해서 java.lang.reflect.Method 클래스에 의해 제공되는 저레벨의 형태 정보 이외의 추가 정보를 제공할 수 있습니다.
PersistenceDelegate	PersistenceDeligate 클래스는 클래스의 공개 API에 포함되는 메서드에 의해 지정된 클래스의 인스턴스 상태를 표현합니다.
PropertyChangeEvent	「PropertyChange」이벤트는 Bean가 바운드 프로퍼티 또는 제약 프로퍼티를 변경할 때마다 전달됩니다.
PropertyChangeListenerProxy	지정된 PropertyChangeListener를 추가하는 목적으로 EventListenerProxy를 확장하는 클래스입니다.
PropertyChangeSupport	바운드 프로퍼티를 지원하는 bean 로 사용할 수 있는 유틸리티 클래스입니다.
PropertyDescriptor	PropertyDescriptor는 Java Bean가 한 벌의 액세스용 메서드를 사용해 export 하는 단일의 프로퍼티를 기술합니다.
PropertyEditorManager	PropertyEditorManager는 지정의 형태의 이름의 프로퍼티 에디터를 검출하기 위해서 사용됩니다.
PropertyEditorSupport	프로퍼티 에디터의 구축에 도움이 되는 지원 클래스입니다.
SimpleBeanInfo	BeanInfo 클래스를 간단하게 제공할 수 있도록하기 위한 지원 클래스입니다.
Statement	Statement객체는 「a.setFoo(b)」와 같이, 타겟과 인수에 단일의 메서드가 적용되는 원시적인 문장을 나타냅니다.
VetoableChangeListenerProxy	VetoableChangeListener를 제약 프로퍼티에 관련짓는 목적으로 EventListenerProxy를 확장하는 클래스입니다.
VetoableChangeSupport	제약 프로퍼티를 지원하는 bean에 의해 사용되는 유틸리티 클래스입니다.
XMLDecoder	XMLDecoder 클래스는 XMLEncoder로 작성된 XML 문서의 read에 사용할 수 있는 것 외에ObjectInputStream와 같은 기능도 갖추고 있습니다.
XMLEncoder	XMLEncoder 클래스는 ObjectOutputStream 보완적인 대체 클래스이며, ObjectOutputStream로 Serializable 객체의 바이너리 표현을 생성하는 경우와 같은 방법으로 JavaBean 텍스트 표현을 생성합니다.

예외 개요

IntrospectionException	인트로스페크션중에 예외가 발생했을 경우에 예외를 발생시킵니다.
PropertyVetoException	프로퍼티에 대해서 허용 되지 않는 값을 사용해 변경을 더하려고 하면, PropertyVetoException가 발생 됩니다.

패키지 java.beans 설명

Bean (JavaBeans^TM 아키텍쳐에 근거한 컴퍼넌트)의 개발에 관련된 클래스가 포함되어 있습니다. 일부의 클래스는 어플리케이션의 실행중에 bean에 의해 사용됩니다. 예를 들어 프로퍼티와 거부 가능한 변경 이벤트를 트리거 하는 bean에 의해 사용됩니다. (PropertyChangeEvent 를 참조). 다만, 이 패키지에 포함되는 대부분의 클래스는 bean 에디터 (bean 커스터마이즈와 편성에 의해 어플리케이션을 작성하는 개발 환경) 용입니다. 이러한 클래스를 사용하면, bean 에디터로 bean 커스터마이즈용 사용자 인터페이스를 간단하게 작성할 수 있습니다. 예를 들어 bean 에디터에서는 처리할 수 없는 특수한 형태의 프로퍼티를 가지는 bean가 있는 경우, bean 개발자는 PropertyEditor인터페이스를 사용해, 이 특수한 형태의 에디터를 제공할 수 있습니다 .

bean가 사용하는 자원을 최소로 하기 위해서 bean 에디터에 의해 사용되는 클래스는 bean 편집중에만 읽힙니다. 그러한 클래스는 어플리케이션으로 bean가 실행되고 있을 때는 필요없기 때문에 읽히지 않습니다. 이 정보는 bean 정보 (BeanInfo를 참조)에 보관됩니다.

특히 명기되어 있지 않은 한은 null 치 또는 비어있는 캐릭터 라인은 이 패키지의 메서드에의 유효한 파라미터가 아닙니다. 이러한 파라미터가 사용되면, 예외가 발생할 가능성이 있습니다.

장기 지속성

버전 1.4 java.beans 패키지는 프로퍼티치의 텍스트 표현으로서 bean read 및 write를 실시하는 것으로 「장기 지속성」을 지원하고 있습니다. 프로퍼티치를 bean 로서 read나 write를 반복해 실시하는 것으로 그 공개 가능 상태를 취득할 수 있습니다. 이 방식은 변경의 가능성이 있는 비공개의 구현은 아니고 공개의 API 인 만큼 존하고 있기 때문에 장기 기억에 적절하고 있습니다.

주 - 이 지속 schema는 이벤트 핸들러를 사용하는 경우와 같이, 내부 커스텀 클래스의 인스턴스를 자동적으로 작성할 수 없습니다. 이 문제를 회피하려면, 커스텀 이벤트 핸들러의 내부 클래스 대신에 EventHandler 클래스를 사용합니다.

XML 형식에서 bean를 읽어내려면 XMLDecoder, 출력하려면 XMLEncoder 클래스를 각각 사용합니다. 지속 schema에는 bean에 관한 특별한 지식이 없어도 bean에 정보를 읽어들일 수 있다고 하는 특징이 있습니다.

한편, bean 로부터 정보를 써낼 때는 bean 형태에 관한 지식이 필요하게 되는 일이 있습니다. 인수 없음의 생성자과 프로퍼티의 공개 get/set 메서드만으로 bean 상태를 표현할 수 있는 경우, bean에 관한 특별한 지식은 불필요합니다. 그 외의 경우, bean 에는 커스터마이즈 된 「지속적인 Delegate」 (특정의 형태의 bean를 써내는 객체)이 필요합니다. JDK 클래스 가운데, java.awt.Component 하위에 있는 것은 모두, 프로퍼티와 지속적인 Delegate를 갖추고 있습니다. bean에 지속적인 Delegate를 제공할 필요가 있는 (또는 제공하기로 할) 경우는 DefaultPersistenceDelegate 인스턴스를 사용하는지, PersistenceDelegate 서브 클래스를 작성합니다. 프로퍼티치를 인수로서 bean 생성자를 호출하고 싶다고 하는 이유만으로 지속적인 Delegate가 필요한 경우는 인수를 1개 만 취하는 DefaultPersistenceDelegate 생성자를 사용해 지속적인 Delegate를 작성할 수 있습니다. 그 외의 경우는 보통, 다음의 클래스를 필요로 하는 고유의 지속적인 Delegate를 구현할 필요가 있습니다.

지속적인 Delegate를 작성하면, XMLEncoder setPersistenceDelegate 메서드를 사용해 등록합니다.

관련 문서

개요, 아키텍쳐 및 튜토리얼에 대해서는 아래와 같이를 참조하십시오.

• 「JavaBeans」 ( 「Java Tutorial」의 속편)
• 「「Long-Term Persistence」 ( 「The Swing Connection」의 기사)