corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Сквозная передача двоичных данных – вложение SOAP 2: создание веб-службы

Целью этого урока является создание веб-приложения, содержащего веб-службу. Рассматривается реализация веб-службы в качестве сеансного компонента без сохранения состояния.

Готовый образец веб-службы можно загрузить из каталога примеров NetBeans.

Уроки, представленные в этом учебном курсе

Сведения на этой странице относятся к среде IDE NetBeans 6.9-7.1
  1. Обзор
  2. => Создание веб-службы
  3. Написание кода веб-службы и ее тестирование
  4. Изменение схемы и файлов WSDL для передачи двоичных данных
  5. Создание клиента Swing

Содержание урока

  1. Создание веб-приложения
  2. Добавление веб-службы

Создание веб-приложения

В этом разделе рассматривается создание веб-приложения EE6. Также описывается добавление в это приложение изображений, передаваемых веб-службой в качестве двоичных данных.

Чтобы создать веб-приложение, выполните следующие действия.

  1. Выберите "Файл" > "Новый проект" (Ctrl-Shift-N в ОС Linux и Windows, ⌘-Shift-N в ОС MacOS). Откроется мастер создания проекта. Выберите "Веб-приложение" из категории "Java Web" и нажмите "Далее". Откроется страница "Имя и местоположение".
  2. Введите текст FlowerAlbumService в поле "Имя проекта". Выберите папку проекта. Сохраните настройки по умолчанию для остальных параметров и нажмите кнопку "Далее". Откроется страница "Сервер и параметры настройки".
  3. Выберите сервер GlassFish 3.1 и Java EE версии EE6 Web.

    Обратите внимание! Необходимо использовать GlassFish Server Open Source Edition версии 3.1 b27 или более поздней версии. Настроенный файл схемы, который был создан в разделе Изменение файлов схемы и WSDL, не работает с сервером GlassFish 3.0.1. Проверьте версию используемого сервера GlassFish в окне "Службы".

  4. Нажмите кнопку "Готово". Проект FlowerAlbumService создан и отображается в окне "Проекты".
  5. Щелкните узел "Исходные файлы" правой кнопкой мыши и выберите в меню "Создать" пункт "Пакет Java". Откроется мастер создания пакетов Java.
  6. Присвойте пакету имя org.flower.resources. Нажмите кнопку "Готово".
    Мастер создания пакетов с именем и местоположением пакета org.flower.resources
  7. Скопируйте следующие изображения в пакет org.flower.resources:

Теперь в исходном файле проекта существует пакет org.flower.resources. В файле содержится только этот пакет.

Проект, в котором содержатся только изображения с цветами

Добавление веб-службы

В этом разделе рассматривается создание веб-службы в веб-приложении. Веб-служба создается как сеансный компонент без сохранения состояния. Необходимо добавить в службу следующие веб-операции:

  • операция, которая принимает имя цветка и получает связанный с ним объект Image;
  • операция, которая получает эскизы всех изображений цветов и возвращает их в виде объекта List.

Добавление веб-службы:

  1. Щелкните в окне "Проекты" узел проекта FlowerAlbumService правой кнопкой мыши и выберите в меню "Создать" пункт "Веб-служба". Также можно выбрать в меню "Создать" пункт "Прочее" и затем выбрать веб-службу в списке веб-служб мастера создания файла. Откроется мастер создания веб-службы.
  2. В диалоговом окне мастера создания веб-службы введите в поле "Имя веб-службы" текст FlowerService, а в поле "Имя пакета" – org.flower.service. Установите флажок "Создать веб-службу "с нуля"". Установите флажок "Реализовать веб-службу в качестве сеансного компонента без оператора". Нажмите кнопку "Готово".
    Заполненная страница мастера создания службы

    В узле проекта в окне "Проекты" появится веб-служба. Каталог "Исходные файлы" включает в себя пакет для веб-служб и пакет ресурсов.

    Окно "Проекты" с файлами изображений цветов и веб-службой
  3. Откройте в редакторе файл FlowerService.java. Перейдите к представлению "Проектирование". Появится форма для добавления операций и элементов качества обслуживания в веб-службу.
    Представление "Проектирование" для файла FlowerService без добавленных элементов
  4. Нажмите кнопку "Добавить операцию". Откроется мастер добавления операции.
  5. Присвойте операции имя getFlower. Введите в поле "Тип возвращаемого значения" текст java.awt.Image или найдите этот тип, нажав кнопку "Обзор".
  6. Выберите вкладку "Параметры" и нажмите кнопку "Добавить". Введите текст name в качестве имени параметра и примите тип java.lang.String по умолчанию.
    Вкладка "Добавить операцию" с именем и типом возвращаемого значения для операции getFlower, а также с именем параметра
  7. Откройте вкладку "Исключения". Добавьте исключение IOException.
    Поиск исключения IOException
  8. Нажмите кнопку "ОК" и закройте мастер. Снова нажмите кнопку "Добавить операцию" и добавьте операцию со следующими свойствами:
    • Имя: getThumbnails
    • Тип возвращаемого значения: java.util.List
    • Исключение: IOException

Теперь в представлении "Проектирование" отображаются операции getFlower и getThumbnails. Перейдите в представление списка для обеих операций и просмотрите все параметры.

Представление "Проектирование" файла FlowerService с операциями

 

Что дальше?

Написание кода веб-службы и ее тестирование


Оставить комментарии и предложения, обратиться за поддержкой и получить информацию о последних достижениях в области функциональных возможностей разработки для Java EE в среде IDE NetBeans можно в списке рассылки .