Пакет java.beans

Содержит классы, связанные с разработкой бобов - компоненты, основанные на архитектуре JavaBeans™.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
AppletInitializer	Этот интерфейс разрабатывается, чтобы работать в сговоре с java.beans. Beans.instantiate.
BeanInfo	Используйте BeanInfo интерфейс, чтобы создать a BeanInfo class и предоставляет явную информацию о методах, свойствах, событиях, и других функциях Ваших бобов.
Customizer	customizer class обеспечивает полный пользовательский GUI для того, чтобы он настроил целевой Боб Java.
DesignMode	Этот интерфейс предназначается, чтобы быть реализованным, или делегированным от, экземпляры java.beans.beancontext. BeanContext, чтобы распространить к его вложенной иерархии java.beans.beancontext. Экземпляры BeanContextChild, текущее свойство "времени проектирования".
ExceptionListener	ExceptionListener уведомляется относительно внутренних исключений.
PropertyChangeListener	Событие "PropertyChange" запускается всякий раз, когда боб изменяет "связанное" свойство.
PropertyEditor	class PropertyEditor оказывает поддержку для GUI, которые хотят позволить пользователям редактировать значение свойства данного типа.
VetoableChangeListener	Событие VetoableChange запускается всякий раз, когда боб изменяет "ограниченное" свойство.
Видимость	При некоторых обстоятельствах боб может быть выполнен на серверах, где GUI не доступен.

Сводка класса

Класс	Описание
BeanDescriptor	BeanDescriptor предоставляет глобальную информацию о "бобе", включая его Java class, его displayName, и т.д.
Бобы	Этот class обеспечивает некоторые бобовые способы управления общего назначения.
DefaultPersistenceDelegate	DefaultPersistenceDelegate конкретная реализация краткого обзора PersistenceDelegate class и является делегатом, используемым по умолчанию для классов, о которых никакая информация не доступна.
Кодер	Encoder class, который может использоваться, чтобы создать файлы или потоки, которые кодируют состояние набора JavaBeans с точки зрения их общедоступных API.
EventHandler	EventHandler class оказывает поддержку для того, чтобы динамически генерировать слушателей события, методы которых выполняют простой оператор, включающий входящий объект-событие и целевой объект.
EventSetDescriptor	EventSetDescriptor описывает группу событий, которые запускает данный боб Java.
Выражение	Expression объект представляет примитивное выражение, в котором единственный метод применяется к цели и ряду параметров, чтобы возвратить результат - как в "a.getFoo()".
FeatureDescriptor	FeatureDescriptor class является общим базовым классом для PropertyDescriptor, EventSetDescriptor, и MethodDescriptor, и т.д.
IndexedPropertyChangeEvent	Событие "IndexedPropertyChange" поставляется всякий раз, когда компонент, который соответствует спецификации JavaBeans™ ("боб") изменяет связанное индексируемое свойство.
IndexedPropertyDescriptor	IndexedPropertyDescriptor описывает свойство, которое действует как массив и имеет индексированное чтение и/или индексированный метод записи, чтобы получить доступ к определенным элементам массива.
Introspector	class Introspector обеспечивает стандартный путь к инструментам, чтобы узнать о свойствах, событиях, и методах, поддерживаемых целевым Бобом Java.
MethodDescriptor	MethodDescriptor описывает определенный метод, который Боб Java поддерживает для внешнего доступа от других компонентов.
ParameterDescriptor	ParameterDescriptor class позволяет бобовым конструкторам обеспечивать дополнительную информацию о каждом из их параметров вне низкоуровневой информации о типе, предоставленной java.lang.reflect. Метод class.
PersistenceDelegate	PersistenceDelegate class берет на себя ответственность за то, что она выразила состояние экземпляра данного class с точки зрения методов в общедоступном API class.
PropertyChangeEvent	Событие "PropertyChange" поставляется всякий раз, когда боб изменяет "связанное" или "ограниченное" свойство.
PropertyChangeListenerProxy	class, который расширяется EventListenerProxy определенно для того, чтобы добавить a PropertyChangeListener со "связанным" свойством.
PropertyChangeSupport	Это - утилита class, которая может использоваться бобами та поддержка связанные свойства.
PropertyDescriptor	PropertyDescriptor описывает одно свойство, которое Боб Java экспортирует через пару методов средства доступа.
PropertyEditorManager	PropertyEditorManager может использоваться, чтобы определить местоположение редактора свойств для любого данного имени типа.
PropertyEditorSupport	Это - поддержка class, чтобы помочь создать редакторы свойств.
SimpleBeanInfo	Это - поддержка class, чтобы облегчить для людей обеспечивать классы BeanInfo.
Оператор	A Statement объект представляет примитивный оператор, в котором единственный метод применяется к цели и ряду параметров - как в "a.setFoo(b)".
VetoableChangeListenerProxy	class, который расширяется EventListenerProxy определенно для того, чтобы добавить a VetoableChangeListener с "ограниченным" свойством.
VetoableChangeSupport	Это - утилита class, которая может использоваться бобами та поддержка ограниченные свойства.
XMLDecoder	XMLDecoder class используется, чтобы читать, XML-документы создали использование XMLEncoder и используется точно так же как ObjectInputStream.
XMLEncoder	XMLEncoder class является дополнительной альтернативой ObjectOutputStream и может используемый, чтобы генерировать текстовое представление JavaBean таким же образом что ObjectOutputStream может использоваться, чтобы создать двоичное представление Serializable объекты.

