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

Мастер Веб-служба помогает создать каркас объекта EJB на основе существующего документа WSDL. Каркас объекта EJB содержит набор пустых методов, соответствующих операциям из документа WSDL. При создании EJB все методы имеют примитивные реализации, заменяемые при разработке EJB.

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

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