Служба MTOM - настройка и запуск


Настройка примера
Запуск примера

Существует два клиента службы Message Transmission Optomization Mechanism (MTOM): версия для командной строки, использующая простой клиент для JAX-WS с файлом JAR WebSphere Application Server, и версия сервлета, использующая страницы JavaServer (JSP) для доступа к службе MTOM.

Конечные точки примера службы
URI Описание
http://localhost:9080/WSSampleMTOM/MtomSampleService
Пример службы MTOM с использованием SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Пример службы MTOM с использованием SOAP 1.2

Номер порта по умолчанию - 9080. Если установка выполняется в профайле, отличном от AppSrv01, применяется другой номер порта.



Настройка примера

Для настройки примера установите приложение, демонстрирующее применение Web-служб JAX-WS, на сервере. Инструкции приведены в разделе Перекомпоновка и развертывание файла JaxWSServicesSamples.ear.

Запуск примера

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

Пример службы MTOM состоит из двух клиентов и одного объекта EJB, развертываемого на сервере. Один клиент представляет собой версию для командной строки, использующую простой клиент для JAX-WS с файлом JAR WebSphere Application Server. Второй клиент - это версия сервлета, использующая файл JSP для доступа к службе MTOM.

Запуск сервлета службы MTOM
Запуск простого приложения-клиента службы MTOM

Клиенты службы MTOM

Клиенты службы MTOM отправляют файл, закодированный с помощью MTOM, в указанную конечную точку службы. По умолчанию применяется локальный хост, однако это значение можно изменить. Имя файла является обязательным параметром, значение по умолчанию отсутствует. В данном примере служба возвращает файл, полученный от клиента, используя модель программирования dispatch или proxy.

Запуск клиента сервлета службы MTOM

Клиент сервлета службы MTOM не является управляемым контейнером.

Дополнительная информация о вызове клиента сервлета в среде простого клиента для JAX-WS приведена в документации по запуску неуправляемого клиента Web-служб JAX-WS в Библиотеке WebSphere Application Server Information Center.

Для запуска простого клиента службы сервлета MTOM из WebSphere Application Server выполните следующие действия:

  1. Запустите сервер приложений.
  2. Нажмите кнопку Выполнить.

Запуск простого приложения-клиента службы MTOM

Файл WSSampleMTOMClient.jar - это версия простого клиента службы MTOM, запускаемая из командной строки.

Далее переменная app_server_root - это установочный каталог сервера приложений.

Для запуска простого клиента службы MTOM из WebSphere Application Server выполните следующие действия, в зависимости от используемой операционной системы:

  1. Запустите сервер приложений.
  2. Откройте окно командной строки.
  3. Перейдите в каталог JaxWSServicesSamples.

    В операционных системах Windows:

    cd app_server_root\samples\bin\JaxWSServicesSamples

    В системах AIX, Linux и z/OS:

    cd app_server_root/samples/bin/JaxWSServicesSamples

    В операционных системах iSeries:

    cd app_server_root/samples/bin/JaxWSServicesSamples

  4. Запустите пример службы MTOM.

    В операционных системах Windows:

    runSampleMtom.bat -i имя-файла -h имя-хоста -p порт -f суффикс-url -d -x -1 -2

    В системах AIX, Linux и z/OS:

    ./runSampleMtom.sh -i имя-файла -h имя-хоста -p порт -f суффикс-url -d -x -1 -2

    В операционных системах iSeries:

    ./runSampleMtom -i имя-файла -h имя-хоста -p порт -f суффикс-url -d -x -1 -2

    Возможные параметры:
    -i <имя-файла> - имя файла для отправки. Обязательный параметр, значение по умолчанию отсутствует.
    -h <имя-хоста> - имя хоста. Значение по умолчанию: localhost.
    -p <порт> - номер порта. Значение по умолчанию: 9080.
    -f <суффикс-url> - контекст конечной точки службы. Значение по умолчанию - /WSSampleMTOM/MtomSampleService.
    -d указывает, что применяется только модель dispatch.
    -x указывает, что применяется только модель proxy.
    -1 указывает, что применяется SOAP 1.1. Этот параметр задан по умолчанию.
    -2 указывает, что применяется SOAP 1.2.

    Следующий пример демонстрирует запуск простого клиента службы MTOM в системе Windows:

    runSampleMtom.bat -i c:\SYSLEVEL.IBM -p 9081
    >>---------------------------------------
    >>MTOM Dispatch Test
    >>MTOM Loading data from: 'file:/c:/SYSLEVEL.IBM'
    Aug 10, 2007 12:11:49 PM com.ibm.ws.ssl.config.SSLConfigManager
    INFO: ssl.disable.url.hostname.verification.CWPKI0027I
    >>MTOM Invoking Dispatch with a binary payload
    >>MTOM Response received
    >>MTOM Writing returned image to dispatch_response.gif
    >>MTOM Dispatch Done
    >>---------------------------------------
    >>MTOM Proxy Test
    >>MTOM Invoking proxy with a binary payload
    >>MTOM Response received
    >>MTOM Writing returned image to proxy_response.gif
    >>MTOM Proxy Done

Более детальная информация о том, каким образом работают клиент и приложение, содержится в комментариях к службе MTOM, кроме того доступен исходный код Java.