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