FeaturesDocs & SupportCommunityBlogsPartners

通过 Web 服务传递二进制数据,第 5 部分:修改架构文件和 WSDL 文件

在此部分,您可以将 WSDL 文件和架构文件添加到我们的应用程序。然后对它们进行修改,以将字节数组转换为图像。还要调节应用程序的各个部分,以正确定位架构和 WSDL 文件。在此过程中,将向您介绍 IDE 中的各种工具,帮助您处理 WSDL 和架构文件。

您可以将本部分介绍的过程应用于任何 JAX-WS Web 服务,以便将任何 MIME 类型作为二进制数据进行传递。您将从传递二进制数据的 Web 服务(已在第 2 和第 3 课中创建)着手,定制该服务的 WSDL 和 XML 架构。在定制的 XML 架构文件中,您将在二进制数据的返回元素中添加 expectedContentTypes="mime_type" 属性。此属性通知客户端,它应将二进制数据映射到 Java 类型(按照从 MIME 到 Java 类型的映射),而不是字节数组。在本教程中,您将二进制数据映射到 java.awt.Image;不过,您也可以将二进制数据映射到 JAXB 2.0 规范中给定的任何 Java 类型,如 JAX-WS Users Guide(JAX-WS 用户指南)中所述。

本教程中的课程

  1. 概述
  2. 创建 EJB 模块
  3. 创建 Web 服务
  4. 测试 Web 服务
  5. => 修改架构文件和 WSDL 文件以传递二进制数据
  6. 创建 Swing 客户端

修改架构文件和 WSDL 文件以传递二进制数据

在以下步骤中,将为您在以前的教程中创建的 Web 服务创建修改过的 WSDL 和 XML 架构文件。修改的 WSDL 和架构文件使 Web 服务以及使用它的客户端能够解析以二进制数据传递的 JPEG 图像数据。

修改 WSDL 文件和架构文件:

  1. 在“项目”窗口中,展开 "FlowerService" Web 应用程序节点,直至到达 "WEB-INF" 节点。
    包含 "WEB-INF" 目录的 Flower Service 项目节点
  2. 右键单击 "WEB-INF" 节点,然后选择“新建”>“文件夹”。将该文件夹命名为 wsdl
  3. 展开“Web 服务”节点,然后右键单击 "FlowerService" 节点。选择“生成和复制 WSDL...”。
    FlowerService 节点的上下文菜单,其中选定了“生成和复制 WSDL”
  4. 将打开“生成和复制 WSDL”对话框,其中包含一个导航树。导航至 "Flower Service" > "web" > "WEB-INF" > "wsdl",然后单击“确定”。
    包含导航树的“生成和复制 WSDL”对话框,其中显示已选定 Flower Service/web/WEB-INF/wsdl

    现在,您将在 wsdl 节点中看到 FlowerService.wsdlFlowerService_schema1.xsd

    显示已复制的 WSDL 文件和架构文件的“项目”窗口
  5. 明确指定应用服务器使用您自己的 WSDL 文件版本。否则,应用服务器将生成其自身的 WSDL 文件。打开 FlowerService.java 并找到 @WebService 标注。在此标注中添加参数 wsdlLocation="WEB-INF/wsdl/FlowerService.wsdl",如下所示:
    @WebService(serviceName = "FlowerService",
    wsdlLocation = "WEB-INF/wsdl/FlowerService.wsdl")
  6. 修改架构文件,以使其指定返回元素的所需内容类型。要在架构文件中标识返回元素,请打开该架构文件,然后找到复杂类型 getThumbnailResponsegetFlowerResponse
    <xs:complexType name="getThumbnailsResponse">
    <xs:sequence>
    <xs:element name="return" type="xs:base64Binary" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
    </xs:complexType>
    <xs:complexType name="getFlowerResponse">
    <xs:sequence>
    <xs:element name="return" type="xs:base64Binary" minOccurs="0"/>
    </xs:sequence>
    </xs:complexType>
  7. 在两个返回元素 (<xs:element name="return".../>) 中添加以下属性。
    xmime:expectedContentTypes="image/jpeg" xmlns:xmime="http://www.w3.org/2005/05/xmlmime"

    现在,您应该在相同的行中看到以下内容:

    <xs:complexType name="getThumbnailsResponse">
    <xs:sequence>
    <xs:element name="return" type="xs:base64Binary" minOccurs="0" maxOccurs="unbounded"
    xmime:expectedContentTypes="image/jpeg" xmlns:xmime="http://www.w3.org/2005/05/xmlmime"/>
    </xs:sequence>
    </xs:complexType>
    <xs:complexType name="getFlowerResponse">
    <xs:sequence>
    <xs:element name="return" type="xs:base64Binary" minOccurs="0"
    xmime:expectedContentTypes="image/jpeg" xmlns:xmime="http://www.w3.org/2005/05/xmlmime"/>
    </xs:sequence>
    </xs:complexType>
  8. 现在,向测试器应用程序重新部署 Web 服务并调用其中的一项操作时,您会看到图像被正确返回:
    使用 Web 服务的 Java 应用程序

由于测试器应用程序已经确保图像被正确返回,因此我们可以创建 Swing 客户端来检索和显示它们。

注意:您可以在下载的样例项目中找到已正确修改的 WSDL 文件和架构文件版本。这两个文件均位于 web/WEB-INF/wsdl 文件夹中。

后续步骤:

创建 Swing 客户端

要发送意见和建议、获得支持以及随时了解 NetBeans IDE Java EE 开发功能的最新开发情况,请加入 nbj2ee@netbeans.org 邮件列表

Companion
Projects:
                  Powered by: