Привязки компонентов и данных в настольном приложении

Данное руководство представляет собой вводный обзор привязок компонентов и данных для настольных приложений на Java в среде IDE NetBeans 6.0.

Содержание

• Введение: привязка компонентов в среде IDE NetBeans 6.0
• Привязка свойств к другим свойствам
• Привязка пользовательских компонентов
• Расширенные свойства привязки
• Привязка данных к элементам
• Особые свойства привязки

Для работы с этим руководством требуется программное обеспечение и ресурсы, перечисленные ниже.

Введение: привязка компонентов в среде IDE NetBeans 6.0

До выхода библиотеки привязки компонентов процесс связывания элементов UI с базами данных или организации хранения значений свойств компонентов с их синхронизацией был несколько громоздким. Так, отображение данных из стандартной базы данных в элементе "JTable" требовало ручного создания служебных классов для обработки соединения между базой данных и этим элементом. Для хранения значений различных свойств компонентов с их синхронизацией (например, значение "JTextField" с визуализацией элемента) приходилось вручную составлять код для прослушивания и обработки событий.

Библиотека привязки компонентов упрощает и стандартизирует все эти операции. От разработчика требуется лишь написать несколько строк программы, определяющих свойства элементов, значения которых должны сохраняться и синхронизироваться, а все остальные действия будут выполнены библиотекой. В среде IDE NetBeans функциональность привязки компонентов интегрирована в GUI Builder, что позволяет быстро проверить поведение написанного приложения после разработки его визуального представления.

В этом руководстве представлен обзор основных аспектов привязки компонентов в среде IDE. Для изучения конкретных примеров по большинству из этих функций см. руководство "Создание настольного приложения на Java для работы с базой данных".

Привязка свойств к другим свойствам

По своей сути привязка компонентов является способом соединения свойств компонентов без использования кода для прослушивания и обработки событий.

Для иллюстрации концепции привязки компонентов и поддержки этой техники в среде IDE рассмотрим простой пример, в котором при изменении положения ползунка пользователем в соседнем текстовом поле изменяется численное значение.

Для работы с примером:

1. В среде IDE выберите "File > New Project".
2. Выберите категорию "Java", а затем выберите шаблон приложения на Java. Нажмите кнопку "Next".
3. На странице мастера "Name and Location" выполните следующие действия:
   • Введите имя проекта NumberSlider.
   • Не устанавливайте флажок "Use Dedicated Folder for Storing Libraries". (При использовании среды IDE NetBeans 6.0 эта возможность недоступна.)
   • Оставьте флажок "Set as Main Project" установленным.
   • Снимите флажок "Create Main Class".
   
4. Для выхода из мастера и настройки проекта нажмите кнопку "Finish".
5. В окне "Projects" щелкните правой кнопкой мыши узел проекта "NumberSlider" и выберите "New > JFrame Form".

   (Если пункт "JFrame Form" в меню "New" недоступен, выберите "Other". После этого в мастере создания файла выберите категорию "Swing GUI Forms", а затем выберите шаблон "JFrame Form".)

6. На странице мастера "Name and Location" выполните следующие действия:
   • Введите имя класса NumberSliderFrame.
   • Введите имя пакета numberslider.
   
7. Для выхода из мастера и создания формы нажмите кнопку "Finish".

   В области изменения открывается NumberSliderForm.java в режиме проектирования.

8. В разделе "Swing Controls" окна "Palette" перетащите элемент ползунка в область проектирования. (Если окно "Palette" не открыто, выберите "Window > Palette".)
9. В окне "Palette" перетащите элемент текстового поля в область проектирования.

   Пример формы, полученной в результате этих действий, представлен на рисунке ниже. Точная выверка расположения элементов для этого примера существенного значения не имеет.

   

Исходный и целевой элементы

Теперь, после настройки примера, можно приступить к созданию привязки. Однако сначала необходимо определить, какой элемент будет в привязке исходным, а какой – целевым. Исходным элементом привязки называется первоначальный источник значения свойства.

При связывании в GUI Editor привязка инициируется в целевом элементе, после чего исходный элемент объявляется в диалоговом окне "Bind".

