Урок 10. Справочники базы данных

Данный урок продолжает тему девятого урока, связанную с организацией взаимодействия с сервером базе данных (БД). В качестве БД также будем использовать «Apache Derby». Подключение к серверу и просмотр табличных объектов БД описано в предыдущем уроке.

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

• list-measures – справочник единиц измерения
• list-currencies – справочник валют
• list-exchange – справочник курсов валют

Необходимо отметить, что все используемые в данном уроке модули могут взаимодействовать с различными серверами БД. Все зависит от того, какой модуль Вы используете в конфигурации : util-db или один из его прототипов.

Представленные в списке модули при первом старте создадут в БД справочные таблицы. Модули list-measures и list-currencies запишут в справочник инициализационные записи. Отличительная особенность справочника курсов валют list-exchange связана с возможностью подключения к WEB-сервису ЦБ РФ и получения значений различных курсов валют как за текущий месяц, так и за прошлые месяцы.

Конфигурация

Конфигурация приложения включает набор бандлов в поддиректории «configuration/bundles», которые регистрируются в файле «configuration/bundles.ini». В конфигурацию к базовому набору платформы дополнительно включены модули :

• db-connection – модуль подключения к серверу БД;
• db-objects – модуль представления структуры и записей табличных объектов БД;
• util-db-derby – модуль взаимодействия с сервером БД «Apache Derby»;
• form-locale – модуль определения текущего языка локализации.
• org.apache.derby-10.10.1000001 – JDBC-драйвер сервера БД «Apache Derby».

Листинг configuration/bundles.ini

Листинг

bundles=org.apache.felix.eventadmin-1.4.8.jar@start, \
org.apache.felix.log-1.0.1.jar@start, \
util-resources-1.0.0.jar@start, \
util-logger-1.0.0.jar@start, \
gui-widgets-1.0.1.jar, \
base-jframe-1.0.0.jar, \
base-jpanel-1.0.0.jar, \
base-jdialog-1.0.0.jar, \
gui-menu-1.0.0.jar, \
gui-toolbar-1.0.0.jar, \
org.apache.derby-10.10.1000001.jar, \
util-db-derby-1.0.0.jar, \
db-connection-1.0.0.jar@start, \
db-objects-1.0.0.jar, \
form-locale-1.0.0.jar, \
list-currencies-1.0.0.jar, \
list-exchange-1.0.0.jar, \
list-measures-1.0.0.jar, \
templ-jframe-1.0.0.jar@main
 

Листинг configuration/menu.xml

Листинг файла описания структуры меню «configuration/menu.xml» имеет следующий вид :

Листинг

<?xml version="1.0" encoding="UTF-8"?>
<menubar name="mainMenu">
    <menu name="menu.file">
        <menuitem name="menu.connection" 
                image="key.png"
                groupId="org.jabricks.connection" 
                artifactId="db-connection" 
                version="1.0.0" />
        <menuitem name="menu.dbobjects"  
                image="database.png"
                groupId="org.jabricks.dbobjects" 
                artifactId="db-objects"
                version="1.0.0" />
        <menuitem name="separator" />
        <menuitem name="menu.exit" 
                accelerator="alt X"
                image="exit.png"/>
    </menu>
    <stub />
    <menu name="menu.lists" >
        <menuitem name="menu.measures" 
                groupId="org.jabricks.measures" 
                artifactId="list-measures" 
                version="1.0.0" />
        <menuitem name="separator" />
        <menuitem name="menu.currencies" 
                groupId="org.jabricks.currencies" 
                artifactId="list-currencies" 
                version="1.0.0" />
        <menuitem name="menu.exchange" 
                groupId="org.jabricks.exchange"
                artifactId="list-exchange"
                version="1.0.0" />
    </menu>
    <menu name="menu.settings" >
        <menuitem name="menu.locale"
            image="configuration/resources/images/gear.png"
                groupId="org.jabricks.locale"
                artifactId="form-locale"
                version="1.0.0" />
    </menu>
</menubar>
 

С форматом структуры главного меню можно познакомиться на странице описания. В примере главное меню включает один пункт меню слева и два пункта меню справа, разделенные в описании тегом <stub>. Атрибут пункта меню name используется для определения локализованного заголовка.

К пунктам главного меню <menu> подключены один или несколько подпунктов <menuitem>; тег наименованием separator используется для разделения подпунктов меню. Описание главного меню включает интуитивно-понятные атрибуты :

• name – наименование пункта/подпункта меню, используется в локализации текстовой надписи;
• image – отображаемое в подпункте меню изображение, расположенное в директории «configuration/resources/images»;
• groupId, artifactId, version – связанный с подпунктом меню бандл.

Логирование сообщений

Конфигурация приложения данного урока была использована в качестве примера для описания логирования сообщений модуля util-logger.

Связанные страницы

Скачать урок

В таблице представлены архивные файлы конфигурации и база данных Apache Derby. Главный модуль приложения можно скачать в Уроке 1. Конфигурация приложения включает JDBC-драйвер Apache Derby и утилиту взаимодействия с СУБД util-db-derby. После скачивания архивных файлов необходимо создать структуру платформы JaBricks. В файле инициализации приложения jabricks.ini необходимо указать полный путь к директории, как это описано в утилите db-connection.