Элемент message-driven-descriptor задает целевое расположение для получателя сообщений. Ссылка на целевое расположение сообщений представляет собой логическое имя, применяемое для идентификации EJB, играющего роль целевого расположения сообщений, в модуле EJB. Ссылки на целевое расположение сообщений присутствуют только в артефактах J2EE 1.4 и более поздних версий, таких как:
Если несколько ссылок на целевые расположения сообщений соответствуют одной связи с целевым расположением, то во время развертывания будет собрано
одно имя JNDI EJB, представляющего связь с целевым расположением, а значит
- все ссылки на целевые расположения сообщений. Во время выполнения ссылки на
целевые расположения связываются с администрируемыми целевыми расположениями
сообщений в целевой операционной среде.
Если ссылка на целевое расположение и управляемый сообщениями EJB связаны с
одним целевым расположением сообщений, то у них должно быть одинаковое имя JNDI
целевого расположения. В этом случае имя JNDI целевого расположения, заданное
для управляемого сообщениями EJB, извлекается и применяется к соответствующей
ссылке на целевое расположение сообщений.
Если при установке приложения выбирается опция генерации привязок по умолчанию,
то мастер установки назначает в качестве имен JNDI следующие неполные ссылки на целевые
расположения сообщений:
Если ссылка на целевое расположение сообщения содержит < message-destination-link>, то имя JNDI задается как
ejs/message-destination-linkName
. В противном случае будет задано имя JNDI
eis/message-destination-refName
.
Данное правило находит имена JNDI целевых расположений для управляемых сообщениями EJB. Будет предоставлено автоматизированное исправление для копирования имени JNDI назначения из jboss.xml файла в традиционный файл WebSphere или Liberty файл привязки. Вам нужно будет установить имя ActivationSpec JNDI и перенести свойства конфигурации активации в ejb-jar.xml.
В ходе миграции объектов 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 выполните следующие действия:Привязки можно определить в аннотациях или файлах описания приложения во время сборки приложения. Модули Java EE 5 содержат аннотации в исходном коде. Для объявления аннотации используется ключевое слово, начинающееся с символа @. Привязки для модулей, созданных до появления Java EE 5, задаются в разделе Привязки WebSphere в редакторе файла описания. Изменение файлов описания может привести к изменению определению привязок в файлах привязок, создаваемых при развертывании приложения. После определения привязок приложение передается для развертывания. Существующие привязки не изменяются и не переопределяются, а привязки по умолчанию не создаются во время установки приложения на сервере, который поддерживается продуктом WebSphere Application Server, если изменение привязок не требуется для развертывания приложения.
Пользователь, выполняющий развертывание приложения, или администратор
сервера могут изменить привязки во время установки приложения на сервере,
который поддерживается продуктом WebSphere Application Server, с помощью
административной консоли. Новые определения привязок можно задать в мастере установки.
Кроме того, в процессе установки приложения можно выбрать опцию генерации привязок по умолчанию.
В этом случае в качестве привязок в приложении задаются значения по умолчанию. Существующие привязки не изменяются.
Ограничение: привязки для клиентов приложения нельзя определить или переопределить во время установки приложения.
Привязки для модулей клиентов приложения нужно определить во время сборки и сохранить в файле привязок.
После установки приложения на сервере, который поддерживается продуктом WebSphere Application Server, ответственный за развертывание приложения или администратор сервера могут изменить привязки на страницах административной консоли, например на странице параметров приложения Java EE.