Добавление конечных точек к виртуальным службам

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

Прежде чем начать

  1. С помощью IBM Integration Designer создайте шлюз прокси. С помощью мастера создайте модуль шлюза прокси, являющийся модулем SCA, содержащим примитив передачи Поиск конечной точки шлюза.
  2. Разверните модуль шлюза прокси на WebSphere Enterprise Service Bus (WebSphere ESB) или IBM Business Process Manager.
  3. Создайте бизнес-пространство с виджетом Шлюз прокси.

Об этой задаче

Шлюз прокси - это модуль, получающий запросы веб-служб и передающий их в конечную точку, определенную в группе прокси. Группы прокси содержат виртуальные службы, которые вы соединяете с фактическими конечными точками служб. С виртуальной службой может быть связана одна или несколько конечных точек.

При создании модуля шлюза прокси вы определяете группы прокси для данного модуля. После развертывания модуля шлюза прокси можно воспользоваться виджетом Шлюза прокси для добавления виртуальных служб к группам прокси. Информация о виртуальной службе хранится во встроенном хранилище конфигурации в WebSphere ESB и IBM Business Process Manager.

Когда шлюз прокси обрабатывает запрос клиента, имя виртуальной службы, которое используется для поиска конечных точек, должно совпадать с именем виртуальной службы в запросе клиента. Если вы создаете модуль шлюза прокси с типом маршрутизации по умолчанию, то есть, на основе URL-адреса, и используете URL, указанный в обработанном WSDL, маршрутизация запроса выполняется автоматически. Если вы создаете модуль шлюза прокси с маршрутизацией на основе XPath, убедитесь в том, что указанное расположение сообщения содержит верное имя виртуальной службы.

Процедура

  1. Войдите в бизнес-пространство и откройте страницу с виджетом Шлюз прокси.
  2. В виджете Шлюз прокси нажмите значок карандаша рядом с требуемой группой прокси. Виджет Шлюз прокси будет обновлен. Если хранилище конфигурации содержит виртуальные службы для группы прокси, то эти виртуальные службы будут отображены. Если виртуальная служба связана с несколькими конечными точками, в таблице отображается только первая конечная точка.
  3. Выберите виртуальную службу, нажав значок карандаша в конце строки. Виджет Шлюз прокси обновится и покажет следующую информацию:
    • Тип порта: Значение параметра WSDL portType для виртуальной службы.
    • Имя виртуальной службы: Имя виртуальной службы, которое хранится в хранилище конфигурации. Имя по умолчанию вводится автоматически. Оно основано на имени службы в обработанном WSDL.
    • URL-адреса виртуальной службы::
      • Шлюз прокси: Имя модуля шлюза прокси.
      • Конечная точка: Конечная точка виртуальной службы.
    • Включить виртуальную службу: Переключатель, который указывает на то, возможна ли отправка сообщений виртуальной службе.
    • URL-адреса конечных точек: Одна или несколько конечных точек с сетевыми адресами, на которые возможна пересылка сообщения. Если вы определили список конечных точек, то можете определить и порядок, в котором производятся попытки их использовать. Упорядочить конечные точки можно, перемещая конечные точки вверх и вниз по списку.
    • Расширенные свойства службы: Если требуется выполнить специальную обработку определенной виртуальной службы, можно воспользоваться Расширенными свойствами службы. Расширенные свойства службы - это пары ключ-значение, которые должны быть доступными в потоке передачи, после примитива передачи Поиск конечной точки шлюза. Например, может потребоваться указать расположение таблицы стилей XSL, связанной с этой виртуальной службой. В среде выполнения пары ключ-значение хранятся в параметре EndpointLookupContext объекта сообщений службы (SMO).
      • Имя: Имя ключа.
      • Значение: Значение ключа.
  4. Нажмите Добавить конечную точку, чтобы добавить конечную точку в виртуальную службу.
  5. Сохраните информацию о конечной точке.

Результаты

Новая конечная точка добавляется во встроенное хранилище конфигураций, и виджет Шлюз прокси будет обновлен.

Дальнейшие действия

  1. Извлеките WSDL, который должен использоваться клиентом для вызова виртуальной службы. Получить WSDL можно путем ввода конечной точки URL виртуальной службы в веб-браузере, дополненной строкой ?wsdl. Например, http://zzz/Gold?wsdl, где http://zzz/ - это адрес шлюза прокси, а Gold - имя виртуальной службы.
    Прим.: Конечная точка URL виртуальной службы должна быть указана в поле Конечная точка под заголовком URL-адреса виртуальной службы.
  2. Для доступа к шлюзу прокси используется клиент. Шлюз прокси перенаправляет ваш запрос на реальную службу, связанную с виртуальной службой.