В рассматриваемом случае элемент "JSlider" уже имеет диапазон значений по умолчанию, поэтому он используется в качестве исходного элемента.

Примечание: Привязка может быть двунаправленной (чтение/запись); при этом изменения в целевом элементе автоматически отражаются в исходном элементе. Однако первоначальное связывание всегда направлено от исходного элемента к целевому. Для получения информации о режиме обновления см. раздел Расширенная настройка привязки.

Для привязки ползунка к текстовому полю:

1. Щелкните правой кнопкой мыши элемент текстового поля и выберите "Bind > text" для открытия диалогового окна "Bind".
2. В поле списка "Binding Source" выберите jSlider1.
3. В поле списка "Binding Expression" выберите value int, как показано на рисунке ниже.
4. Нажмите кнопку "OK".

Итак, теперь свойство компонента value ползунка привязано к значению text текстового поля.

В области проектирования текстовое поле должно содержать значение 50. Это значение отражает то, что ползунок находится в среднем положении, а диапазон значений по умолчанию для ползунка составляет от 0 до 100.

Теперь можно запустить приложение и проверить работу привязки.

Для выполнения проекта:

1. Выберите "Run > Run Main Project".
2. В диалоговом окне "Run Project" нажмите кнопку "OK" для подтверждения numberslider.NumberSliderForm в качестве главного класса.

Приложения должны запускаться в отдельном окне. Отрегулируйте ползунок в работающем приложении и понаблюдайте за изменением значения в текстовом поле.

Привязка пользовательских компонентов

При наличии самостоятельно созданного компонента для его использования в привязках в среде IDE необходимо выполнить несколько действий. Можно использовать один из следующих подходов:

• Для обеспечения возможности добавления этого компонента к форме его следует сначала добавить к палитре элементов, аналогично добавлению стандартного компонента Swing.
• Добавьте класс компонента к проекту и скомпилируйте компонент.

Для добавления компонента к окну "Palette":

1. Проверьте, что компонент скомпилирован.
2. Выберите "Tools > Palette Manager".
3. При необходимости создания новой категории палитр для компонента выберите "New Category" и перед добавлением компонента введите требуемое имя.
4. Выберите "Add from JAR", "Add from Library" или "Add from Project" и для добавления компонента запустите мастер.

Для добавления компонента из проекта:

1. В окне "Projects" щелкните правой кнопкой мыши узел для компонента и выберите "Compile File".
2. Перетащите компонент в форму.

   Теперь компонент должен отображаться в окне "Inspector". После этого можно вызвать диалоговое окно "Bind" для любого из свойств компонента.

Расширенная настройка привязки

В приведенном выше примере была продемонстрирована простая привязка с некоторыми настройками по умолчанию. Однако в некоторых случаях возникает необходимость в другом поведении привязки. В этом случае можно использовать вкладку "Advanced" в диалоговом окне "Binding".

Вкладка "Advanced" этого диалогового окна содержит следующие поля:

• Name. Позволяет присвоить привязке имя, что обеспечивает дополнительную гибкость при управлении привязками. Имя добавляется к конструктору привязки и может быть использовано в методе getName().
• Update Mode. Указывает способ синхронизации свойств. Возможные значения:
  • Always sync (read/write). При каждом изменении исходного или целевого элемента второй элемент обновляется.
  • Only read from source (read only). Целевой элемент обновляется только при первоначальной установке исходного элемента. Изменения исходного элемента распространяются на целевой элемент. Изменения целевого элемента не отражаются в исходном элементе.
  • Read from source once (read once). Целевой элемент обновляется только при первоначальном связывании целевого и исходного элемента.
