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

Назначение

В этой памятке по инструменту приведены следующие сведения о J2EE:

Обзор

XDE предоставляет средства автоматического создания архивов J2EE, формирования их содержимого и привязки архивов к узлам (контейнерам и серверам). Эти операции выполняются в модулях развертывания XDE.

В этой памятке по инструменту предусмотрены следующие шаги:

Дополнительная информация

Ссылки на разделы Web-справки Rational XDE™ помечены значком справка.

Настройка Рабочей области компоновки

В среде XDE Рабочая область компоновки представляет собой модели развертывания XDE (EJB, Web и EAR). Поэтому на этом этапе нужно создать необходимые модели развертывания XDE. За рекомендациями, какие проекты и модели развертывания нужно создать, обратитесь к разделу Рекомендации по созданию структуры моделей XDE.

Возможно, некоторые модели развертывания уже были созданы при создании проектов XDE. Однако при необходимости компоновщик может создать дополнительные отдельные рабочие области компоновки и использовать их для тестирования и развертывания приложений.

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

Модели развертывания XDE можно создавать вручную (см. раздел справкаСоздание моделей развертывания Java или с помощью мастеров развертывания J2EE среды XDE одновременно с созданием архива (см. следующий шаг: Создание архивов). Мастеры развертывания XDE создают или обновляют модели развертывания EJB, Web или EAR (модель EAR содержит "вкладываемый" файл EAR, который необходимо развертывать в большинстве серверов приложений).

Сведения о заполнении моделей развертывания XDE приведена в следующих шагах этой памятки по инструменту.

Создание архивов

На этом этапе можно создать архивы (если они еще не созданы) и сформировать их содержимое.

Архивы EJB-JAR модуля J2EE формируются в моделях развертывания EJB, а архивы WAR - в моделях Web. В этих моделях развертывания можно указать, какие элементы нужно занести в архив.

Архивы EAR приложения J2EE формируются в модели развертывания EAR. В этой модели можно указать, какие архивы модуля J2EE нужно включить в файл EAR, и с каким узлом сервера приложений связать этот файл. Дополнительная информация о привязке архивов к узлам приведена в разделе справкаРазвертывание: взаимодействие компонентов . В узлах содержится информация о том, какой тип сервера и какие данные потребуются для развертывания. Если в XDE поддерживается сервер приложений, то для оптимизации развертывания можно задать свойства этого сервера, например, задать роли обеспечения защиты приложений. Дополнительная информация приведена в разделе справкаУзлы развертывания (Java) . См. также раздел справкаСерверы приложений (Java) .

Для настройки моделей развертывания в XDE можно использовать мастеры развертывания приложений J2EE. С помощью этих мастеров можно создавать модели и архивы, формировать содержимое архивов и указывать узлы, в которых будет развернут архив. В моделях развертывания EJB и Web определите элементы для добавления в архивы модуля J2EE, после чего мастер развертывания установит взаимодействие между файлами архивов и компонентами. В модели развертывания EAR определите, какие архивы войдут в файл EAR (в моделях развертывания EJB и Web мастер развертывания настраивает взаимодействие с архивами по умолчанию), а также укажите узлы сервера приложений, где будет развернут архив. Дополнительная информация о мастерах развертывания XDE приведена в разделе справкаМастеры развертывания J2EE .

Замечания по работе с мастерами развертывания XDE:

  • Перед запуском мастеров нужно открыть модели XDE, в которых содержатся элементы для добавления в архив, после чего эти элементы появятся в выпадающих списках, и их можно будет выбрать для добавления архив.
  • Мастеры только добавляют элементы в архивы. Мастеры не удаляют элементы, добавленные в архив ранее, даже если эти элементы не отмечены при последующих вызовах мастеров.
  • Если в модели развертывания XDE содержится несколько архивов, XDE считает один из них архивом по умолчанию. Архивом по умолчанию становится архив, указанный в процессе выполнения последнего шага мастера развертывания. При использовании XDE в средстве разработки приложений WebSphere Studio Application Developer среда XDE будет работать только с этим архивом, так как для средства разработки требуется отдельный проект для каждого архива. Поэтому инструменты средства разработки будут недоступны для работы с остальными архивами.
  • Мастеры можно запускать каждый раз для добавления в архив новых элементов приложения, для создания архивов или для внесения изменений в данные развертывания. Дополнительная информация о развертывании архивов J2EE приведена в разделе Памятка по инструменту: Развертывание модулей и приложений J2EE с помощью Rational XDE Developer - Java Platform Edition.
  • По завершении работы с мастерами рекомендуется для каждой модели развертывания открыть диаграмму по умолчанию, а затем перетащить в эту диаграмму и разместить в ней новые элементы (компоненты и архивы), созданные в моделях развертывания.

Результаты выполнения этого шага необходимо сохранить в диаграммах развертывания. Дополнительная информация приведена в разделе справкаРабота с диаграммами развертывания . См. также раздел справкаРазмещение и группировка элементов диаграммы .

Создание файлов описания

В XDE разработчик не редактирует файлы описания напрямую. Он только задает основные свойства этих файлов в моделях развертывания XDE, а затем файлы создаются автоматически в процессе развертывания. Каждой модели развертывания XDE соответствует один файл описания. Дополнительная информация о файлах описания в XDE приведена в разделе справкаФайлы описания .

Мастеры развертывания XDE (описанные в предыдущем шаге: Создание архивов) автоматически задают некоторые свойства файла описания во время создания архива и каждый раз при запуске самих мастеров развертывания. Таким образом постепенно изменяется содержимое файлов описания.

Для развертывания архивов JAR (включая EJB-JAR и WAR) на некоторых серверах приложений необходимо задать этим архивам расширение EAR. Это может потребоваться при тестировании компонента приложения. В этом случае подойдет файл EAR, который автоматически создают мастеры развертывания XDE.

Однако разработчикам приложений часто требуется задать содержимое EAR, например, роли обеспечения защиты приложения. В модели развертывания XDE можно с помощью панелей инструментов или всплывающих меню задавать роли обеспечения защиты, распределять права доступа, моделировать транзакции и осуществлять другие действия. С применением помощника Connector Assistant по настройке взаимосвязей, предусмотренного в каждой панели инструментов, можно установить взаимосвязь между элементами. При наличии нескольких возможных вариантов можно выбрать нужную опцию. Дополнительная информация о помощнике Connector Assistant приведена в разделе справкаНастройка взаимосвязей для объектов EJB . Дополнительная информация о моделировании файлов WAR приведена в разделе справкаМоделирование файлов WAR . Дополнительная информация о моделировании файлов EJB-JAR приведена в разделе справкаМоделирование развертывания .

Модели развертывания XDE (EJB, Web и EAR) содержат всю информацию, необходимую для создания файлов описания EJB (ejb-jar.xml), Web (web.xml) и Enterprise Application (application.xml). При этом часть данных берется из моделей кода, связанных с моделями развертывания. Это файлы описания, определенные в стандарте J2EE. Для завершения развертывания на большинстве серверов приложений потребуется создать дополнительные файлы описания. XDE создает дополнительные файлы описания, которые можно использовать в поддерживаемых серверах приложений.  Дополнительная информация приведена в разделе справкаРазвертывание приложений Java .

Если между таблицами базы данных в Модели данных и постоянными сущностными объектами EJB, управляемыми контейнером (CMP), создана карта связей, на ее основе будут созданы карты связей в предоставленных вендорами файлах описания. Карты связей не входят в стандартный набор элементов файла описания объекта EJB. Если карта связей Модели данных не создана, для таких объектов EJB будет применяться карта связей по умолчанию. Дополнительная информация приведена в разделе справкаИспользование объектов EJB с базами данных .

XDE не моделирует и не создает полное содержание файлов описания, предоставленных вендорами. Вместо этого разработчик может отключить функцию автоматического создания файлов описания и управлять ими самостоятельно. У каждого архива есть свойство, где перечислены файлы или каталоги, которые будут добавлены в архив, но не подлежат моделированию. Для файлов JAR это свойство называется JARNonModelElements, для файлов EJB-JAR - EJBNonModelElements, для файлов WAR - WebNonModelElements, а для файлов EAR - EARNonModelElements. Добавьте в свойства соответствующего архива файлы описания и другие файлы, которыми вы хотите управлять самостоятельно. Дополнительная информация приведена в разделе справкаРазвертывание приложений Java .

Проверка архивов

Перед началом развертывания рекомендуется проверить правильность работы модели развертывания XDE. Благодаря этому можно будет выявить скрытые или непредвиденные ошибки, особенно на стороне сервера приложений. Рекомендуется также проверять правильность функционирования моделей и в процессе работы, например, несколько раз при компоновке, затем один раз перед развертыванием.

В XDE можно проверить целостность моделей развертывания. В Структуре моделей выберите нужную модель и вызовите контекстную команду "Проверить". При обнаружении неполадок будет составлен список задач. Дополнительная информация приведена в разделе справкаПроверка моделей Java . Информация о том, какие элементы моделей развертывания проверяются средой XDE, приведена в разделе справкаПравила проверки моделей развертывания .

Дополнительная информация

В среде XDE можно моделировать архивы J2EE и файлы описания. Можно также импортировать в эту среду файлы описания или целые архивы. Дополнительная информация приведена в разделе справкаИмпорт и Экспорт в среде разработки .

Дополнительная информация о моделирования развертывания XDE приведена в разделе справкаМоделирование развертывания . Дополнительная информация о развертывании приведена в разделе Памятка по инструменту: Развертывание модулей и приложений J2EE с помощью Rational XDE Developer - Java Platform Edition.