패키지 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 의 인스턴스로부터 delegate 됩니다.
ExceptionListener	ExceptionListener 는 내부 예외의 통지를 받습니다.
PropertyChangeListener	PropertyChange 이벤트는 bean 가 「바운드」프로퍼티를 변경할 때마다 방아쇠 됩니다.
PropertyEditor	PropertyEditor 클래스는 유저가 지정의 형태의 프로퍼티치를 편집하기 위한 GUI 의 서포트를 제공합니다.
VetoableChangeListener	VetoableChange 이벤트는 bean 가 「제약」프로퍼티를 변경할 때마다 방아쇠 됩니다.
Visibility	사용하는 환경에 따라서는 bean 는 GUI 를 사용할 수 없는 서버상에서의 실행도 가능합니다.

클래스의 개요

BeanDescriptor	BeanDescriptor 는 Java 클래스나 displayName 등 "bean" 에 관한 글로벌인 정보를 제공합니다.
Beans	이 클래스는 몇개의 다목적 bean 제어 메소드를 제공합니다.
DefaultPersistenceDelegate	DefaultPersistenceDelegate 는 추상 클래스 PersistenceDelegate 의 고정 구현이며, 정보를 얻을 수 없는 클래스가 디폴트로 사용하는 delegate입니다.
Encoder	Encoder 클래스는 공개 API 를 사용해 복수의 JavaBeans 상태를 코드화하는 파일 또는 스트림을 작성할 때에 사용됩니다.
EventHandler	EventHandler 클래스는 수신 이벤트 오브젝트와 타겟 오브젝트를 포함한 단순한 문장을 실행하는 메소드를 가지는 이벤트 청취자의 동적 생성을 서포트합니다.
EventSetDescriptor	EventSetDescriptor 는 지정의 JavaBean 가 방아쇠 하는 이벤트의 그룹을 기술합니다.
Expression	Expression 오브젝트는 타겟과 복수의 인수에 단일의 메소드를 적용하는 것으로써, 단일의 반환값 ("a.getFoo()" 의 경우와 같이)를 얻을 수 있는 원시적식입니다.
FeatureDescriptor	FeatureDescriptor 클래스는 PropertyDescriptor, EventSetDescriptor, 및 MethodDescriptor 등의 공통의 base class입니다.
IndexedPropertyDescriptor	IndexPropertyDescriptor 는 배열과 같은 기능을 가지는 프로퍼티를 기술함과 함께, 배열내의 특정의 요소에의 액세스에 사용하는 인덱스 첨부의 독해 메소드나 기입해 메소드를 갖추고 있습니다.
Introspector	Introspector 클래스는 툴을 사용해, 타겟 JavaBean 가 서포트하는 프로퍼티, 이벤트, 메소드를 조사하는 표준적인 수법을 제공합니다.
MethodDescriptor	MethodDescriptor 는 Java Bean 가 다른 컴퍼넌트로부터의 외부 액세스를 서포트하기 위한 특정 메소드를 기술합니다.
ParameterDescriptor	ParameterDescriptor 클래스에서는 java.lang.reflect.Method 클래스로부터 취득한 저레벨의 형태 정보에 가세해 bean 의 구현자가 각 파라미터에 추가 정보를 제공할 수 있습니다.
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 문서의 독해에 사용할 수 있는 것 외에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 를 참조)에 보관됩니다.

장기 지속성

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

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

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

한편, bean 로부터 정보를 써낼 때는 bean 의 형태에 관한 지식이 필요하게 되는 일이 있습니다. 인수 없음의 constructor 과 프로퍼티의 공개 get / set 메소드만으로 bean 상태를 표현할 수 있는 경우, bean 에 관한 특별한 지식은 불필요합니다. 그 이외의 경우, bean 에는 커스터마이즈 된 「지속적인 Delegate」 (특정의 형태의 bean 를 써내는 오브젝트)이 필요합니다. Java 2 SE SDK 의 클래스 가운데,java.awt.Component 의 하위에 있는 것은 모두, 프로퍼티와 지속적인 Delegate를 갖추고 있습니다.

bean 에 지속적인 Delegate를 제공할 필요가 있는 경우는 DefaultPersistenceDelegate 의 인스턴스를 사용하는지 PersistenceDelegate 의 서브 클래스를 작성합니다. 프로퍼티치를 인수로서 bean 의 constructor를 호출하고 싶다고 하는 이유만으로 지속적인 Delegate가 필요한 경우는 인수를 1 개만 취하는 DefaultPersistenceDelegate constructor를 사용해 지속적인 Delegate를 작성할 수 있습니다. 그 이외의 경우는 통상, 다음의 클래스를 필요로 하는 고유의 지속적인 Delegate를 구현할 필요가 있습니다.

PersistenceDelegate

모든 지속적인 Delegate의 파생원추상 클래스. 서브 클래스는 bean 의 형태 정보를 사용해, bean 의 작성과 그 상태의 복원에 필요한 Statement 및 Expression 를 제공합니다.

Statement

오브젝트상의 단일의 메소드의 호출을 나타냅니다. 그 메소드에 대한 인수세트를 포함합니다.

Expression

값을 돌려주는 메소드용의 Statement 의 서브 클래스.

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

관련 항목

개요, 아키텍쳐, 튜토리얼에 대해서는 아래와 같이를 참조해 주세요.

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