Введение

Ассемблеры приложений J2EE собирают приложение J2EE из модулей J2EE. Ассемблеры приложений могут загружать готовые поставляемые модули и использовать их в своих приложениях путем простой модификации существующих или предоставления альтернативных файлов описания.

Некоторым серверам приложений требуется "обертка" EAR для EJB-JAR, WAR и других архивов JAR для их развертывания, что означает, что провайдеру компонентов приложения J2EE также может понадобиться собрать EAR для тестирования.

Подробное описание этапов сборки приложения J2EE приведено в спецификации J2EE, раздел J2EE.8.3 Application Assembly. Ниже приведена краткая обзорная выдержка из этого раздела.

Сборка приложения J2EE

Для сборки приложения J2EE выполните следующие действия:

1. Выберите модули J2EE, которые будут использоваться приложением.
2. Создайте структуру каталогов приложения.
3. Согласуйте файлы описания модулей J2EE.
   • Отредактируйте файлы описания модуля J2EE, связав внутренне соблюденные зависимости и исключив избыточные названия ролей защиты.
   • Определите транзакции, роли защиты, права доступа методов и т.п.
   • При необходимости укажите альтернативный файл описания с помощью элемента alt-dd, сохранив при этом исходный файл описания.
   • Присвойте корневой контекст каждому Web-модулю, входящему в приложение J2EE.
   • Проверьте правильность описания зависимостей компонентов.
   • Убедитесь, что в приложении встречается только одна версия каждого класса.
4. Создайте файл описания XML для приложения "application.xml".
5. Упакуйте приложение.
   a. Поместите модули J2EE в соответствующие каталоги. Поместите файл описания в META-INF/application.xml.
   b. Упакуйте приложение в файл ".EAR".

Добавление и удаление модулей

Модули J2EE можно добавлять в приложение перед развертыванием.
Для этого выполните следующие действия:

1. Выберите расположение для нового модуля в пакете приложения. При необходимости
   создайте каталоги в иерархии пакета приложения.
2. Скопируйте новые модули J2EE в выбранное расположение в пакете приложения.
   
3. Отредактируйте файлы описания модулей J2EE, связав зависимости,
   внутренне соблюденные модулями J2EE приложения.
4. Отредактируйте соответствующим образом файл описания приложения J2EE.

Аналогично, для удаления модуля удалите его из иерархии пакета приложения и устраните возникшие из-за этого несогласованности в файлах описания.

Проверка приложения

Настоятельно рекомендуется проверять содержимое архива перед началом развертывания, поскольку скрытые ошибки, особенно в серверной части приложения, могут приводить к сообщениям о недоступности или отсутствии компонентов. Например, убедитесь, что в EAR определен по крайней мере один модуль.

Проверить EAR можно и с помощью инструмента проверки J2EE, поставляемого с SDK J2EE. Он позволяет убедиться, что EAR внутренне согласован и правильно сформирован. Например, он проверяет соответствие архивов модулей и приложения стандартным спецификациям (J2EE, Сервлет и EJB).