Пакет 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.