Пакет 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, учебный маршрут в The Java Tutorial.
• Долговременное сохранение, статья в The Swing Connection.