Параметры привязки JMS для комплексов SCA

На этой странице можно просмотреть параметры привязки службы сообщений Java (JMS), связывающей ссылки или службы комплекса архитектуры компонентов служб (SCA). С помощью этой страницы можно также изменить ресурсы привязки JMS. Параметры, показанные на этой странице, определяют элемент binding.jms.

Для просмотра этой страницы административной консоли модуль композиции должен поддерживать ссылку или службу привязки JMS. В административной консоли выполните следующие действия:

Выберите Приложения > Типы приложений > Приложения бизнес-уровня > имя-приложения > имя-модуля-композиции-развернутого-ресурса.
На странице параметров модуля композиции для комплексов SCA выберите отображение ссылок или служб:
- Для ссылки компонента SCA выберите Компоненты комплекса SCA > имя-ссылки-компонента-SCA > Ссылки компонента SCA > имя-ссылки > Привязки > Привязка JMS.
- Для службы компонента SCA выберите Компоненты комплекса SCA > имя-службы-компонента-SCA > Службы компонента SCA > имя-службы > Привязки > Привязка JMS.

С помощью привязки JMS можно найти существующие ресурсы JMS, использующие имена JNDI.

Общие свойства (только для чтения)
Ресурсы
Ресурсы ответа
Свойства заголовка запроса для ссылки (только для чтения)
Свойства заголовка ответов для службы (только для чтения)

Общие свойства

Задает значения свойств, применяемые ко всем элементам binding.jms. Эти значения относятся как к службам, так и к ссылкам. Значения изменить нельзя.

URI привязки JMS

Задает URI, идентифицирующий свойства, такие как адрес, фабрика соединений и спецификация активации для отправки или получения сообщений JMS.

Для URI определен следующий формат:

jms: адрес-jms?
connectionFactoryName=имя-фабрики-соединений &
destinationType={queue|topic} &
deliveryMode=режим-доставки &
timeToLive=время-хранения-в-кэше &
priority=приоритет &
пользовательское-свойство=значение-пользовательского-свойства & ...

Схема корреляции

Указывает схему корреляции для отправки ответных сообщений и сообщений обратного вызова.

Допустимые значения: requestmsgidtocorrelid (по умолчанию), requestcorrelidtocorrelid и none.

Фабрики начального контекста

Задает имя фабрики начального контекста для получения начального контекста JNDI.

Это необязательное свойство. Если фабрика не задана, то используется фабрика начального контекста WebSphere Application Server.

URL JNDI

Задает URL для поставщика JNDI.

Соединение запроса

Задает элемент binding.jms, имеющийся в файле определения комплекса.

Запрос - это сообщение, отправляемое службе SCA или отправляемое ссылкой SCA.

Соединение ответа

Задает элемент binding.jms, имеющийся в файле определения комплекса.

Ответ - это сообщение, получаемое по ссылке (то есть ответ из вызванной службы) или сообщение, отправляемое службой в ответ на предыдущее сообщение с запросом. Ответ в SCA - это всегда ответ на предыдущий запрос.

Формат проводника запроса

Задает имя элемента определения компонента для проводника, соединяющего комплексы SCA.

Например: wireFormat.jmsObject.

Запрос - это сообщение, отправляемое службе SCA или отправляемое ссылкой SCA.

Формат проводника ответа

Задает имя элемента определения компонента для проводника, соединяющего комплексы SCA.

Например: wireFormat.jmsObject.

Ресурсы

Задает ресурсы для привязки JMS. Параметры ресурса для свойств Имя JNDI назначения, Имя JNDI спецификации активации и Имя JNDI фабрики соединений можно не только просматривать, но и изменять. Все остальные параметры ресурса доступны только для чтения.

Тип приемника

Задает тип места назначения запроса. Допустимые значения: queue (очередь - значение по умолчанию) и topic (тема). Если задано значение topic, то все операции в интерфейсе, соответствующие данной привязке, должны быть односторонними.

