| // |
| // Licensed to the Apache Software Foundation (ASF) under one |
| // or more contributor license agreements. See the NOTICE file |
| // distributed with this work for additional information |
| // regarding copyright ownership. The ASF licenses this file |
| // to you under the Apache License, Version 2.0 (the |
| // "License"); you may not use this file except in compliance |
| // with the License. You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, |
| // software distributed under the License is distributed on an |
| // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| // KIND, either express or implied. See the License for the |
| // specific language governing permissions and limitations |
| // under the License. |
| // |
| |
| = Сквозная передача двоичных данных – вложение SOAP 2: создание веб-службы |
| :jbake-type: tutorial |
| :jbake-tags: tutorials |
| :jbake-status: published |
| :icons: font |
| :syntax: true |
| :source-highlighter: pygments |
| :toc: left |
| :toc-title: |
| :description: Сквозная передача двоичных данных – вложение SOAP 2: создание веб-службы - Apache NetBeans |
| :keywords: Apache NetBeans, Tutorials, Сквозная передача двоичных данных – вложение SOAP 2: создание веб-службы |
| |
| Целью этого урока является создание веб-приложения, содержащего веб-службу. Рассматривается реализация веб-службы в качестве сеансного компонента без сохранения состояния. |
| |
| Готовый образец веб-службы можно загрузить из link:https://netbeans.org/projects/samples/downloads/download/Samples%252FWeb%2520Services%252FWeb%2520Service%2520Passing%2520Binary%2520Data%2520--%2520EE6%252FFlowerAlbumService.zip[+каталога примеров NetBeans+]. |
| |
| *Уроки, представленные в этом учебном курсе* |
| |
| image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"] |
| |
| 1. link:./flower_overview.html[+Обзор+] |
| 2. => Создание веб-службы |
| 3. link:flower-code-ws.html[+Написание кода веб-службы и ее тестирование+] |
| 4. link:./flower_wsdl_schema.html[+ Изменение файлов схемы и WSDL для передачи двоичных данных+] |
| 5. link:./flower_swing.html[+ Создание клиента Swing+] |
| |
| |
| [start=1] |
| 1. <<create-web-app,Создание веб-приложения>> |
| 2. <<add-ws,Добавление веб-службы>> |
| |
| |
| [[create-web-app]] |
| == Создание веб-приложения |
| |
| В этом разделе описывается создание веб-приложения Java EE. Также описывается добавление в это приложение изображений, передаваемых веб-службой в качестве двоичных данных. |
| |
| *Чтобы создать веб-приложение, выполните следующие действия.* |
| |
| 1. Выберите 'Файл' > 'Создать проект' (Ctrl-Shift-N в Windows и Linux, ⌘-Shift-N в ОС Mac). Откроется мастер создания проекта. Выберите "Веб-приложение" из категории "Java Web" и нажмите кнопку "Далее". Откроется страница "Имя и местоположение". |
| 2. Введите текст ``FlowerAlbumService`` в поле "Имя проекта". Выберите папку проекта. Сохраните настройки по умолчанию для остальных параметров и нажмите кнопку "Далее". Откроется страница "Сервер и параметры настройки". |
| 3. Выберите сервер GlassFish и укажите Java EE 6 Web или Java EE 7 Web в качестве версии Java EE. |
| 4. Нажмите кнопку "Завершить". Проект ``FlowerAlbumService`` создан и отображается в окне "Проекты". |
| 5. Щелкните узел "Исходные файлы" правой кнопкой мыши и выберите в меню "Создать" пункт "Пакет Java". |
| |
| Также можно выбрать пункт меню "Создать > Другие" и выбрать "Пакет Java" в категории "Java" мастера создания файлов. |
| |
| |
| [start=6] |
| . Присвойте пакету имя ``org.flower.resources`` . Нажмите кнопку "Завершить". |
| image::images/new-package.png[] |
| |
| [start=7] |
| . Скопируйте следующие изображения в пакет ``org.flower.resources`` : |
| * link:images/rose.jpg[+rose.jpg+] |
| * link:images/sunflower.jpg[+sunflower.jpg+] |
| * link:images/aster.jpg[+aster.jpg+] |
| * link:images/honeysuckle.jpg[+honeysuckle.jpg+] |
| |
| Теперь в исходном файле проекта существует пакет ``org.flower.resources`` . В файле содержится только этот пакет. |
| |
| image::images/project-w-resources.png[] |
| |
| |
| [[add-ws]] |
| == Добавление веб-службы |
| |
| В этом разделе рассматривается создание веб-службы в веб-приложении. Веб-служба создается как сеансный компонент без сохранения состояния. Необходимо добавить в службу следующие веб-операции: |
| |
| * операция, которая принимает имя цветка и получает связанный с ним объект ``Image`` ; |
| * операция, которая получает эскизы всех изображений цветов и возвращает их в виде объекта `` List`` . |
| |
| *Добавление веб-службы:* |
| |
| 1. В окне 'Проекты' щелкните правой кнопкой мыши узел проекта ``FlowerAlbumService`` и выберите 'Создать' > 'Веб-служба'. Также можно выбрать в меню "Создать" пункт "Прочее" и затем выбрать веб-службу в списке веб-служб мастера создания файла. Откроется мастер создания веб-службы. |
| 2. В диалоговом окне мастера создания веб-службы введите в поле "Имя веб-службы" текст ``FlowerService`` , а в поле "Имя пакета" – ``org.flower.service`` . Установите флажок "Создать веб-службу "с нуля"". Установите флажок "Реализовать веб-службу в качестве сеансного компонента без оператора". Нажмите кнопку "Завершить". |
| image::images/new-service.png[] |
| |
| В узле проекта в окне "Проекты" появится веб-служба. Каталог "Исходные файлы" включает в себя пакет для веб-служб и пакет ресурсов. |
| |
| image::images/project-w-service-and-resources.png[] |
| |
| [start=3] |
| . Откройте в редакторе файл ``FlowerService.java`` . Перейдите к представлению "Проектирование". Появится форма для добавления операций и элементов качества обслуживания в веб-службу. |
| image::images/flower-service-empty-design.png[] |
| |
| [start=4] |
| . Нажмите кнопку "Добавить операцию". Откроется мастер добавления операции. |
| |
| [start=5] |
| . Присвойте операции имя ``getFlower`` . Введите в поле "Тип возвращаемого значения" текст ``java.awt.Image`` или найдите этот тип, нажав кнопку "Обзор". |
| |
| [start=6] |
| . Выберите вкладку "Параметры" и нажмите кнопку "Добавить". Введите текст ``name`` в качестве имени параметра и примите тип ``java.lang.String`` по умолчанию. |
| image::images/add-getflower-param.png[] |
| |
| [start=7] |
| . Откройте вкладку "Исключения". Добавьте исключение ``IOException`` . |
| image::images/io-exception.png[] |
| |
| [start=8] |
| . Нажмите кнопку "ОК" и закройте мастер. Снова нажмите кнопку "Добавить операцию" и добавьте операцию со следующими свойствами: |
| * *Имя:* getThumbnails |
| * *Тип возвращаемого значения:* java.util.List |
| * *Исключение: * IOException |
| |
| Теперь в представлении "Проектирование" отображаются операции ``getFlower`` и ``getThumbnails`` . Перейдите в представление списка для обеих операций и просмотрите все параметры. |
| |
| image::images/flower-service-full-design.png[] |
| |
| |
| == |
| |
| |
| == Что дальше? |
| |
| link:./flower-code-ws.html[+Написание кода веб-службы и ее тестирование+] |
| |
| link:/about/contact_form.html?to=3&subject=Feedback:%20Flower%20Creating%20WS%20EE6[+Отправить отзыв по этому учебному курсу+] |
| |
| |
| Для отправки комментариев и предложений, получения поддержки и новостей о последних разработках, связанных с Java EE IDE NetBeans link:../../../community/lists/top.html[+присоединяйтесь к списку рассылки nbj2ee@netbeans.org+]. |
| |