Создание посредника клиента Java и примера приложения на основе документа WSDL с помощью среды выполнения Axis1

Создание посредника клиента Java™ и примера приложения выполняется с помощью мастера клиентов веб-служб. Образец веб-приложения демонстрирует структуру кода файла посредника.

Предварительные требования:

  1. Если в качестве сервера используется контейнер сервлетов Apache Jakarta Tomcat, установите его, настройте его экземпляр и создайте для него веб-проект согласно инструкциям, приведенным в разделе Создание сервера Apache Tomcat и веб-проекта.
  2. Найдите и импортируйте документ WSDL в веб-проект. Файл WSDL должен содержать элемент service.
Для создания посредника клиента Java и примера приложения из найденного документа WSDL выполните следующие действия:
  1. Переключитесь на проекцию Java EE (Окно > Открыть проекцию > Java EE).
  2. В панели Навигатор выберите веб-проект, для которого требуется создать демонстрационное приложение.
  3. Выберите Файл > Создать > Прочие.... Выберите Веб-службы для просмотра различных мастеров веб-служб. Выберите мастер Клиент веб-службы. Нажмите кнопку Далее.
  4. Страница Веб-службы:
    1. Введите URI файла WSDL, WSIL или HTML, из которого будет создан клиент.
    2. Выберите тип посредника
    3. Выберите этапы разработки веб-служб, которые требуется завершить, с помощью ползунка:
      • Разработка: предусматривает разработку определения и реализации WSDL веб-службы. В частности, выполняются такие задачи, как создание модулей с исходным кодом и файлами Java, а также копирование файлов JAR Axis.
      • Сборка: позволяет связать проект, выбранный для размещения веб-службы или клиента, с файлом EAR (если это требуется целевым сервером приложений).
      • Развертывание: создание кода развертывания службы.
      • Установка: установка и настройка веб-модуля и файлов EAR на целевом сервере.
      • Запуск: запуск сервера после установки службы. При этом создается файл server-config.wsdd.
      • Тестирование: различные варианты тестирования службы; например, с помощью приложения Структура веб-служб или примеров JSP.
    4. Выберите сервер: показывается сервер по умолчанию. Для развертывания клиента на другом сервере щёлкните на ссылке и укажите его.
    5. Выберите среду выполнения: показывается среда выполнения по умолчанию. Для развертывания клиента в другой среде выполнения щёлкните на ссылке и укажите её.
    6. Выберите проект службы: показывается проект, содержащий клиент. Для выбора другого проекта и файла EAR щёлкните на ссылке. Убедитесь в том, что проект клиента не совпадает с проектом веб-службы, в противном случае служба будет перезаписана артефактами клиента.
    7. Мониторинг веб-службы: направлять трафик SOAP веб-службы через монитор TCP/IP, позволяющий наблюдать за ним и проверять на совместимость с WS-I. Монитор TCP/IP можно также настроить вручную, см. Использование монитора TCP/IP для тестирования веб-служб
  5. На странице посредника веб-службы доступны относящиеся к нему параметры. Будет показана папка, в которой должен быть сохранён посредник, и будет предложено определить дополнительные связи пространство имен - пакет.
  6. Страница Связи пространства имен веб-службы с пакетами: если на предыдущей странице выбран переключатель Задать пользовательскую связь пространства имен с пакетом, то на этой странице можно выбрать конкретные связи с помощью кнопки Добавить. Кнопка Импортировать позволяет импортировать пользовательские связи из файла .properties. Содержимое файла свойств должно быть указано в формате пространство_имен=пакет. Некоторые специальные символы в файлах свойств следует задавать как Esc-символы. Например, http://someNamespace=somePackage задается в виде http\://someNamespace=somePackage. В противном случае двоеточие (:) будет считаться разделителем, и http будет отображено в //someNamespace=somePackage.
  7. Если ранее было выбрано тестирование клиента веб-службы, будет показана соответствующая страница. Выберите утилиты, с помощью которой вы хотите тестировать посредник, и методы, включаемые в него. Обратите внимание на то, что универсальный клиент тестирования (UTC) совместим только с клиентами веб-служб, развертываемых на серверах ®.
  8. Нажмите Готово. Если ранее было выбрано тестирование посредника, тестовый клиент откроется в окне браузера.

Посредник EJB предоставляет интерфейс удаленного вызова процедур для веб-службы. Образец веб-приложения демонстрирует структуру кода файла посредника.

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

Дополнительную информацию о создании веб-проектов можно найти в документации по разработке веб-приложений.

Связанные концепции
Создание веб-служб в среде выполнения Apache Axis1