Модуль управления настройками

Модуль form-settings предназначен для управления внешними настройками приложения JaBricks, к которым относятся :

Данные настройки приложения JaBricks хранятся в файле jabricks.ini.

Определение настроек приложения выполняется в графическом интерфейсе модуля. На изменение настроек приложения, связанных с языком локализации и форматом представления даты, можно «подписаться». Модуль отправляет «подписчикам» соответствующее сообщение при внесение изменений в настройки. Все изменные значения настроек сохраняются в файле инициализации приложения (jabricks.ini).

Для получения значений внешних настроек следует использовать модуль util-resources.

Графический интерфейс формы

В разработке локализованного графического интерфейса модуля была использована библиотека SWING. Интерфейс формы модуля включает :

• выпадающий список из набора возможных форматов даты,
• компонент определения целочисленного количества записей на странице,
• checkbox определения разделителей в представлении денежных значений,
• checkbox представления десятичных денежных значений (2 знака после запятой : коп., цент) и
• группу из трех радиокнопок, определяющих возможные языки локализации (обозначены соответствующими
национальными флагами).

Форма модуля открывается при старте бандла, т.е. при переводе бандла в состояние ACTIVE. Режим открытия формы AlwaysOnTop.

При нажатии на кнопку OK выполняется проверка изменения настроек. Если значение одного или нескольких параметров были изменены, то обновленные значения передаются бандлу ресурсов для сохранения и выполняется рассылка сообщений. При изменении языка локализации фреймворку отправляется сообщение jabricks/LocaleEvent с обновленным объектом локализации; при изменении формата данных отправляется сообщение jabricks/DateFormatEvent с новым форматом данных. После этого форма закрывается и бандл останавливает работу (переходит в состояние RESOLVED).

Локализация формы

Интерфейс формы локализован для русского, английского и немецкого языков. В интерфейсе формы локализованы заголовок, наименования меток и кнопки управления.

Активатор бандла при старте получает от бандла ресурсов (util-resources) текущее значение объекта локализации Locale и устанавливает локализованные параметры интерфейса согласно текущей Locale.

Зависимости

Модуль взаимодействует со следующими бандлами :

• util-resources – модуль ресурсов, хранящий текущий объект локализации Locale
• gui-widgets – библиотека интерфейсных компонентов;
• base-jdialog – базовый модуль формирования интерфейса формы.

Подключение модуля form-settings

Для подключения модуля form-settings в приложение JaBricks необходимо :

• разместить модуль в поддиректории «configuration/bundles/»;
• внести в файл инициализации бандлов «bundles.ini» запись form-settings-1.0.0.jar;
• определить пункт меню или/и кнопку панели инструментов, параметрами подключения которых указать GAV значения бандла form-settings.

GAV параметры модуля form-settings имеют следующие значения :

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

Рассмотренный на странице модуль form-settings упакован в архивный файл form-settings-1.0.0.zip (24.0 Кб).