Спецификация активации JMS связана с одним или несколькими объектами EJB, управляемыми сообщениями, и обеспечивает конфигурацию, необходимую для получения сообщений этими объектами.
Создайте спецификацию активации JMS, если необходимо использовать управляемые сообщениями объекты EJB для взаимодействия с провайдером обмена сообщениями по умолчанию с помощью Java Connector Architecture (JCA) 1.5. JCA обеспечивает взаимодействие Java между серверами приложений, такими как WebSphere Application Server и информационными системами предприятия. Она предоставляет стандартный способ интеграции провайдеров JMS в серверы приложений Java EE, а также среды обмена данными с информационными системами, предусматривающими передачу данных в виде сообщений.
Все свойства конфигурации спецификации активации, кроме свойств Имя, Имя JNDI, Имя назначения JNDI и Псевдоним идентификации, переопределяются свойствами из конфигурации активации файла описания связанного объекта EJB 2.1 или более поздней версии, управляемого сообщениями. В случае объектов EJB 2.0 значениями из файла описания переопределяются свойства Тип получателя, Надежность подписки, Режим подтверждения и Селектор сообщений. В обоих случаях свойство Имя получателя JNDI можно переопределить значением из связываний объекта EJB, управляемого сообщениями.
Свойства спецификации активации влияют на то, как провайдер обмена сообщениями по умолчанию выбирает модуль обмена сообщениями, к которому подключено приложение JavaBean, управляемое сообщениями. По умолчанию среда автоматически подключает приложения к доступной в шине службе обмена сообщениями. При необходимости можно указать дополнительные параметры конфигурации для настройки процесса подключения; например, задать специальные серверы начальной загрузки или запретить подключение к отдельным службам обмена сообщениями или повысить доступность или производительность или обеспечить последовательную обработку входящих сообщений. Подробные инструкции приведены в разделе Как приложения JMS подключаются к модулю обмена сообщениями в шине.
На вкладке Конфигурация показаны Свойства конфигурации данного объекта. Значения данных свойств сохраняются даже при остановке и перезапуске среды выполнения. Инструкции по применению изменений конфигурации к среде выполнения приведены в описании задач в справочной системе Information Center.
Наивысший уровень топологии, на котором серверам приложений разрешено использовать этот объект ресурса.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Провайдер JMS, который обеспечивает асинхронный обмен сообщениями с помощью Службы сообщений Java (JMS). Он предоставляет фабрики соединений J2EE для создания соединений целевых объектов очередей или разделов JMS. Административные объекты провайдера JMS применяются для управления ресурсами JMS связанного провайдера JMS.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Обязательный параметр - отображаемое имя ресурса.
| Информация | Значение |
|---|---|
| Обязательно | Да |
| Тип данных | Строка |
Имя JNDI ресурса.
| Информация | Значение |
|---|---|
| Обязательно | Да |
| Тип данных | Строка |
Необязательное описание ресурса.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Область текста |
Указывает, использует ли объект EJB, управляемый сообщениями, получателя очереди или раздела.
| Информация | Значение |
|---|---|
| Обязательно | Да |
| Тип данных | выпадающий список |
| Диапазон |
|
Имя JNDI получателя
Выберите тип назначения в свойстве Тип приемника.
Если адаптер ресурса поддерживает JMS, свяжите javax.jms.Destinations с спецификацией активации, чтобы адаптер мог обрабатывать сообщения, поступающие из целевых расположений JMS. В этом случае администратор настраивает администрируемый объект J2C, который реализует интерфейс javax.jms.Destination и связывает его с JNDI.
Администрируемый объект J2C можно настроить для применения класса ActivationSpec, реализующего метод setDestination(javax.jms.Destination). В этом случае можно указать имя JNDI получателя (имя JNDI администрируемого объекта J2C, реализующего объект javax.jms.Destination).
В ходе запуска приложения, когда спецификация активации инициализируется вместе с конечной точкой, сервер с помощью имени JNDI получателя выполняет поиск администрируемого объекта получателя и указывает его для экземпляра спецификации активации.
| Информация | Значение |
|---|---|
| Обязательно | Да |
| Тип данных | Строка |
Селектор сообщений JMS, определяющий сообщения, получаемые объектом EJB, управляемым сообщениями. В качестве значения указывается строка, применяемая для выбора отдельных доступных сообщений. Формат строки соответствует подмножеству синтаксиса условных выражений SQL 92, описанного в спецификации JMS. Подробности см. в справочной системе Information Center.
JMSType='car' AND color='blue' AND weight>2500
Строка селектора может ссылаться на поля в заголовке сообщения JMS и в свойствах сообщения. Ссылки на тело сообщения запрещены.
Пустое значение (пустая строка) указывает на отсутствие селектора сообщения для приемника сообщения.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Имя шины, к которой нужно подключиться.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Нестандартный |
Способ уведомления о получении сообщений.
Подтверждение отправляется при удалении сообщения.
Сообщение удаляется при запуске объекта JavaBean, если для свойства качества службы задано значение оптимальное временное. При других значениях сообщение удаляется после выполнения объекта.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | выпадающий список |
| Диапазон |
|
Имя целевого объекта, который идентифицирует группу служб сообщений. Указывает тип целевого объекта, использующего свойство Тип целевого объекта.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Тип целевого объекта, указанного в свойстве Целевой объект.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | выпадающий список |
| Диапазон |
|
Это свойство задает значимость группы целевых объектов.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | выпадающий список |
| Диапазон |
|
Имя входящей транспортной цепочки, используемой приложением при подключении к службе сообщений в отдельном процессе. Если выбрана служба сообщений в другом процессе, то для установления соединения принимающий сервер должен поддерживать указанную входящую транспортную цепочку. Подробности см. в справочной системе Information Center.
Если выбранный модуль расположен на том же сервере, что и приложение, то устанавливается прямое внутреннее подключение и данное свойство транспортной цепочки игнорируется.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Список конечных точек для подключения к серверу начальной загрузки в следующем формате имя-хоста:номер-порта:имя-цепочки. В качестве разделителя применяется запятая. Например, Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Если имя хоста не указано, будет использовано значение по умолчанию localhost.
Если не указан номер порта, будет использовано значение по умолчанию 7276.
Если не указан протокол, будет использована в качестве значения по умолчанию предустановленная цепочка BootstrapBasicMessaging.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Область текста |
Максимальное число сообщений, которые можно получить от службы сообщений в одном пакете.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Целое число |
| Диапазон | От 1 до 2147483647 |
Максимальное число конечных точек, в которые осуществляется параллельная доставка сообщений.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Целое число |
| Диапазон | От 1 до 2147483647 |
Эти параметры включают автоматическую остановку конечной точки, когда количество подряд недоставленных сообщений достигает установленного предела. Это помогает сделать различие между одним и двумя сообщениями, недоставленными из-за неполадок в самих сообщениях, и неполадкой в ресурсе системы, приводящей к последовательности многих недоставленных сообщений.
Когда конечная точка останавливается автоматически, ее индикатор состояния в административной консоли становится красным. Ее следует перезапустить вручную с помощью кнопки Продолжить.
После перезапуска все сбойные сообщения, вызвавшие останов, повторно обрабатываются. Если эти сообщения продолжают вызывать сбой, они перемещаются в обработчик исключительных ситуаций, если он есть.
Включить автоматическую остановку конечной точки на основании приведенных ниже параметров.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Булевское значение |
Конечная точка будет остановлена при достижении заданного предела по количеству последовательных сбойных сообщений. Ввиду зависимостей обработки в MDB фактическое количество обработанных сообщений может превышать этот предел.
Это свойство неактивно, пока не включено свойство Автоматический останов при повторном сбое сообщений.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Целое число |
Любое сообщение, не обработанное MDB, но не достигшее максимального предела по количеству ошибок доставки, повторяется только по истечении этого времени (в миллисекундах). Другие сообщения в это время могут повторяться, если пороговое значение последовательных сбоев и максимального параллелизма не равен 1.
Настройка задержки между повторами сообщений с ошибками снижает число сообщений, без необходимости перемещаемых в обработчик исключительных ситуаций до остановки MDB. Для минимизации числа перемещаемых сообщений укажите значение задержки больше, чем ожидаемый интервал между сообщениями, поступающими к получателю.
Это свойство неактивно, пока не включено свойство Автоматический останов при повторном сбое сообщений.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Целое число |
| Диапазон | Время в миллисекундах. Значение 0 обозначает отсутствие задержки между повторами. |
Указывает, будет ли подписка на раздел JMS гарантированной или нет
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | выпадающий список |
| Диапазон |
|
Имя подписки, необходимое для гарантированных подписок. При использовании гарантированной подписки на раздел это поле является необходимым.
Имя подписки должно быть уникальным в пределах конкретного идентификатора клиента.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Идентификатор клиента JMS необходим для гарантированных подписок разделов во всех соединениях, созданных с помощью этой спецификации активации.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Имя службы сообщений, где хранятся сообщения, которые доставляются по гарантированным подпискам для объектов, созданных с помощью этой спецификации активации JMS. Это обязательное поле при работе с гарантированной подпиской на раздел.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Строка |
Если параметр активирован, данные сообщений, полученных через этот параметр активации, будут сериализованы системой только в случае крайней необходимости. Полученные из таких сообщений данные должны рассматриваться прикладными программами как доступные только для чтения.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Булевское значение |
Если параметр активирован, данные сообщений, пересланных с помощью этого параметра активации, для которых нагрузка изменилась, не будут скопированы после включения в сообщение и будут сериализованы системой только в случае крайней необходимости. Прикладные программы, отправляющие такие сообщения, не могут изменять данные после включения их в сообщение.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Булевское значение |
Упреждающее чтение - способ оптимизации, при котором сообщения присваиваются приемникам в приоритетном порядке. Такой подход сократить время обработки запросов приемников.
Присвоенные приемнику сообщения заблокированы на сервере. Они недоступны для обработки другими приемниками данного пункта назначения. Если в отключенном приемнике остались присвоенные ему необработанные сообщения, то с них снимается блокировка, чтобы их могли получить другие приемники.
Это свойство можно заменить для отдельных пунктов назначения JMS. Для этого задайте свойство Упреждающее чтение в нужном пункте назначения JMS.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | выпадающий список |
| Диапазон |
|
Это свойство используется только при выполнении приложения MDB на сервере, который является элементом целевой шины приложения. Оно не имеет силы, если MDB выполняется на сервере, который не является элементом целевой шины.
Если приложение MDB выполняется на сервере, который является элементом целевой шины, включение этой опции позволяет приложению MDB обрабатывать сообщения независимо от того, выполняется на сервере служба обмена сообщениями или нет. Если эта опция не включена, то приложения MDB на серверах, не имеющих службы обмена сообщениями, не могут обрабатывать сообщения.
Дополнительная информация приведена в разделе Как EJB, управляемый сообщениями, подключается к другим компонентами кластера.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Булевское значение |
Задержка (в секундах) между попытками соединиться со службой сообщений, как для начального соединения, так и для последующих попыток установить более надежное соединение.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | Целое число |
| Диапазон | От 1 до 2147483647 |
Имя псевдонима идентификации J2C, применяемого для идентификации, управляемой компонентами, в шине интеграции служб.
Псевдоним идентификации Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) задает ИД пользователя и пароль, которые применялись для идентификации при создании соединения с провайдером JMS.
В случае применения псевдонима идентификации не следует указывать пользовательские свойства имени пользователя и пароля. Свойства псевдонима идентификации, заданные при разработке приложения, имеют более высокий приоритет, чем свойства, заданные в административном объекте спецификации активации.
В незашифрованном виде в файл записывается только псевдоним идентификации - даже в случае протокола восстановления транзакций. Служба защиты не применяется для защиты фактических идентификационных данных пользователя.
В ходе запуска приложения, когда спецификация активации инициализируется вместе с конечной точкой, сервер с помощью псевдонима идентификации извлекает фактическое имя пользователя и пароль из конфигурации защиты и указывает их для экземпляра спецификации активации.
| Информация | Значение |
|---|---|
| Обязательно | Нет |
| Тип данных | выпадающий список |