| // |
| // 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. |
| // |
| |
| = 通过 Web 服务传递二进制数据，第 1 部分：概述 |
| :jbake-type: tutorial |
| :jbake-tags: tutorials |
| :jbake-status: published |
| :icons: font |
| :syntax: true |
| :source-highlighter: pygments |
| :toc: left |
| :toc-title: |
| :description: 通过 Web 服务传递二进制数据，第 1 部分：概述 - Apache NetBeans |
| :keywords: Apache NetBeans, Tutorials, 通过 Web 服务传递二进制数据，第 1 部分：概述 |
| |
| 在本教程中，将创建一个包含 Web 服务的 Java EE Web 应用程序，该应用程序将作为无状态会话 Bean 来实现。同时还会向该 Web 应用程序添加包含四个 JPEG 文件的包。Web 服务有两种操作可供客户端访问，一是获取单个图像，二是以缩略图形式获取一组所有 4 个图像。将添加一些私有方法，用于将 JPEG 文件转换为字节数组，然后将这些字节数组转换为 ``Image`` 对象。在 Java EE 中，将这些私有方法直接放在 Web 服务中，因为 Web 服务还是一个 EJB。 |
| |
| 在创建 Web 服务后，将其部署到 GlassFish Server 3.1 或更高版本的实例中。使用 NetBeans IDE 的内置 Web 服务测试器可查看样例 SOAP 请求和响应消息。 |
| |
| 默认的 JAX-WS 服务基础结构无法通知客户端需要将二进制数据解释为 JPEG 文件。因此，将生成一个 XML 方案的副本以及 WSDL 文件，然后编辑 XML 方案以告知任何客户端期望的返回元素是 ``image/jpeg`` 内容类型。还将更改服务代码以使用定制的 WSDL 和方案。 |
| |
| 最后，将创建一个 Java 客户端应用程序，用于在相册中显示通过 Swing 组件创建的图像。 |
| |
| |
| *本教程中的课程* |
| |
| image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"] |
| |
| 1. => 概述 |
| 2. link:./flower_ws.html[+创建 Web 服务+] |
| 3. link:./flower-code-ws.html[+对 Web 服务进行编码和测试+] |
| 4. link:./flower_wsdl_schema.html[+修改方案文件和 WSDL 文件以传递二进制数据+] |
| 5. link:./flower_swing.html[+创建 Swing 客户端+] |
| |
| |
| == 本教程所需要的软件 |
| |
| *要学习本教程，您需要具备以下软件和资源。* |
| |
| |=== |
| |软件或资源 |要求的版本 |
| |
| |link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |Java EE 下载包 |
| |
| |link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java 开发工具包 (JDK)+] |版本 7 或 8 |
| |
| |符合 Java EE 规范的 Web 服务器或应用服务器 |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 Server 可以随同 NetBeans IDE 的 Java EE 下载包一起安装。或者，还可以访问 link:https://glassfish.java.net/download.html[+GlassFish Server 下载页+]。 |
| |
| *提示：*（可选）要解决疑难问题，可以link:https://netbeans.org/files/documents/4/2343/SoapWithAttachments.zip[+下载完整的样例+]并查看其源代码。 |
| |
| 执行完本教程中的操作后，将具有一个可运行的 Java Swing 应用程序，它通过 Web 服务使用 JPEG 图像，具体结果显示如下。 |
| |
| image::images/running-client.png[title="显示从 Web 服务传递的所有鲜花图像的 JFrame"] |
| |
| |
| == 后续步骤： |
| |
| link:./flower_ws.html[+创建 Web 服务+] |
| |
| link:/about/contact_form.html?to=3&subject=Feedback:%20Flower%20Overview%20EE6[+发送有关此教程的反馈意见+] |
| |
| |
| |
| == 另请参见 |
| |
| 有关使用本教程前的背景信息，请参见以下资源： |
| |
| * link:./jax-ws.html[+JAX-WS Web 服务入门指南+] |
| * link:../../docs/websvc/client.html[+开发 Web 服务客户端+] |
| * link:../javaee/javaee-gettingstarted.html[+Java EE 应用程序入门指南+] |
| * link:./wsit.html[+Advanced Web Service Interoperability+]（高级 Web 服务互操作性） |
| |
| 要发送意见和建议、获得支持以及随时了解 NetBeans IDE Java EE 开发功能的最新开发情况，请link:../../../community/lists/top.html[+加入 nbj2ee@netbeans.org 邮件列表+]。 |
| |
