Пакет java.beans

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

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

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

Постоянное хранение данных

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

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

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

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

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

PersistenceDelegate

Абстрактный класс, от которого происходят все делегаты сохранения. Ваш подкласс должен использовать свои знания о типе компонента для предоставления необходимых Statement и Expression для создания компонента и восстановления его состояния.

Statement

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

Expression

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

После создания делегата сохранения вы регистрируете его, используя метод setPersistenceDelegate класса XMLEncoder.

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

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

• JavaBeans, учебный курс в Java Tutorial.
• Долгосрочное хранение данных, статья в The Swing Connection.