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

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

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

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

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

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

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

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

Процедура

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

Результаты

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

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

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