// 
//     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.
//

= Передача двоичных данных с помощью приложения веб-службы, часть 1: обзор
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Передача двоичных данных с помощью приложения веб-службы, часть 1: обзор - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Передача двоичных данных с помощью приложения веб-службы, часть 1: обзор

В рамках данного практического руководства будет создано веб-приложение Java EE, содержащее веб-службу, которая реализуется в качестве компонента сеанса без сохранения состояния. Кроме того, к веб-приложению будет необходимо добавить пакет с четырьмя файлами JPEG. У веб-службы есть две операции, доступные для клиентов: получение отдельных изображений и получение набора из четырех изображений в форме эскизов. Следует добавить частные методы, преобразующие файлы JPEG в массив байтов, а затем преобразовать массивы байтов в  ``изображения`` . В Java EE частные методы размещаются непосредственно в веб-службе, потому что веб-служба также является компонентом EJB.

После создания веб-службы будет выполнено ее развертывание на экземпляре сервера GlassFish 3.1 или более поздней версии. Встроенное средство тестирование веб-служб IDE NetBeans используется для просмотра образцов сообщений запросов и откликов SOAP.

Инфраструктура службы JAX-WS по умолчанию не позволяет информировать клиентов о необходимости выполнить интерпретацию двоичных данных как файлов JPEG. Поэтому необходимо создать копию файлов схемы XML и WSDL и изменить схему XML так, чтобы клиент мог быть проинформирован об ожидаемом типе содержимого  ``image/jpeg``  для возвращаемого элемента. Чтобы использовать настроенные WSDL и схему, следует также изменить код службы.

Наконец, необходимо создать клиентское приложение Java, отображающее изображения в альбоме, созданном с помощью компонентов Swing.

Полную версию службы и клиентских приложений можно загрузить из link:https://netbeans.org/projects/samples/downloads/directory/Samples%252FWeb%2520Services%252FWeb%2520Service%2520Passing%2520Binary%2520Data%2520--%2520EE6[+NetBeans Samples Catalog+].

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

image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]

1. Обзор
2. link:./flower_ws.html[+ Создание веб-службы+]
3. link:./flower-code-ws.html[+ Написание кода и тестирование веб-службы+]
4. link:./flower_wsdl_schema.html[+ Изменение файлов схемы и WSDL для передачи двоичных данных+]
5. link:./flower_swing.html[+ Создание клиента Swing+]


== Программное обеспечение, требуемое для работы с данным учебным курсом.

*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*

|===
|Программное обеспечение или материал |Требуемая версия 

|link:https://netbeans.org/downloads/index.html[+IDE NetBeans+] |Пакетная загрузка Java EE 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработчика на языке Java (JDK)+] |версия 7 или 8 

|Веб-сервер или сервер приложений, совместимый с Java EE |link:http://glassfish.java.net/[+GlassFish Server Open Source Edition 3.1 или более поздняя версия+]
 

|Изображения, используемые в этом учебном курсе |link:images/rose.jpg[+rose.jpg+]
link:images/sunflower.jpg[+sunflower.jpg+]
link:images/aster.jpg[+aster.jpg+]
link:images/honeysuckle.jpg[+honeysuckle.jpg+] 
|===

*Примечание.* Сервер GlassFish можно установить с комплектом загрузки Java EE IDE NetBeans. Также можно воспользоваться link:https://glassfish.java.net/download.html[+страницей загрузок сервера GlassFish+].

*Рекомендация.*Дополнительно, в целях поиска и устранения ошибок, можно link:https://netbeans.org/files/documents/4/2343/SoapWithAttachments.zip[+загрузить готовый пример+] и изучить исходный код.

По завершении работы с этим учебным курсом должно получиться работающее приложение на Java для Swing, использующее изображения JPEG через веб-службу, со следующим результатом.

image::images/running-client.png[title="В JFrame отображаются все изображения цветов, переданные из веб-службы"]


== Что дальше?

link:./flower_ws.html[+ Создание веб-службы+]

link:/about/contact_form.html?to=3&subject=Feedback:%20Flower%20Overview%20EE6[+Отправить отзыв по этому учебному курсу+]


== Дополнительные сведения

Для получения базовой информации перед переходом к этому учебному курсу ознакомьтесь со следующими материалами:

* link:./jax-ws.html[+Начало работы с веб-службами JAX-WS+]
* link:../../docs/websvc/client.html[+Разработка клиентов веб-служб +]
* link:../javaee/javaee-gettingstarted.html[+Начало работы с приложениями Java EE+]
* link:./wsit.html[+Расширенные возможности взаимодействия веб-служб+]

Для отправки комментариев и предложений, получения поддержки и новостей о последних разработках, связанных с Java EE IDE NetBeans link:../../../community/lists/top.html[+присоединяйтесь к списку рассылки nbj2ee@netbeans.org+].