• Update Source When (доступно только для свойства text элементов "JTextField" и "JTextArea"). Позволяет выбрать частоту синхронизации свойств.
• Ignore Adjusting (доступно для свойства value элемента "JSlider", для свойства selectedElement элементов "JTable" и "JList", а также для свойства selectedElements этих двух элементов). Если этот флажок установлен, любые изменения одного свойства не распространяются на другое свойство до завершения процесса внесения изменений пользователем. Например, если пользователь приложения изменяет положение ползунка, то значение свойства, к которому привязано значение value этого ползунка, обновляется только в тот момент, когда пользователь отпускает кнопку мыши.
• Converter. Если привязка затрагивает свойства с различными типами данных, можно указать код для преобразования значений в соответствующие типы. Библиотека привязки компонентов обрабатывает большое количество часто используемых преобразований, однако для различных комбинаций типов свойств могут потребоваться собственные преобразования. Такие преобразования должны расширять класс org.jdesktop.beansbinding.Converter.

  Раскрывающийся список "Converter" заполняется любыми преобразованиями, добавленными в форму в качестве компонентов. Можно также добавить код преобразования напрямую путем нажатия кнопки с многоточием (...) и выбора "Custom Code" из раскрывающегося списка "Select Converter Property Using".

• Validator. Позволяет указать код для проверки изменения целевого значения свойства перед его распространением на исходное свойство. Например, эту функцию можно использовать для проверки того, что целое значение свойства находится в пределах определенного диапазона.

  Такие проверки должны расширять класс org.jdesktop.beansbinding.Validator.

  Раскрывающийся список "Validator" заполняется любыми проверками, которые были добавлены в форму в качестве компонентов. Можно также непосредственно добавить код проверки путем нажатия кнопки с многоточием (...) и выбора "Custom Code" из раскрывающегося списка "Select Validator Property Using".

• Null Source Value. Позволяет указать другое значение, которое будет использоваться в случае обнаружения значения null исходного свойства при попытке связывания. Это поле соответствует методу setSourceNullValue() класса org.jdesktop.beansbinding.Binding.
• Unreadable Source Value. Позволяет указать другое значение, которое будет использоваться в случае невозможности разрешения выражения привязки при попытке связывания. Это поле соответствует методу setSourceUnreadableValue() класса org.jdesktop.beansbinding.Binding.

Примечание: Для получения более полного представления о перечисленных выше классах и методах см. документацию Javadoc по связыванию компонентов непосредственно в среде IDE. Выберите "Help > Javadoc References > Beans Binding". В открывшемся окне обозревателя щелкните ссылку org.jdesktop.beansbinding для перехода к документации по этим классам.

Привязка данных к элементам

После создания новой формы Java и добавления к ней элементов можно создать код для привязки этих элементов к данным. В IDE можно быстро настроить привязку данных к элементам "Swing JTable", "JList" и "JComboBox".

Перед привязкой элемента к данным из базы данных необходимо выполнить следующие действия:

• Подключитесь к базе данных в среде IDE.
• Добавьте элемент к форме в GUI Builder.
• Создайте классы, представляющие таблицы базы данных, к которым требуется выполнить привязку. Описание действий по созданию классов объектов для привязки данных к элементу приводятся ниже.

jComboBox1.setRenderer(new DefaultListCellRenderer() {
           @Override
           public Component getListCellRendererComponent(
                   JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
               super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
               if (value instanceof MyEntityClass) {
                   MyEntityClass mec = (MyEntityClass)value;
                   setText(mec.getPropertyFromMyEntityClass());
               }
               return this;
           }
         })

Особые свойства привязки

При необходимости библиотека привязки компонентов предоставляет специальные синтетические свойства для некоторых элементов Swing, которые отсутствуют в самих элементах. Эти свойства отражают элементы, которые обычно связываются с другими свойствами, такие как выбранная строка таблицы.

Ниже представлен список синтетических свойств, добавляемых библиотеками привязки компонентов:

Дополнительная информация

Для ознакомления с более общим обзором работы с GUI Builder в среде IDE см. Введение в разработку графического интерфейса.

Для получения информации об использовании шаблона проекта настольного приложения на Java с целью создания приложения для работы с базой данных с основным/подробным представлением см. Создание настольного приложения на Java для работы с базой данных.

Для получения дополнительных сведений о привязке компонентов см. страницу проекта "Beans Binding" на java.net.

Для получения общей информации об элементах JavaBeans см. Руководство по компонентам Java Beans.

Для ознакомления с общими советами и рекомендациями по использованию GUI Builder в среде IDE NetBeans см. часто задаваемые вопросы по GUI Editor и блог Патрика Кигэна (Patrick Keegan).