Руководство по инструменту: Компоновка модулей и приложений J2EE с помощью RAD 6.0
В этой памятке по инструменту приведены инструкции по компоновке модулей J2EE и приложений J2EE с помощью среды моделирования RAD (файлы WAR, EJB JAR, JAR приложений-клиентов, RAR и EAR).
Инструмент: Rational Application Developer
Взаимосвязи
Основное описание

Обзор

Компоновка - это процесс объединения компонентов приложения J2EE в пакеты, которые можно развернуть на сервере приложений. Эти пакеты формируются либо как модули J2EE (см. Рекомендация: Модуль J2EE), либо как приложение J2EE (см. Рекомендация: Приложение J2EE).  Эти пакеты создаются в виде архивных файлов, которые должны соответствовать структуре каталога и отвечать правилам, определенным в модели компоновки и развертывания приложения J2EE.

Процесс компоновки в RAD 6.0 значительно упрощен благодаря тому, что разработка компонентов приложения происходит в рамках Проекта, который является либо модулем J2EE, либо приложением J2EE. При создании проекта в нем автоматически создается структура каталога файлов, которая соответствует модели компоновки и развертывания приложения J2EE. Поскольку компоненты впоследствии создаются с помощью мастеров, компоненты сохраняются по умолчанию в подходящей папке проекта. Например, при создании файла JSP с помощью мастера Создания файлов JSP этот файл по умолчанию записывается в папку WebContent Web-проекта, где хранятся все исходные файлы содержимого Web-страниц. RAD 6.0 также автоматически генерирует все необходимые продукты работы компоновки и развертывания J2EE, например, файл манифеста и файлы описания. Поэтому процесс компоновки модуля или приложения J2EE включает только редактирование соответствующих файлов описания и экспортирование проекта в архивный файл. В этой памятке по инструменту предусмотрены следующие шаги:

Редактирование файла описания проекта

  1. Для редактирования файла описания (EAR) проекта Приложения J2EE выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE разверните меню Приложения J2EE > проект.
    2. Щелкните два раза на опции Файл описания: проект. Откроется редактор файла описания приложения.
    3. Измените значения в файле описания. Для этого выберите соответствующую вкладку в нижней части панели редактора.
    4. Сохраните файл описания. Для этого в главном меню выберите Файл > Сохранить.
  2. Для редактирования файла описания (WAR) Web-проекта выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE разверните меню Web-модули > проект.
    2. Щелкните два раза на опции Файл описания: проект. Откроется редактор файла описания Web-проекта.
    3. Измените значения в файле описания. Для этого выберите соответствующую вкладку в нижней части панели редактора.
    4. Сохраните файл описания. Для этого в главном меню выберите Файл > Сохранить.
  3. Для редактирования файла описания проекта EJB (EJB JAR) выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE разверните меню Модули EJB > проект.
    2. Щелкните два раза на опции Файл описания: проект. Откроется редактор файла описания проекта EJB.
    3. Измените значения в файле описания. Для этого выберите соответствующую вкладку в нижней части панели редактора.
    4. Сохраните файл описания. Для этого в главном меню выберите Файл > Сохранить.
  4. Для редактирования файла описания (JAR приложения-клиента) проекта Приложения-клиента выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE разверните меню Модули приложения-клиента > проект.
    2. Щелкните два раза на опции Файл описания: проект. Откроется редактор файла описания проекта приложения-клиента.
    3. Измените значения в файле описания. Для этого выберите соответствующую вкладку в нижней части панели редактора.
    4. Сохраните файл описания. Для этого в главном меню выберите Файл > Сохранить.
  5. Для редактирования файла описания (RAR) проекта Коннектора выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE разверните меню Модули коннектора > проект.
    2. Щелкните два раза на опции Файл описания: проект. Откроется редактор XML в файле ra.xml.
    3. В файле XML измените значения файла описания.
    4. Сохраните файл описания. Для этого в главном меню выберите Файл > Сохранить.

Проверка проекта

При сохранении ресурсов по умолчанию проводится их проверка. Однако перед экспортом проекта в архивный файл рекомендуется вручную провести проверку проекта. Обратите внимание, что заданные средства проверки проекта можно изменить. Для этого щелкните правой кнопкой мыши на проекте и выберите Свойства > Проверка.

  1. В панели Проводник проекта проекции J2EE щелкните правой кнопкой мыши на опции проект.
  2. Выберите опцию Запустить проверку.
  3. По завершении проверки откройте панель Неполадки. Если в ней указаны неполадки, исправьте их, а затем перейдите к следующему шагу.

Экспорт проекта в архивный файл

  1. Для экспорта проекта приложения J2EE в файл EAR выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE щелкните правой кнопкой мыши на опции проект.
    2. Выберите Экспорт > Файл EAR.
    3. В мастере Экспорта укажите имя и расположение файла EAR.
    4. При необходимости выберите:
      • Экспортировать исходные файлы
      • Заменить существующий файл во избежание сообщений о замене файла, если экспорт производится в существующий файл EAR
      • Добавить каталоги компоновки проекта и файлы метаданных для сохранения исходных имен проектов, добавленных или упоминаемых в проекте приложения, и создания зависимостей путей к классам (classpath). Это позволит впоследствии импортировать файл EAR в другие рабочие области и импортировать его модули как двоичные проекты.
    5. Нажмите кнопку Готово. Мастер экспортирует содержимое проекта приложения в указанный файл EAR.
  2. Для экспорта Web-проекта в файл WAR выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE щелкните правой кнопкой мыши на опции проект.
    2. Выберите Экспорт > Файл WAR.
    3. В мастере Экспорта укажите имя и расположение файла WAR.
    4. При необходимости выберите:
      • Экспортировать исходные файлы
      • Заменить существующий файл во избежание сообщений о замене файла, если экспорт производится в существующий файл WAR
    5. Нажмите кнопку Готово. Мастер экспортирует содержимое Web-проекта в указанный файл WAR.
  3. Для экспорта проекта EJB в файл EJB JAR выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE щелкните правой кнопкой мыши на опции проект.
    2. Выберите Экспорт > Файл EJB JAR.
    3. В мастере Экспорта укажите имя и расположение файла JAR.
    4. При необходимости выберите:
      • Экспортировать исходные файлы
      • Заменить существующий файл во избежание сообщений о замене файла, если экспорт производится в существующий файл JAR
    5. Нажмите кнопку Готово. Мастер экспортирует содержимое проекта EJB в указанный файл JAR.
  4. Для экспорта проекта приложения-клиента в файл JAR приложения-клиента выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE щелкните правой кнопкой мыши на опции проект.
    2. Выберите Экспорт > Файл JAR приложения-клиента.
    3. В мастере Экспорта укажите имя и расположение файла JAR.
    4. При необходимости выберите:
      • Экспортировать исходные файлы
      • Заменить существующий файл во избежание сообщений о замене файла, если экспорт производится в существующий файл JAR
    5. Нажмите кнопку Готово. Мастер экспортирует содержимое проекта приложения-клиента в указанный файл JAR.
  5. Для экспорта проекта коннектора в файл RAR выполните следующие действия:
    1. В панели Проводник проекта проекции J2EE щелкните правой кнопкой мыши на опции проект.
    2. Выберите Экспорт > Файл RAR.
    3. В мастере Экспорта укажите имя и расположение файла RAR.
    4. При необходимости выберите:
      • Экспортировать исходные файлы
      • Заменить существующий файл во избежание сообщений о замене файла, если экспорт производится в существующий файл RAR
    5. Нажмите кнопку Готово. Мастер экспортирует содержимое проекта коннектора в указанный файл RAR.