Мастер Web-служб предназначен для упрощения создания Web-службы, настройки её развертывания и самого развертывания Web-службы на сервере.
После завершения развертывания Web-службы мастер сгенерирует программу-посредник
и демонстрационное приложение для тестирования Web-службы. После тестирования Web-службу можно опубликовать в реестре UDDI Business Registry с помощью мастера экспорта.
Предварительные требования:
- Если в качестве сервера используется Apache Jakarta Tomcat, установите его, настройте его экземпляр и создайте для него Web-проект согласно инструкциям, приведенным в Создание сервера Apache Tomcat и Web-проекта
- Создайте или импортируйте объект Javabean в папку исходного кода на Java™ Web-проекта.
Для того чтобы создать Web-службу на основе bean-объекта в среде выполнения Apache Axis:
- Перейдите к проекции J2EE (Окно > Открыть проекцию
> J2EE).
- Выберите в панели Структура проекта bean-объект, созданный или импортированный в папку исходного кода Web-проекта.
- Выберите
Файл > Создать > Прочие. Выберите Web-службы для вывода списка мастеров Web-служб.
Выберите мастер Web-служба. Нажмите кнопку Далее.
- На странице Web-службы выберите Web-служба на основе WSDL в качестве типа Web-службы и введите URI файла WSDL, WSIL или HTML, на основе которого будет сгенерирована служба.
- Выберите этапы разработки Web-служб, которые требуется завершить, с помощью ползунка:
- Разработка: создание исходного кода службы
- Сборка:
- Развертывание: создание кода для развертывания службы
- Установка: установка службы на выбранном сервере
- Запуск: запуск сервера после установки на нём службы
- Тестирование: включение функций по тестированию службы
- Выберите сервер: показывается сервер по умолчанию. Для развертывания службы на другом сервере щелкните на ссылке и укажите его.
- Выберите среду выполнения: показывается среда выполнения по умолчанию. Для развертывания службы в другой среде выполнения щелкните на ссылке и укажите ее.
- Выберите проект службы: показывается проект, содержащий службу. Для выбора другого проекта и файла EAR щёлкните на ссылке. Убедитесь в том, что проект клиента
не совпадает с проектом Web-службы, в противном случае служба будет перезаписана артефактами клиента.
- Для создания клиента выберите тип посредника и повторите приведенные выше шаги для клиента.
- Опубликовать Web-службу: запустить проводник Web-служб и опубликовать Web-службу в реестре UDDI.
- Мониторинг Web-службы: направлять трафик SOAP Web-службы через
монитор TCP/IP, позволяющий наблюдать за ним и проверять на совместимость с
WS-I. Монитор TCP/IP можно также настроить вручную, см. Использование монитора TCP/IP для тестирования Web-служб
- На странице идентификации объекта JavaBean Web-службы будет выведено имя файла WSDL Web-службы. Доступны следующие опции:
- Выберите экспортируемые методы.
- Выберите тип кодирования. Для среды выполнения Axis рекомендуемый тип кодирования - RPC/Encoded. Он не совместим с WS-I.
- Можно изменить набор связей пакет - пространство имен.
Нажмите Далее
- Если переключатель Задать пользовательскую связь пакет - пространство имен отмечен, то на странице Связи пакет - пространство имен можно определить дополнительные связи пространств имен и пакетов с помощью кнопки Добавить.
- Если тестирование было выбрано ранее, на странице тестирование Web-службы выберите средство для тестирования созданной Web-службы.
Web-служба откроется в проводнике Web-служб. Выберите тестируемую операцию, введите требуемые данные и нажмите Перейти.
О результате тестирования будет сообщено на панели Состояние. Нажмите кнопку Далее.
- Если ранее было выбрано создание посредника, на странице посредника Web-службы можно изменить связи пакет - пространство имен.
- На странице тестирования клиента Web-службы доступны следующие опции:
- Выбор средства тестирования. Сгенерированный посредник можно тестировать в
проводнике Web-служб, либо можно сгенерировать демонстрационную страницу JSP для Web-службы.
- Если ранее для тестирования посредника была выбрана страница JSP, вам будет предложено выбрать папку, в которой она расположена, и методы, которые будут в неё включены.
- Выберите Запустить тест на сервере для автоматического запуска сервера.
- На странице публикации Web-службы выберите, публиковать ли её в реестре UDDI. Нажмите Готово. Примечание: Может быть показано замечание следующего содержания Ошибка генерирования WSDL из Java. Класс не найден: <имя bean-объекта>. Её следует проигнорировать.
После создания Web-службы могут выполняться следующие действия, в зависимости от выбранных опций:
- Если было выбрано тестирование посредника с помощью JSP Web-службы, посредник открывается в Web-браузере по такому URL: http://localhost: порт/ Web-проектClient/sampleобъект-Bean/Web-служба/TestClient.jsp Для тестирования Web-службы выберите метод, введите его параметры и нажмите
Вызвать.
Результат выполнения метода будет показан на панели Результаты.
- Если было выбрано тестирование Web-службы с помощью проводника Web-служб, откроется последний. Выберите тестируемую операцию, введите требуемые данные и нажмите Перейти.
О результате тестирования будет сообщено на панели Состояние.
- Если была выбрана публикация Web-службы, то откроется проводник Web-служб для ввода параметров публикации. Далее следуйте инструкциям раздела
Публикация Web-службы.
Важно: Если методах содержат типы, не поддерживаемые демонстрационным приложением, такие как индексируемые свойства, массивы и коллекции, эти методы будут удалены из демонстрационного приложения, об этом будет сообщено в замечании.