Пакет java.beans

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

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

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

Долговременное хранение

По состоянию на версию 1.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.
• Долговременное хранение, статья в The Swing Connection.