Использовать привязки WebSphere для определения имен JNDI управляемых сообщениями EJB

Элемент message-driven-descriptor задает целевое расположение для получателя сообщений. Ссылка на целевое расположение сообщений представляет собой логическое имя, применяемое для идентификации EJB, играющего роль целевого расположения сообщений, в модуле EJB. Ссылки на целевое расположение сообщений присутствуют только в артефактах J2EE 1.4 и более поздних версий, таких как:

• Клиенты приложения J2EE 1.4
• Проекты EJB 2.1
• Веб-приложения 2.4

Если несколько ссылок на целевые расположения сообщений соответствуют одной связи с целевым расположением, то во время развертывания будет собрано одно имя JNDI EJB, представляющего связь с целевым расположением, а значит - все ссылки на целевые расположения сообщений. Во время выполнения ссылки на целевые расположения связываются с администрируемыми целевыми расположениями сообщений в целевой операционной среде. Если ссылка на целевое расположение и управляемый сообщениями EJB связаны с одним целевым расположением сообщений, то у них должно быть одинаковое имя JNDI целевого расположения. В этом случае имя JNDI целевого расположения, заданное для управляемого сообщениями EJB, извлекается и применяется к соответствующей ссылке на целевое расположение сообщений. Если при установке приложения выбирается опция генерации привязок по умолчанию, то мастер установки назначает в качестве имен JNDI следующие неполные ссылки на целевые расположения сообщений:

Если у ссылки на целевое расположение сообщений есть элемент <message-destination-link>, то задается имя JNDI ejs/имя-message-destination-link. В противном случае задается имя JNDI eis/имя-message-destination-ref.

Данное правило находит имена JNDI целевых расположений для управляемых сообщениями EJB. Процедура быстрого исправления в сканере исходного кода копирует имя JNDI целевого расположения из файла jboss.xml в файл привязок WebSphere traditional и Liberty. При этом процедура быстрого исправления не задает имя JNDI ActivationSpec и не переносит свойства конфигурации активации в ejb-jar.xml.

• Определите привязки в ходе миграции в Liberty
  

В ходе миграции объектов EJB, управляемых сообщениями, в Liberty можно выбрать один из следующих вариантов подключения: IBM MQ, адаптер ресурса JCA и встроенный сервер обмена сообщениями. См. раздел Документация для получения дополнительной информации об этих опциях.

• Определите привязки во время развертывания приложения
  

Разработчик приложения может создать определения привязок в файлах ibm-xxx-bnd.xml для модулей EJB 3.0 и Web 2.5 или в файлах ibm-xxx-bnd.xmi для модулей, созданных до появления Java(R) Platform, Enterprise Edition (Java EE) 5. Такие файлы можно создать с помощью специального инструмента, например IBM(R) Rational(R) Developer Tool, а для модулей EJB 3.0 и Web 2.5 - с помощью текстового редактора или редактора XML. Созданное разработчиком приложение Java EE (файл .ear), содержащее привязки, передается для сборки или развертывания. Привязки не изменяются во время сборки. Аналогично, существующие привязки не изменяются и не переопределяются, а привязки по умолчанию не создаются во время установки приложения на сервере, который поддерживается продуктом WebSphere Application Server, если изменение привязок не требуется для успешного развертывания приложения.

Для внесения необходимых изменений в объекты EJB 2.1 с помощью Rational Application Developer выполните следующие действия:


1. Запустите инструмент сборки, Rational Application Developer.
2. Откройте проект EJB.
3. Дважды щелкните на файле описания.
4. Щелкните на нужном EJB, управляемом сообщениями.
5. Прокрутите страницу вниз до раздела Привязки WebSphere.
6. Включите переключатель Адаптер JCA и введите имя JNDI для ActivationSpec.


Для внесения необходимых изменений в объекты EJB 2.0 с помощью административной консоли выполните следующие действия: Rational Application Developer версии 7.0 не поддерживает настройку спецификаций активации EJB 2.1 для объектов EJB 2.0. Спецификации активации EJB 2.1 можно задать только для объектов EJB 2.1.


1. Задайте спецификацию активации для MDB с помощью административной консоли при развертывании приложения в WebSphere Application Server.
2. Экспортируйте файл EAR приложения с помощью административной консоли.
3. Скопируйте файл описания из файла EAR в проект, чтобы он содержал правильную спецификацию активации.



• Определите привязки во время сборки приложения
  

Привязки можно определить в аннотациях или файлах описания приложения во время сборки приложения. Модули Java EE 5 содержат аннотации в исходном коде. Для объявления аннотации используется ключевое слово, начинающееся с символа @. Привязки для модулей, созданных до появления Java EE 5, задаются в разделе Привязки WebSphere в редакторе файла описания. Изменение файлов описания может привести к изменению определению привязок в файлах привязок, создаваемых при развертывании приложения. После определения привязок приложение передается для развертывания. Существующие привязки не изменяются и не переопределяются, а привязки по умолчанию не создаются во время установки приложения на сервере, который поддерживается продуктом WebSphere Application Server, если изменение привязок не требуется для развертывания приложения.




• Определите привязки во время установки приложения
  

Пользователь, выполняющий развертывание приложения, или администратор сервера могут изменить привязки во время установки приложения на сервере, который поддерживается продуктом WebSphere Application Server, с помощью административной консоли. Новые определения привязок можно задать в мастере установки.

Кроме того, в процессе установки приложения можно выбрать опцию генерации привязок по умолчанию. В этом случае в качестве привязок в приложении задаются значения по умолчанию. Существующие привязки не изменяются.

Ограничение: привязки для клиентов приложения нельзя определить или переопределить во время установки приложения. Привязки для модулей клиентов приложения нужно определить во время сборки и сохранить в файле привязок.




• Определите привязки во время настройки установленного приложения
  
  

После установки приложения на сервере, который поддерживается продуктом WebSphere Application Server, ответственный за развертывание приложения или администратор сервера могут изменить привязки на страницах административной консоли, например на странице параметров приложения Java EE.