Модуль «О программе»

Модуль form-about предназначен для отображения информации «О программе», включающей наименование, логотип и описание ядра приложения на платформе JaBricks. Интерфейс формы модуля определяется внутренними и внешними ресурсами. Внутренние ресурсы используются для локализации интерфейса формы и размещаются внутри модуля. Внешние ресурсы, включающие логотип, наименование и версию программы, используются для описания приложения и определены в локализуемом наборе файлов свойств. Для каждого приложения определяется свой набор внешних файлов с ресурсами.

Описание интерфейса формы

Локализованный графический интерфейс модуля, представленный на следующем скриншоте, разделен на две части. В верхней части вкладки отображаются определенные во внешних ресурсах логотип, наименование и версия приложения, ссылка на страницу приложения в Интернете. При нажатии на адресную ссылку будет открыта страница в браузере с описанием приложения. В нижней части вкладки описано ядро программы, включающее OSGi-фреймворк и основной бандл приложения.

Примечание :
1. Версия модуля 1.0.0 имела интерфейс с тремя вкладками. Две вкладки «Модули» и «Системы», представляющие список бандлов приложения и параметры окружения, вынесены в отдельный бандл Список бандлов.
2. Скриншот модуля получен в приложении Домашние финансы.

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

Интерфейс формы локализован для русского, английского и немецкого языков. При старте модуль получает от бандла ресурсов (util-resources) текущее значение объекта локализации Locale и определяет внешний файл свойств; локализованные параметры интерфейса устанавливаются согласно текущей Locale.

Бандл "подписан" на событие изменения языка локализации jabricks/event/LocaleEvent. При возникновении данного события, генерируемое бандлами form-locale, form-settings, интерфейс формы будет переведен на новый язык локализации без "перезагрузки" формы, т.е. закрытие и повторное открытие формы не требуется.

Внешние ресурсы модуля

Внешние ресурсы модуля размещаются в директории configuration/resources/properties/. Согласно технологии локализации внешние ресурсы модуля form-about представлены набором файлов form-about.properties для каждого языка (form-about_ru.properties, form-about_en.properties, form-about_de.properties). Содержание файла form-about_ru.properties (не в Unicode) :

title=Домашняя бухгалтерия
subtitle=OSGi приложение с фреймворком Felix
release=версия 2.1.314
image.logo=logo.png
link.url=https://java-online.ru/jb-home-finance.xhtml
link.text=Описание программы
 

Локализованные параметры title, subtitle, release представляют описание приложения (заголовок, подзаголовок, версия), должны быть представлены в Unicode. Три последние параметры файла имеют следующие предназначения :

• image.logo - изображение логотипа приложения;
• link.url - адрес страницы сайта с описанием приложения в Интернете;
• link.text - текст ссылки (в Unicode).

Логотип приложения размещается в директории configuration/resources/images.

Зависимости

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

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

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

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

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

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

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

Рассмотренный на странице модуль form-about-1.0.1.jar имеет размер 17 Кб.