Это значение доступно только для чтения и относится как к службам, так и к ссылкам.

@type - тип места назначения.

Имя JNDI места назначения

Задает необязательный параметр, вводящий имя JNDI места назначения, с которым связана привязка. Например: jms/InvokeService_Callback.

Можно задать имя места назначения как для служб, так и для ссылок.

@name - это имя JNDI места назначения.

Создание получателя

Позволяет разрешить создание получателя для связывания.

Допустимые значения: ifnotexist (по умолчанию), always и never. Если указано значение ifnotexist, то продукт в динамическом режиме создает ресурсы получателя, необходимые для составного объекта SCA (если эти ресурсы не существуют или не связаны с провайдером сообщений по умолчанию). Продукт создает ресурсы при добавлении составного объекта SCA в приложение бизнес-уровня.

Продукт проверяет составное определение при добавлении ресурса SCA в приложение бизнес-уровня. Если в ходе проверки будет обнаружена ошибка, продукт не добавляет ресурс в приложение. Если указано значение always и получатель существует, то развертывание прерывается с возвратом кода ошибки.

Имя JNDI спецификации активации

Задает спецификацию активации, используемую привязкой для соединения с местом назначения JMS для обработки сообщения с запросом. Значением должно быть имя JNDI.

Задать спецификацию активации можно только для служб.

Атрибуты этого элемента следуют за атрибутами, определенными для элемента назначения.

Создание спецификации активации

Позволяет разрешить создание спецификации активации для связывания. Создать спецификацию активации можно только для служб.

Допустимые значения: ifnotexist (по умолчанию), always и never. Если указано значение ifnotexist, то продукт в динамическом режиме создает ресурсы спецификации активации, необходимые для составного объекта SCA (если эти ресурсы не существуют или не связаны с провайдером сообщений по умолчанию). Если указано значение always и спецификация активации существует при добавлении составного объекта SCA в приложение бизнес-уровня, то развертывание прерывается с возвратом кода ошибки.

Имя JNDI фабрики соединений

Указывает фабрику соединений, используемую привязкой для обработки сообщения с запросом. Значением должно быть имя JNDI.

Задать имя JNDI фабрики соединений можно только для ссылок.

Атрибуты этого свойства следуют за атрибутами, определенными для элемента назначения. Это свойство нельзя использовать вместе со свойством activationSpec.

Создание фабрики соединений

Позволяет разрешить создание фабрики соединений для связывания. Фабрику соединений можно создать только для ссылок.

Допустимые значения: ifnotexist (по умолчанию), always и never. Если указано значение ifnotexist, то продукт в динамическом режиме создает ресурсы фабрики соединений, необходимые для составного объекта SCA (если эти ресурсы не существуют или не связаны с провайдером сообщений по умолчанию). Если указано значение always и фабрика соединений существует при добавлении составного объекта SCA в приложение бизнес-уровня, то развертывание прерывается с возвратом кода ошибки.

Ресурсы ответа

Задает ресурсы, используемые для обработки сообщений с ответом, для получения ответов по ссылке и для отправки ответов из службы. Элемент ответа определяет место назначения и либо фабрику соединений, либо элементы спецификации активации для обработки сообщений с ответом.

Ресурсы ответа относятся как к службам, так и к ссылкам. Параметры ресурса для свойств Имя JNDI места назначения ответа и Имя JNDI фабрики соединений ответа можно не только просматривать, но и изменять. Все остальные параметры ресурса доступны только для чтения.

Тип места назначения ответов

Задает тип места назначения ответов. Допустимые значения: queue (очередь - значение по умолчанию) и topic (тема). Если задано значение topic, то все операции в интерфейсе, соответствующие данной привязке, должны быть односторонними.

Это значение доступно только для чтения и относится как к службам, так и к ссылкам.

Имя JNDI места назначения ответов

