Материал из BiTel WiKi

Версия 05:06, 9 апреля 2013

Описание

Технология Java Web Start позволяет загружать и запускать приложения Java по сети. В случае с биллингом это выглядит следующим образом:

1. Клиент вводит URL в браузере или запускает .bat(.sh)-файл
2. Запускается java, с локального сервера биллинга скачиваются актуальные клиентские библиотеки и настройки подключения и JVM
3. Запускается привычный BGBillingClient

Java Web Start также кэширует библиотеки локально, если они не изменились. Кэш можно посмотреть через Java Control Panel -> Temporary Internet Files -> View...

В составе сервера биллинга идут следующие файлы для работы клиента через Java Web Start:

bgclient_javawebstart.sh

Создаёт подписанные клиентские библиотеки client.jar и client_libs.jar в директории webroot/client/

webroot/client/bgclient.jnlp

Файл с настройками подключения и указанием файлов библиотек для скачивания клиентом

.bgclient_keystore

Стандартное хранилище ключей для подписи клиентских библиотек. Можно использовать собственное хранилище. Подробнее про работу с SSL-ключами - в документации к модулю mps: http://bgbilling.ru/v5.2/doc/ch21s03.html

Если у вас нет этих файлов - нужно взять из последней версии BGBillingServer

HOWTO

1. Запускаем bgclient_javawebstart.sh на сервере (В стандартном update.sh )
2. Редактируем webroot/client/bgclient.jnlp - прописываем настройки сервера и клиентской jvm
3. Выполняем на клиентской машине в командной строке:

   javaws http://192.168.0.100:8080/bgbilling/client/bgclient.jnlp

Пример настройки bgclient.jnlp :

<?xml version="1.0" encoding="utf-8"?>
<jnlp
        spec="1.0+"
        codebase="http://192.168.0.100:8080/bgbilling/client"
        href="bgclient.jnlp" >
    <information>
        <title>BGBilling GUI client</title>
        <vendor>BiTel, Ltd.</vendor>
        <description>BGBilling GUI client</description>
    </information>
    <resources>
        <j2se version="1.6+" java-vm-args="-Xmx256m -Dlocal.setting.file.name=config_test"/>
        <jar href="client.jar" main="true"/>
        <jar href="client_libs.jar"/>
        <property name="db.server.0.title" value="BGBilling - test"/>
        <property name="db.server.0.url" value="http://192.168.0.100:8080/bgbilling/executer"/>
        <property name="db.server.0.proxy.host" value=""/>
        <property name="db.server.0.proxy.port" value=""/>
        <property name="look.and.feel.default" value="javax.swing.plaf.metal.MetalLookAndFeel"/>
        <property name="look.and.feel.default.theme" value="OceanTheme"/>
        <property name="user.country" value="RU"/>
        <property name="user.language" value="ru"/>
    </resources>
    <security><all-permissions/></security>
    <application-desc main-class="bitel.billing.ShellFrame" />
</jnlp>

Готово! Должно открыться обычное окно клиента биллинга.