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