Сводка исключения

Исключение	Описание
IntrospectionException	Брошенный, когда исключение происходит во время Самоанализа.
PropertyVetoException	PropertyVetoException бросается, когда предложенное изменение к свойству представляет недопустимое значение.

Аннотация Вводит Сводку

Тип аннотации	Описание
ConstructorProperties	Аннотация на конструктора, который показывает, как параметры того конструктора соответствуют методам метода get созданного объекта.
Переходный процесс	Указывает, что атрибут, названный "переходным процессом", должен быть объявлен с данным value когда Introspector конструкции a PropertyDescriptor или EventSetDescriptor классы связались с аннотируемым элементом кода.

Пакет java.beans Описание

Содержит классы, связанные с разработкой бобов - компоненты, основанные на архитектуре JavaBeans™. Несколько из классов используются бобами, в то время как они работают в приложении. Например, классы событий используются бобами, которые запускают свойство и события изменения vetoable (см. PropertyChangeEvent). Однако, большинство классов в этом пакете предназначается, чтобы использоваться бобовым редактором (то есть, среда разработки для настройки и соединения бобов, чтобы создать приложение). В частности эти классы помогают бобовому редактору создать пользовательский интерфейс, который пользователь может использовать, чтобы настроить боб. Например, боб может содержать свойство специального типа, который, возможно, не знает бобовый редактор, как обработать. При использовании PropertyEditor интерфейс, бобовый разработчик может предоставить редактору для этого специального типа.

Чтобы минимизировать ресурсы, используемые бобом, классы, используемые бобовыми редакторами, загружаются только, когда боб редактируется. Они не необходимы, в то время как боб работает в приложении и поэтому не загруженный. Эта информация удерживается, что вызвало бобовую информацию (см. BeanInfo).

Если явно не утверждено, нулевые значения или пустые Строки не являются допустимыми параметрами для методов в этом пакете. Можно ожидать видеть исключения, если эти параметры будут использоваться.

Долгосрочная Персистентность

С v1.4, java.beans пакет оказывает поддержку для долгосрочной персистентности - чтение и запись боба как текстовое представление его значений свойств. Значения свойств обрабатываются как бобы, и рекурсивно читаются или пишутся, чтобы получить их публично доступное состояние. Этот подход является подходящим для длительного хранения, потому что это полагается только на общедоступный API, а не вероятную изменением частную реализацию.

Отметьте: схема персистентности не может автоматически инстанцировать пользовательских внутренних классов, таких как, Вы могли бы использовать для обработчиков событий. При использовании EventHandler class вместо внутренних классов для пользовательских обработчиков событий, можно избежать этой проблемы.

Вы читаете и пишете бобы в формате XML, используя XMLDecoder и XMLEncoder классы, соответственно. Одна достойная внимания особенность схемы персистентности - то, что чтение в бобе не требует никаких специальных знаний боба.

Выписывание боба, с другой стороны, иногда требует специальных знаний типа боба. Если состояние боба может быть выражено, используя только конструктора без параметров и общедоступного метода get и методы метода set для свойств, никакие специальные знания не требуются. Иначе, боб требует пользовательского делегата персистентности - объект, который отвечает за выписывание бобов определенного типа. Все классы, обеспеченные в JDK, которые убывают от java.awt.Component, так же как все их свойства, автоматически имейте делегатов персистентности.

Если Вы нуждаетесь (или выбираете) предоставить делегату персистентности к бобу, можно сделать так любого при использовании a DefaultPersistenceDelegate экземпляр или создавая Ваш собственный подкласс PersistenceDelegate. Если единственная причина, боб нуждается в делегате персистентности, состоит в том, потому что Вы хотите вызвать конструктора боба со значениями свойств как параметры, можно создать делегата персистентности боба с одним параметром DefaultPersistenceDelegate конструктор. Иначе, Вы должны реализовать своего собственного делегата персистентности, для которого Вы, вероятно, будете нуждаться в следующих классах:

PersistenceDelegate

Абстрактный class, от которого убывают все делегаты персистентности. Ваш подкласс должен использовать свое знание типа боба, чтобы обеспечить безотносительно Statements и Expressions необходимы, чтобы создать боб и восстановить его состояние.

Statement

Представляет вызов единственного метода на объекте. Включает ряд параметров методу.

Expression

Подкласс Statement используемый для методов, которые возвращают значение.

Как только Вы создаете делегата персистентности, Вы регистрируете это использующий setPersistenceDelegate метод XMLEncoder.

Связанная Документация

Для краткого обзора, архитектуры, и учебной документации, пожалуйста, см.:

• JavaBeans, след в Учебном руководстве по Java.
• Долгосрочная Персистентность, статья в Соединении Swing.