Указывает место назначения, которое должно использоваться привязкой для обработки ответов. Атрибуты совпадают с атрибутами родительского элемента места назначения. Например: jms/InvokeService_Response.

Можно задать имя места назначения как для служб, так и для ссылок.

Создание получателя ответов

Позволяет разрешить создание получателя ответов для связывания.

Допустимые значения: ifnotexist (по умолчанию), always и never. Если указано значение ifnotexist, то продукт в динамическом режиме создает ресурсы получателя ответов, необходимые для составного объекта SCA (если эти ресурсы не существуют или не связаны с провайдером сообщений по умолчанию). Если указано значение always и получатель ответов существует при добавлении составного объекта SCA в приложение бизнес-уровня, то развертывание прерывается с возвратом кода ошибки.

Имя JNDI фабрики соединений ответов

Указывает фабрику соединений, используемую привязкой для обработки сообщения с ответами. Значением должно быть имя JNDI.

Можно задать фабрику соединений ответов как для служб, так и для ссылок.

Атрибуты этого элемента следуют за атрибутами, определенными для элемента назначения. Этот элемент нельзя использовать вместе с элементом activationSpec.

Создание фабрики соединений ответов

Позволяет разрешить создание фабрики соединений ответов, используемой привязкой для обработки сообщения с ответами.

Допустимые значения: ifnotexist (по умолчанию), always и never. Если указано значение ifnotexist, то продукт в динамическом режиме создает ресурсы фабрики соединений ответов, необходимые для составного объекта SCA (если эти ресурсы не существуют или не связаны с провайдером сообщений по умолчанию). Если указано значение always и фабрика соединений ответов существует при добавлении составного объекта SCA в приложение бизнес-уровня, то развертывание прерывается с возвратом кода ошибки.

Свойства заголовка запроса

Задает свойства заголовка JMS, применяемые к запросам из ссылки. Свойства заголовка изменить нельзя.

Если задано свойство заголовка JMS, это свойство не должно присутствовать в URI.

Тип JMS: Задает, какой тип JMS будет использоваться в свойстве заголовка JMS с использованием @JMSType.
ИД зависимости JMS: Задает, какой идентификатор зависимости JMS будет использоваться в свойстве заголовка JMS с использованием @JMSCorrelationID.
Режим доставки JMS: Задает, какой режим доставки JMS будет использоваться в свойстве заголовка JMS с использованием @JMSDeliveryMode.
Время хранения в кэше JMS: Задает время хранения в кэше JMS, которое будет использоваться в свойстве заголовка JMS с использованием @JMSTimeToLive.
Приоритет JMS: Задает, какой приоритет JMS будет использоваться в свойстве заголовка JMS с использованием @JMSPriority.
Свойство заголовка: Задает значение для использования в указанном пользовательском свойстве JMS.

Свойства заголовка ответов

Задает свойства заголовка JMS, применяемые к ответам службы на исходящие запросы. Свойства заголовка изменить нельзя.

Если задано свойство заголовка JMS, это свойство не должно присутствовать в URI.

Тип JMS: Задает, какой тип JMS будет использоваться в свойстве заголовка JMS с использованием @JMSType.
ИД зависимости JMS: Задает, какой идентификатор зависимости JMS будет использоваться в свойстве заголовка JMS с использованием @JMSCorrelationID.
Режим доставки JMS: Задает, какой режим доставки JMS будет использоваться в свойстве заголовка JMS с использованием @JMSDeliveryMode.
Время хранения в кэше JMS: Задает время хранения в кэше JMS, которое будет использоваться в свойстве заголовка JMS с использованием @JMSTimeToLive.
Приоритет JMS: Задает, какой приоритет JMS будет использоваться в свойстве заголовка JMS с использованием @JMSPriority.
Свойство заголовка: Задает значение для использования в указанном пользовательском свойстве JMS.

Имя файла: usca_jms_bindings.html