Вызов и загрузка

Запуск программ, разработанных на основе "Avalanche – application framework for Java" может осуществляться как под управлением WEB сервера, так и в виде самостоятельного приложения. Вид запуска определяется на этапе разработки ПО и вида сборки проекта.

Для запуска разработанного приложения под управлением WEB сервера проект собирается в WAR или EAR файл

Для запуска разработанного приложения в виде самостоятельного приложения проект собирается в JAR и добавляются все необходимые библиотеки (JAR файлы).

В обоих случаях приложению необходимо два конфигурационных файла в формате XML. Конфигурационный файл приложения, структура которого зависит в том числе и от конкретной реализации приложения, и конфигурационный файл системы логгирования событий Log4J.

Пример запуска WEB приложения сервлетом (фрагмент файла web.xml)

  <servlet>
    <display-name>AvalancheServlet</display-name>
    <servlet-name>AvalancheServlet</servlet-name>
    <servlet-class>ru.funsys.servlet.http.AvalancheServlet</servlet-class>
    <init-param>
      <param-name>avalanche.config</param-name>
      <param-value>${contextPath}-config.xml</param-value>
    </init-param>
    <init-param>
      <param-name>avalanche.log4j</param-name>
      <param-value>${contextPath}-log4j.xml</param-value>
    </init-param>
    <init-param>
      <param-name>avalanche.paths</param-name>
      <param-value>${jboss.server.config.dir};${catalina.base}/conf</param-value>
    </init-param>
    <init-param>
      <param-name>jndiContext</param-name>
      <param-value>apps</param-value>
    </init-param>
    <init-param>
      <param-name>avalanche.jndi</param-name>
      <param-value>avalanche/${contextPath}</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
    <multipart-config>
      <max-file-size>52428800</max-file-size>
      <max-request-size>52428800</max-request-size>
      <file-size-threshold>0</file-size-threshold>
    </multipart-config>
   </servlet>

• avalanche.config – имя параметра конфигурационного файла приложения;
• contextPath – имя контекста приложения;
• avalanche.log4j – имя параметра конфигурационного log4j;
• avalanche.paths – каталоги поиска конфигурационных файлов;
• jndiContext – имя параметра контекста JNDI;
• avalanche.jndi – имя параметра в контексте JNDI;

Способ запуска "Avalanche – application framework for Java" в варианте Java приложения зависит от реализации этого приложения.

При загрузке приложения сперва инициируется система ведения журнала на основе библиотеки log4j. Далее читается конфигурационный файл и происходит создание и инициализация описанных в нем программных объектов приложения. Если в конфигурации приложения содержаться какие либо ошибки, в журнал приложения выводятся сообщения со статусами «ошибка» или «предупреждение» в зависимости от критичности найденной ошибки конфигурации.

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

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

1. «Интерфейсы»
2. «Функции»
3. «Приложения – функции» («приложения», выступающие в роли функции для других «приложений»)
4. «Приложения»
5. «Коннекторы»

Программные объекты одного назначения (например, «приложения») инициируются в порядке определения в конфигурации приложения.

При завершении работы приложения освобождаются все захваченные ресурсы.