您已从头至尾地完成了 WSDL，从原始的 SOAP 结构到 WSDL 绑定。还成功地使用 Axis2 的 WSDLJava 工具将其编译成了 Java 代码，并在 Geronimo 上进行了测试与部署。

请继续阅读第 2 部分，开发 Axis2 生成的 Java 代码，创建一个功能齐全的在线银行 Web 服务。稍后在第 3 部分中，我们将创建一个基于 Web 的客户机，与 Axis2 Web 服务进行通信，请继续关注本系列教程。

下载 描述 名字 大小 下载方法 Part 1 source code os-ag-onbank1.zip 9KB HTTP 关于下载方法的信息 Get Adobe® Reader®

参考资料

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文。
  
  
• 阅读关于 developing Web services using Axis2 的文章（developerWorks，2005 年 11 月）。
  
  
• 访问 Apache Ant 手册 和 Apache Axis2 0.94 文档。
  
  
• 获得 Apache Axis 文档。
  
  
• 访问 Apache Geronimo 主页。
  
  
• 加入 Apache Geronimo 邮件列表，获得 Apache Geronimo 的信息。
  
  
• 加入 Axis2 邮件列表。
  
  
• 查看 developer.com 推荐的 新 Axis2 部署架构 相关内容。
  
  
• 访问 Axis2 Wiki。
  
  
• 查看 developerWorks 的 SOA 和 Web 服务专区，其中提供了关于 Web 服务和 Web 服务标准的文章与教程。
  
  
• 阅读教程 “Understand Web Services Distributed Management (WSDM)” （developerWorks，2005 年 7 月），了解 WSDM 的理论及安装。
  
  
• 访问 developerWorks 开放源码专区，获得广泛的 how-to 信息、工具和项目更新，帮助您使用开放源码技术进行开发并将其与 IBM 产品共同使用。
  
  
• 查看 developerWorks 的 Apache Geronimo 项目专区，获得文章、教程和其他资源，帮助您立即开始使用 Geronimo 进行开发。
  
  
• 查看 IBM 对 Apache Geronimo 的支持 产品，这使您能在 IBM 的世界级支持下开发 Geronimo 应用程序。
  
  
• 访问 developerWorks 中的 立即开始使用 Apache Geronimo 部分，获得面向新手和经验丰富的用户的有用资源。
  
  
• 访问 developerWorks 的开放源码专区，浏览所有 Apache 文章 与 免费 Apache 教程。
  
  
• 访问 Safari 书店，浏览关于上述主题及其他技术的图书。

• 下载 Apache Axis2，它提供了一个用于构建基于 Web 服务的应用程序的 SOAP 平台。
  
  
• 使用 IBM 试用软件 革新您的下一个开放源码开发项目，这些软件可通过下载获得，也可在 DVD 上获得。
  
  
• 下载 Apache Geronimo 1.0。
  
  
• 下载免费的 IBM WebSphere® Application Server Community Edition V1.0 —— 轻量级 J2EE 应用服务器，构建于专为帮助您加速开发和部署工作而设计的 Apache Geronimo 开放源码技术之上。
  
  

• 参与论坛讨论 。
  
  
• 访问 Apache Geronimo blog，了解 Geronimo 开发的最新信息。
  
  

回页首

关于作者

		Nicholas Chase 参与过多家公司的网站开发，包括 Lucent Technologies、Sun Microsystems、Oracle 和 Tampa Bay Buccaneers。Nick 曾是一名高中物理教师、放射性废弃品设施低级管理员、在线科幻杂志编辑、多媒体工程师、Oracle 讲师、一家交互式通信公司的首席技术官。他撰写了许多图书，其中包括 XML Primer Plus。

Nicholas Chase (ibmquestions@nicholaschase.com), 自由作者, Backstop Media, LLC

2006 年 5 月 25 日

使用 Apache Geronimo 和 Axis2 构建复杂 Web 服务应用程序是一项错综复杂的任务，本系列将深入研究相关内容。本系列教程由 3 个部分构成，引领您构建一个示例在线银行 Web 服务，文中介绍了整个流程的每个步骤，因此新用户可快速掌握概念并构建一个完整的 Web 服务和可与 Web 服务连接并通信的 Web 界面客户机。在第一期中，将为您介绍示例 Web 服务和使用 WSDL 的 Web 服务，构建并编译 WSDL 文件，然后在 Geronimo 上测试及部署它。

开始之前

本系列教程分 3 部分，面向对使用 Apache Geronimo 和 Apache Axis2 开发大型 Web 服务有兴趣的读者。了解如何构建 WSDL 文件及与在线银行系统相关的一些操作。然后使用 Axis2 将 WSDL 文件编译为 Web 服务，并在 Geronimo 上进行部署和测试。

关于本系列

本系列中将创建一个在线银行 Web 服务示例。使用 WSDL 和 Axis2 创建的 Web 服务将包含一个 Apache Derby 数据库，用于保存交易数据、账户数据和账单支付数据。您会将 Axis2 作为 Apache Geronimo 上的 Web 应用程序部署，新 Web 服务将是在 Axis2 中部署的 Axis 归档。您在示例中可能会用到在线银行中的多个命令，包括查看账户、搜索交易、划拨资金和支付账单。您还会创建一个客户机 Web 应用程序来连接到 Web 服务，以查询信息及执行交易 —— 主要是为了调用在 Web 服务中实现的操作。

在本系列的第 1 部分中，将在 WSDL 中构建在线银行 Web 服务的基础设施。在第 2 部分中，将通过在 Apache Derby 数据库中存储账户和交易信息来构建 Web 服务的功能。在最后的第 3 部分中，将为 Web 服务创建功能完整、基于 Web 的客户机用户界面（UI），用户可在其中登录、进行在线银行活动及注销。

回页首

关于本教程

本教程首先介绍示例 Web 服务，并展示使用 WSDL 的多种 Web 服务。您将使用 Axis2 将 WSDL 文件转换为 Java™ 代码，其中将实现一些简单的功能，以测试客户机与 Web 服务之间的通信。测试环境包括作为 Geronimo 上的模块部署的 Axis2、作为 Axis2 内的归档部署的 Web 服务，以及与 Web 服务通信的一个简单 Java 客户机。

回页首

前提条件

要学习本教程，需要具备以下工具：

• Apache Geronimo —— 下载 Apache Geronimo V1.0，您将在 Geronimo 上部署 Axis2 Web 服务。
• Apache Axis2 —— 下载 V0.94 Axis2 WAR 及二进制发行版，用于从 WSDL 构建 Web 服务。
• Apache Ant —— 下载 Apache Ant，由于 Axis2 的 WSDL2Java 工具为构建 Web 服务创建了一个便捷的 Ant build.xml 文件，因此您需要用到此工具，这将使 Web 服务源代码的构建更容易。
• Java 代码 —— 下载最新版的 Java 1.4，Java 1.4.10，Geronimo、Axis2 和 Ant 都需要用到它。

本教程假设您具备 Java 语法和编写代码的基本知识，但不必了解 Axis2 或特定 Geronimo 的相关知识。

回页首

在线银行 Web 服务概述

下面简要介绍本系列教程的最终成果 —— 在线银行 Web 服务示例。该 Web 服务涵盖了在线银行体验的几种特性，包括查看账户和交易、划拨资金、申请贷款和在线支付账单。

账户

登录到 Web 服务之后，您会看到您所拥有的账户及其余额。出于安全性方面的考虑，登录过程包括发送用户名和密码，以及接收保证安全性的二进制令牌。因此，在您登录之后，仅需发送该令牌即可使 Web 服务识别您的身份。之后您就可以单击查看账户中的交易，见下节。

交易

您在银行中做的每一件事都涉及交易，各交易的历史 —— 可在各账户中查看其历史 —— 记录在您的账户中。Web 服务还使您根据支票编号、金额或日期搜索交易。这使您可在纳税时更轻松地回溯和查找账户中的交易。您可将资金从一个账户划拨到另外一个账户中，这也作为账户的一项交易记入日志。

申请贷款

本特性允许您通过在线银行 Web 服务申请贷款。您可输入贷款类型、欲贷金额、偿还时间。成功提交贷款申请表后，您可查看每笔贷款的状态。

支付账单

在线账单支付服务现已非常普及。这种服务使您能够通过银行账户支付账单。但在支付账单之前，必须首先添加作为支付对象的人或公司，我们称之为收款方（payee）。Web 服务允许您查看、添加和编辑账户中的收款方。在账户中设置好收款方后，您就可以向其偿还债务或划拨资金了。所支持的支付类型有两种：一次性支付 和 定期支付。您可通过 Web 服务执行各类支付。每次支付都有一个与其相关的日期，在支付发生之前（待定支付），允许您编辑其内容。

在下一节中，我们将开始构建在线银行 Web 服务的 WSDL。

回页首

数据结构

您在 Web 服务中支持的消息及操作需要一些数据结构用于来回传递数据，在 WSDL 中也称为复型。这些数据结构是通过简单对象访问协议（SOAP）传送的，并且是使用 WSDL 定义的。Web 服务的操作需要 6 个数据结构，我们将从最常用的一种开始，即交易。

交易

在您的在线银行 Web 服务上下文中，两个账户（或一个账户和银行）是所涉两方。就我们的在线银行应用程序而言，一个交易可能有 5 项属性。下面看看这些属性，参见 清单 1。现在创建一个 WSDL 文件 —— OnlineBanking.wsdl，将 Transaction complexType 放置在其中。

Transaction complexType 中的 5 个元素在 清单 1 中显示为黑体。所有必需元素均以 minOccurs="1" maxOccurs="1" 表示。这表示该元素号应至少出现一次，且最多出现一次，也就是恰好一次。注意 checknumber 非必需，因为 minOccurs="0"，这表示在一个 Transaction 中，该元素可被忽略，也可以恰好出现一次。另外，查看数据类型。注意，号码定义为 int、checknumber 和 int、date 和 date、header 和 string，以及 amount 和 float。

      <xsd:complexType name="Transaction">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="number" type="xsd: int" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="checknumber" type="xsd: int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="date" type="xsd: date" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="header" type="xsd: string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="amount" type="xsd: float" />
        </xsd:sequence>
      </xsd:complexType>

接下来将介绍收款方复型。

回页首

收款方

收款方接受您通过在线银行支付的账单。因此，需要几个字段来获得地址和账单金额信息。为您的 WSDL 文件添加收款方复型，参见 清单 2。

      <xsd:complexType name="Payee">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="name" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="address1" type="xsd:string" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="address2" type="xsd:string" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="address3" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="city" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="state" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="zip" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="phoneAreaCode" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="phonePrefix" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="phoneSuffix" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="accountToPay" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="nameOnBill" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="alias" type="xsd:string" />
        </xsd:sequence>
      </xsd:complexType>

对于邮汇，您可以想到，需要的所有必需数据，在 清单 2 中以黑体显示。注意 address2 和 address3，补充的额外地址行非必需。接下来定义贷款申请表复型。

回页首

贷款申请表

如果银行不发放贷款，我们要如何生存？这里定义的数据结构包括贷款申请表信息和贷款状态信息。我们首先定义贷款申请表复型，参见 清单 3。

      <xsd:complexType name="LoanApplication">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="loanType" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="amount" type="xsd:float" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="termMonths" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="joint" type="xsd:boolean" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="percentFinanced" type="xsd:int" />
        </xsd:sequence>
      </xsd:complexType>

各字段都包括贷款申请表中的典型数据。接下来将贷款状态添加到您的 WSDL 中，如 清单 4 所示。

      <xsd:complexType name="LoanApplicationStatus">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="loanNumber" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="approved" type="xsd:boolean" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="denied" type="xsd:boolean" />
        </xsd:sequence>
      </xsd:complexType>

每笔贷款都获得一个号码以及一个与其相关的批准或拒绝状态。如果它既未得到批准，也未被拒绝，则该贷款尚未处理。接下来介绍与账单支付相关的结构。

回页首

账单支付

支付账单要求您输入信息，如支付金额、支付对象，以及是否为定期支付等。接下来的两个清单展示了两种结构，供您参考。向您的 WSDL 文件中添加账单支付复型，参见 清单 5。

      <xsd:complexType name="BillPayment">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="payeeName" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="account" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="amount" type="xsd:float" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="date" type="xsd:date" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="notes" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="recurring" type="xsd:boolean" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="recurringData"
                       type="xsd1:RecurringBillPayment" />
        </xsd:sequence>
      </xsd:complexType>

这里显示的金额即为您所支付的金额。如果是定期支付，则此金额为您每次支付的金额，所以日期将为起始日期。另外，注意这里 recurring 指定支付是否为定期支付，如果是，则定义 recurringData（注意其 minOccurs 定义为 0）。recurringData 元素引用 RecurringBillPayment 复型，如 清单 6 所示。将其添加到您的 WSDL 中。

      <xsd:complexType name="RecurringBillPayment">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="finalPayment" type="xsd:float" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="frequency" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="totalNumberOfPayments" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="recurringType" type="xsd:string" />
        </xsd:sequence>
      </xsd:complexType>

清单 6 中的数据直接填充 清单 5 所示复型。在这里，您的最后支付为 finalPayment 字段的值，frequency 则为支付账单的周期。recurringType 字段表示账单金额是否为固定数量，也就是说表示您是否可在下一次提交之前更改金额。接下来为您介绍需要通过 WSDL 公开的几种不同操作。

回页首

分布式环境要求使用集成存储库，以便用户和开发人员了解哪些功能可用以及能在何处找到这些功能，Web 服务也不例外。本教程说明了统一描述、发现和集成 (UDDI) 的使用，UDDI 提供了保存有关可用企业和服务的信息的注册中心。

在本教程中，您了解了以下内容：

• 什么是 UDDI 以及它为何重要
• 如何设计 UDDI 数据的结构
• 如何区分 SOAP 接口和实现
• 如何在 UDDI 注册中心中查找数据
• 如何使用 Java 与 UDDI 注册中心交互

本系列的后续部分将介绍如何应对不断增加的安全需求，并对 WS-Security 和 WS-Policy 进行探讨。

回页首

下载 描述 名字 大小 下载方法 Source code uddicode.zip 6KB HTTP 关于下载方法的信息 Get Adobe® Reader®

参考资料

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文 。
  
  
• 阅读本系列的其他教程。
  
  
• 请访问 UDDI 网站。
  
  
• 您可以找到所有三个版本的规范，包括 XML 模式文档。
  
  
• 请参见 Tom Bellwood 所撰写的 使用 UDDI V3 加速前进，以了解 UDDI 3.0 版中的更改。
  
  
• 有关将 WSDL 与 UDDI 注册中心一起使用的各种不同方法的系列教程（由三部分组成），请参见 developerWorks 系列教程“Understanding WSDL in a UDDI registry”。
  • WSDL : 描述你的Web服务（2001 年 8 月）
  • Part 2: Usage scenarios in publishing and finding WSDL service descriptions（2001 年 9 月）
  • Part 3: How to publish and find WSDL service descriptions（2001 年 11 月）
  
  
• 阅读 developerWorks 系列文章“The role of private UDDI nodes in Web services”。
  • Part 1: Six species of UDDI （2001 年 5 月）
  • Part 2: Private nodes and operator nodes（2001 年 5 月）
  
  
• 阅读由五个部分组成的系列文章“使用 UDDI 和 WSDL 的一种新方法”。
  • 第 1 部分：介绍新的OASIS UDDI WSDL TechnicalNote（2003 年 8 月）
  • 第 2 部分：新的OASIS UDDI WSDL TechnicalNote支持的查询（2003 年 9 月）
  • 第 3 部分：正在发挥作用的新 OASIS UDDI WSDL Technical Note 的一个示例（2003 年 10 月）
  • 第 4 部分：使用新的 OASIS UDDI WSDL Technical Note 来从 Java 应用程序发布 WSDL（2004 年 3 月）
  • Part 5: Query from a Java application using the new OASIS UDDI WSDL Technical Note（2004 年 11 月）
  
  
• 阅读有关 UDDI4J 的更多信息：UDDI4J: 安排 Web 服务 -- 与 UDDI 服务器交互。
  
  
• 请参见：UDDI4J v2 编程（developerWorks，2002 年 7 月），这篇文章讨论了下一代 UDDI 客户机 API——UDDI4J v2。
  
  

• 下载 Apache Geronimo。
  
  
• 要创建自己的 UDDI 注册中心，请下载 Apache jUDDI。
  
  
• 下载 UDDI4J。
  
  
• 下载 Apache Axis 1.3。
  
  
• 下载 Java 1.4.2。Geronimo 将无法与 Java 1.5 一起正常使用。
  
  
• UDDI4Py 是一个 Python 包，允许将请求发送到 UDDI V2 API 并允许处理来自后者的响应。

• 参与论坛讨论 。

回页首

关于作者

		Nicholas Chase 曾经参与过许多公司网站的开发，包括 Lucent Technologies、Sun Microsystems、Oracle 及 Tampa Bay Buccaneers。他当过中学物理教师、低级放射性废弃设备管理员、在线科幻杂志编辑、多媒体工程师、Oracle 讲师以及一家交互式通信公司的首席技术官。他写过几本书，其中包括XML Primer Plus (Sams)。

为了开始将公司添加到 UDDI 注册中心，Francis 定义了要输入注册中心的信息。

businessEntity

第一步是将报社本身的信息输入注册中心。为此，Francis 创建了一个 businessEntity 对象。此对象包含有关企业的信息，既用于对企业进行标识，也用于提供与其有关的信息。例如，businessEntity 对象可以包含多个名称（从而能够为公司所使用的每种语言创建一个 name 元素），联系信息（Francis 被告知将 Pat Mooney 添加为主要联系人）、与实体相关的服务（Gene 将稍后添加）和用于对公司进行标识与分类的信息。

尽管大部分人都不会采用这种方式与 UDDI 注册中心交互，但要注意的一个事实是，UDDI 实际上就是 SOAP 应用程序；执行的所有操作都作为往返传递 SOAP 消息的结果发生。这意味着，Francis 所创建的 businessEntity 最终将表示为 XML 元素。请参见清单 2。

												
														<businessEntity businessKey="{uuid}"
												 operator="(optional)" 
authorizedName="(optional)">
<discoveryURLs>
<discoveryURL></discoveryURL>
<discoveryURL></discoveryURL>
</discoveryURLs>
<name>The Daily Moon</name>
<name lang="fr-ca">La Lune Quotidienne</name>
<description></description>
<contacts>
<contact>
<description></description>
<personName>Pat Mooney</personName>
<phone></phone>
<email>patm@daily-moon.com</email>
<address useType="optional, billing, etc." 
sortCode="optional" 
tModelKey="optional">
<addressLine></addressLine>
<addressLine></addressLine>
<addressLine></addressLine>
</address>
</contact>
<contact>
         ...
</contact>
</contacts>
<businessServices>
<businessService serviceKey="required" 
businessKey="optional">
         ...
</businessService>
</businessServices>
<identifierBag>
      ...
</identifierBag>
<categoryBag>
      ...
</categoryBag>
</businessEntity>

businessEntity 记录并不一定要很复杂。事实上，按照 businessKey 的要求，单个名称和一个唯一标识符就足够了。不过，出于完整性考虑，我包含了完整的结构，但去掉了一些稍后将另行讨论的部分。在生产环境中，应将空白元素删除。

让我们看一看此处的一些信息。

从代码的起始处开始，businessKey 当然是唯一标识符。operator 和 authorizedName 属性由注册中心内部进行处理；您不必考虑这部分内容，它们仅仅分别表示运行注册中心的实体和添加此记录的人员或帐户。

discoveryURLs 会在每次将 businessEntity 保存到注册中心时添加到注册中心。这些 URL 旨在用作供用户访问有关 businessEntity 的更多信息的地址。

请注意，Francis 添加了一个额外的名称，用于以法语表示其名称（报社打算在法国宣传其业务）。这些实体中的每一个都具有 lang 属性，用于指定相关语言的代码。您可以提供常见缩写的可替换名称，如 IBM 对应于 International Business Machines。

接下来的可选描述是一个简单的文本字符串。事实上，UDDI 中的大部分元素都具有一个可选描述。

接下来，Francis 添加了其他一些联系人。对于每个联系人，他可以根据需要指定任意多的信息。通常会提供 personName，但电话号码、电子邮件等其他信息是由个人自行提供的，因为 UDDI 注册中心的所有信息对所有用户均可用。联系人还可能具有地址信息，使用 useType 来指定地址类型。例如，对于联系人，它可以为家庭地址和公司地址等。对于公司，useType 可以为总部、发行中心等等。

businessServices 元素将列出已与 businessEntity 关联的任何服务。由于 Gene 尚未添加任何服务，故而此元素通常为空。最后两项 identifierBag 和 categoryBag 提供了有关公司本身的其他信息，以便进行搜索。我们稍后将对二者分别进行分析。

回页首

publisherAssertion

publisherAssertion 是 businessEntity 之间的关系声明。例如，Francis 知道此项目的目标之一是使用 Daily Star 中提供的服务，其中，Daily Star 将为 Daily Moon 提供体育赛事比分。这使得 Daily Star 成为 Daily Moon 的内容提供者。Francis 可以按照清单 3 中所示的方式表示此关系。

                    
<publisherAssertion>
<fromKey>(businessKey for Daily Star)</fromKey>
<toKey>(businessKey for Daily Moon)</toKey>
<keyedReference tModelKey="904BD800-D53A-11DA-B055-850A1DA99D79" 
         keyName="optional" keyValue="CONTENTPROVIDER" />
</publisherAssertion>

fromKey 和 toKey 元素表示所涉及的两个实体的唯一 ID。在本例中，这两个实体指 Daily Moon 和 Daily Star。Daily Star 是 Daily Moon 的内容提供者，故而据此放置二者的键。keyedReference 将会多次出现。在本例中，我们可以说引用本身就是内容提供者。keyValue 是 keyedReference 的唯一必需属性，但常常也会包含 keyName（为了提高可读性）和 tModelKey（标识特定的引用类型）。在本例中，tModelKey 表示两个报社之间关联的命名空间（与内部关系相对）。我们稍后将对 tModels 进行进一步的讨论。

回页首

businessService

接下来，Francis 需要输入有关 Daily Moon 将要提供的任何实际服务的信息。除了所需的唯一 serviceKey 和名称外，businessService 对象中还包含两条重要信息。即 bindingTemplates 和服务所属的任何类别。请参见清单 4。

												
														<businessService serviceKey="required"
												 businessKey="optional">
<name></name>
<description></description>
<bindingTemplates>
<bindingTemplate serviceKey="optional" bindingKey="required">
         ...
</bindingTemplate>
</bindingTemplates>
<categoryBag>
      ...
</categoryBag>
</businessService>

回页首

BindingTemplate

Tmodelinstancedetails 指示其兼容的应用程序或规范。请参见清单 5。

												
														<bindingTemplate
												 serviceKey="optional"
 bindingKey="required">
                    <accessPoint> OR <hostingRedirector bindingKey="another
 binding to be used instead">
<tModelInstanceDetails>
<tModelInstanceDetail>
<tModelInstanceInfo tModelKey=""uuid key for specification tModel">>
<description></description>
<instanceDetails>
<description></description>
<overviewDoc>
<description></description>
<overviewURL></overviewURL>
</overviewDoc>
<instanceParams>string</intstanceParms>
</instanceDetails>
</tModelInstanceInfo>
<tModelInstanceInfo>
            ...
</tModelInstanceInfo>
  </tModelInstanceDetail>
   <tModelInstanceDetails>
</bindingTemplate>
TModels (including tModel of tModels)
Serve two purposes.  As specification indicators, and as namespace indicators.
<tModel tModelKey="required" operator="optional" 
authorizedName="optional">
<name></name>
<description></description>
<overviewDoc>
<description></description>
<overviewURL></overviewURL>
<overviewDoc>

   <identifierBag>
...
</identifierBag>
<categoryBag>
      ...
</categoryBag>
</tModel>

bindingTemplate 定义在何处能找到服务以及其执行什么工作，这听起来并不复杂。不过，这两项功能在 UDDI 上下文中担任了新的重要角色。例如，为了确定可以在何处访问服务，可以提供 accessPoint（表示简单的 URL）或任何其他相应的数据，如求助热线的号码或 hostingRedirector。

分类法 对信息进行分类时，如果能就如何进行分类达成一致则很有帮助。这些一致同意的分类标准称为分类法。 例如，北美工业分类系统 (NAICS) 通过为每种类别指定一个唯一代码来区分“体育用品出租”、“体育用品商店”和“二手体育用品商店”。这样，当遇到代码 532292 时，就知道所说的是出租体育用品的商家，而不是出售这些东西的商家。 UDDI 操作员向系统添加一系列分类法作为例行规定，可供您在无需为其注册 tModels 的情况下使用。例如，jUDDI 可以使用 tModel 键 A035A07C-F362-44DD-8F95-E2B134BF43B4 为 uddi-org:general_keywords 创建 tModel，因此您可以使用它，而不必自己定义。

当服务的绑定发生更改时，将使用 hostingRedirector。例如，如果 Daily Moon 要建立自己的分类广告服务，并允许这两家报社使用 createNewAdd() 调用提交广告，则需要确保服务永远不会更改，或者提供一个方法来告知客户机服务已发生更改。而这就是要使用 hostingRedirector 的地方。在这种情况下，Francis（或实际由 Gene 进行）将创建一个新 bindingTemplate，用于表示新信息，并将该 bindingTemplate 的 bindingKey 输入 hostingRedirector 元素的 bindingKey 属性中。

定义服务能进行的工作可能会更困难。这个原因是两方面的。首先，由于我们讨论的并不一定是 SOAP 服务，因此无法直接为其提供 WSDL 文件。其次，由于这应该是一个自动化过程，因此需要以无歧义的方式提供此信息。

这样所得的结果是一个包括 tModelInstanceDetails 元素的 bindingTemplate，而此元素中又包含一个或多个 tModelInstanceDetail 元素。每个 tModelInstanceDetail 元素又包含一个或多个 tModelInstanceInfo 元素，而后者各自指向一个特定的 tModel。我们稍后将对 tModels 进行讨论。不过，重要的是要理解，tModelInstanceInfo 元素可以包含一个 instanceDetails 元素，后者本身包含一个 overviewDoc，其中包括 overviewURL，即实际定义服务的文档的 URL。（是的，就是在此处指定 WSDL 文件。）

回页首

TModels（包括 tModels 的 tModel）

现在让我们讨论一下 tModels。

tModels 实际有两个用途。第一，就是我们在关于 publisherAssertions 的讨论中了解到的，作为“命名空间指示符”。也就是说，tModel 可以提供用于区分很容易混淆的信息类型的方法。经常给出的一个例子是税码（或其他很容易混淆的数字）。例如，包含以下内容的 keyedReference 并不会提供所有信息，因为这两个税务 ID 属于不同的国家。它们在两个国家里都称为税务 ID，但就编程而言，我们必须提供一个区分二者的方法，如清单 6 中所示。

                    
<keyedReference tModelKey="" keyName="taxid" 
keyValue="11111111" />
<keyedReference tModelKey="" keyName="taxid" 
keyValue="22222222" />

这就是要使用 tModel 的地方。我们可以为“美国税码”创建一个键模型，再为“墨西哥税码”创建一个键模型，依此类推。创建了这些模型后，可以使用其 tModel 键来进一步限定这些 keyedReference。请参见清单 7。

                    
<tModel tModelKey="902CDE50-D53A-11DA-B055-A74C17FA61A7">
   <name>United States codes</name>
</tModel>
<tModel tModelKey="062377D0-D5F5-11DA-8170-8ACF057FECAD">
   <name>Mexico codes</name>
</tModel>
<keyedReference tModelKey="902CDE50-D53A-11DA-B055-A74C17FA61A7" 
                keyName="taxid" keyValue="11111111" />
<keyedReference tModelKey="062377D0-D5F5-11DA-8170-8ACF057FECAD" 
                keyName="taxid" keyValue="22222222" />

tModel 的另一个用途是作为规范标识符。例如，Francis 知道 Gene 将为上个月所处理的 ClassifiedService 创建相应的条目。此服务表示特定的接口，因此可以使用 tModel 对其进行标识。tModel 可能与清单 8 中所示类似。

												
														<tModel tModelKey="66999A50-D5F4-11DA-9A50-FA44D6AD622A"
												 
        operator="optional" authorizedName="optional">

   <name>Classified Service Interface</name>
   <description></description>

   <overviewDoc>
      <description></description>
      <overviewURL>
        http://www.daily-moon.com/ClassifiedService-interface.wsdl
      </overviewURL>
   <overviewDoc>

   <identifierBag>
...
   </identifierBag>

   <categoryBag>
      ...
   </categoryBag>
</tModel>

和我们所讨论的各个其他对象一样，tModel 具有一个唯一键，这是它唯一必需的信息。不过，在本例中，我们还要指定 overviewURL，即接口的 WSDL 文件的 URL。（我们将在后面部分创建它。）

同样，可以使用 identifierBag 对 tModels 进行标识，还可以使用 categoryBag 对其进行归类。接下来让我们看一看如何进行此工作。

回页首

identifierBag

由于 UDDI 设计十分灵活，因此没有特定的方式来标识 businessEntity。UDDI 并不强制要求使用其 D-U-N-S 编号、其税务 ID 编号或任何特定的标识方法对公司进行标识。相反，它提供了一个容器，可以根据需要在其中放置任意数量的标识符，如清单9 中所示。

												
														<identifierBag>
												
												
														<keyedReference
												
 tModelKey="4064C064-6D14-4F35-8953-9652106476A9" 
         keyName="DUNS Number" keyValue="55555555" /><keyedReference tModelKey="" 
         keyName="US Tax ID" keyValue="111111111" />
</identifierBag>

在 identifierBag 中添加的每个 keyedReference 都代表用户在搜索中找到相关对象的另一个机会。

回页首

categoryBag

categoryBag 的工作方式与 identifierBag 类似，因为其中包含一个或多个 keyedReferences。请参见清单 10。

												
														<categoryBag>
   <keyedReference
												 tModelKey="C0B9FE13-179F-413D-8A5B-5004DB8E5BB2" 
           keyName="optional" keyValue="511110" />
</categoryBag>

在本例中，Francis 创建了一个 categoryBag，指示 Daily Moon 是一个报社分支机构。现在让我们了解如何使用所有这些对象。

回页首

将 WSDL 映射到 UDDI

在 Gene 编写任何代码将所有这些信息发送到 UDDI 注册中心前，他必须在其当前服务和 UDDI 之间建立一个重要的联系。他必须对其进行调整，以适应 UDDI 的服务、接口和绑定模板概念。

服务与接口

您可能还记得，服务在 UDDI 中包含三个部分：接口（使用 tModels 定义）、businessService 和 bindingTemplate（用于将两者捆绑在一起）。因此，Gene 将首先确定用于定义 SOAP 服务的 WSDL 文件如何适应此结构。

他首先对 WSDL 进行分析。幸运的是，这非常简单。除了实现本身外，其余所有 WSDL 内容都属于接口。请参见清单 11。

                    
<wsdl:definitions xmlns:xs="http://www.w3.org/2001/XMLSchema" 
      xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
      xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
      xmlns:tns="http://ws.apache.org/axis2"
      xmlns:axis2="http://ws.apache.org/axis2"
      xmlns:ns1="http://org.apache.axis2/xsd" 
      targetNamespace="http://ws.apache.org/axis2">

   <wsdl:types>
      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" 
            targetNamespace="http://org.apache.axis2/xsd" 
            elementFormDefault="unqualified" 
            attributeFormDefault="unqualified">

         <xs:element type="ns1:ClassifiedAd" name="ClassifiedAd"
 />
         <xs:complexType name="ClassifiedAd">
            <xs:sequence>
               <xs:element type="xs:int" name="id" />
               <xs:element type="xs:string" name="content" />
               <xs:element type="xs:string" name="endDate" />
               <xs:element type="xs:string" name="startDate" />
            </xs:sequence>
         </xs:complexType>
         ...
      </xs:schema>
   </wsdl:types>

   <wsdl:message name="createNewAdRequestMessage">
      <wsdl:part name="part1" element="ns1:createNewAdRequest" />
   </wsdl:message>
   <wsdl:message name="createNewAdResponseMessage">
      <wsdl:part name="part1" element="ns1:createNewAdResponse" />
   </wsdl:message>
   ...

   <wsdl:portType name="ClassifiedServicePortType">
      <wsdl:operation name="finalizeIssue">
         <wsdl:input message="tns:finalizeIssueRequestMessage" />
      </wsdl:operation>
      <wsdl:operation name="createNewAd">
         <wsdl:input message="tns:createNewAdRequestMessage" />
         <wsdl:output message="tns:createNewAdResponseMessage" />
      </wsdl:operation>
      ...
   </wsdl:portType>

   <wsdl:binding name="ClassifiedServiceBinding" 
                  type="tns:ClassifiedServicePortType">
      <soap:binding transport="http://schemas.xmlsoap.org/soap/http" 
                  style="document" />
      <wsdl:operation name="createNewAd">
         <soap:operation soapAction="createNewAd" style="document"
 />
         <wsdl:input>
            <soap:body use="literal" 
                        namespace="http://ws.apache.org/axis2" />
         </wsdl:input>
         <wsdl:output>
            <soap:body use="literal" 
                        namespace="http://ws.apache.org/axis2" />
         </wsdl:output>
      </wsdl:operation>
      ...
   </wsdl:binding>
</wsdl:definitions>

这包括类型定义（XML 模式）、任何消息、portType 甚至 binding，因为绑定并不是特定于实现的。

实现由实际的服务元素组成。请参见清单 12。

                    
<wsdl:definitions xmlns:xs="http://www.w3.org/2001/XMLSchema" 
      xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
      xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
      xmlns:tns=
        "http://www.daily-moon.com/ClassifiedService-interface"
      xmlns:axis2="http://ws.apache.org/axis2"
      xmlns:ns1="http://org.apache.axis2/xsd" 
      targetNamespace=
        "http://www.daily-moon.com/ClassifiedService-interface">

<wsdl:import namespace="http://ws.apache.org/axis2" 
   location=
"http://www.nicholaschase.com/ClassifiedService-interface.wsdl" 
/>

<wsdl:service name="ClassifiedService">
   <wsdl:port name="ClassifiedServicePort" 
               binding="axis2:ClassifiedServiceBinding">
      <soap:address 
         location=
 "http://www.daily-moon.com:8080/axis2/services/ClassifiedService" 
      />
   </wsdl:port>
</wsdl:service>

</wsdl:definitions>

请注意，实现文件导入了接口文件。也就是说，此文件是服务的完整定义。

现在让我们来看一看这如何与我们的 UDDI 对象对应。

回页首

将接口映射到 tModel

Gene 首先必须将接口映射到相应的 tModel。请参见清单 13。

                    
<tModel tModelKey="66999A50-D5F4-11DA-9A50-FA44D6AD622A">

  
 <name>http://www.daily-moon.com/ClassifiedService-
interface</name>
   <description>Interface for the Daily Moon Classified 
Department web application</description>

   <overviewDoc>
      <description>WSDL interface document</description>
      <overviewURL>
          http://www.daily-moon.com/ClassifiedService-interface.wsdl
      </overviewURL>
   <overviewDoc>

   <categoryBag>
      <keyedReference
 tModelKey="C1ACF26D-9672-4404-9D70-39B756E62AB4"
               keyName="uddi-org:types" keyValue="wsdlSpec" />
      <keyedReference
 tModelKey="C0B9FE13-179F-413D-8A5B-5004DB8E5BB2" 
               keyName="ntis-gov:naics:1997" keyValue="511110" />
   </categoryBag>
</tModel>

首先看最下面，请注意 categoryBag。Gene 添加了两个 keyReferences。第一个指定我们事实上在处理 WSDL 文件。已预定义了特定的 tModelKey 来表示 uddi-org:types 命名空间。所有 WSDL 文件都必须采用这种方式指定。第二个引用绑定到 ntis-gov:naics:1997 命名空间，因此 Gene 的用户可以方便地在表示与报纸有关的服务的所有 WSDL 文件中找到此定义。继续往上，我们可以看到 overviewDoc。除了可选描述外，它还指定了实际的 URL，可以在此处找到 WSDL 文件。

最后，tModel 的名称应与 WSDL 文件的目标命名空间匹配。

回页首

将实现映射到绑定模板

Gene 接下来必须将实现本身映射到 bindingTemplate。请参见清单 14。

                    
<bindingTemplate serviceKey="" bindingKey="">

   <accessPoint>
      http://www.daily-moon.com:8080/axis2/services/ClassifiedService
   </accessPoint>

   <tModelInstanceDetails>
      <tModelInstanceDetail>
         <tModelInstanceInfo 
                 tModelKey="66999A50-D5F4-11DA-9A50-FA44D6AD622A">
            <instanceDetails>
               <description>The canonical implementation of 
                  the Daily Moon's classified
 service.</description>
               <overviewDoc>
                  <overviewURL>
           http://www.daily-moon.com/ClassifiedService-impl.wsdl
                  </overviewURL>
               </overviewDoc>
            </instanceDetails>
         </tModelInstanceInfo>
      </tModelInstanceDetail>
   </tModelInstanceDetails>


</bindingTemplate> 

这里我们看到，Gene 创建了一个新 bindingTemplate，并将 accessPoint 设置为实际服务的 URL。键 modelInstanceDetails 将接口 tModel（通过 tModelKey）链接到实现文档（在 overviewDoc 中指定）。现在他只需要从服务引用它即可。

回页首

从 businessService 和 businessEntity 引用 bindingTemplate

最后一步是将所有这些组装起来，并从 businessService 引用 bindingTemplate、从 businessEntity 引用 businessService。请参见清单 15。

                    
<businessEntity businessKey="1A3DB880-D5F4-11DA-B880-F94D3591C691">
   <name>The Daily Moon</name>
   <name lang="fr-ca">La Lune Quotidienne</name>
   <contacts>
      <contact>
         <personName>Pat Mooney</personName>
         <email>patm@daily-moon.com</email>
      </contact>
   </contacts>

   <businessServices>
      <businessService 
            serviceKey="064B4170-D5F5-11DA-8170-A74C17FA61A7">
         <name>ClassifiedService</name>
         <bindingTemplates>
            <bindingTemplate 
                 bindingKey="904BD800-D53A-11DA-B055-850A1DA99D79">
               <accessPoint>
      http://www.daily-moon.com:8080/axis2/services/ClassifiedService
               </accessPoint>

               <tModelInstanceDetails>
                  <tModelInstanceDetail>
                     <tModelInstanceInfo 
                 tModelKey="66999A50-D5F4-11DA-9A50-FA44D6AD622A">
                        <instanceDetails>
                           <description>The canonical
 implementation of the Daily Moon's classified 
service.</description>
                           <overviewDoc>
                              <overviewURL>
           http://www.daily-moon.com/ClassifiedService-impl.wsdl
                              </overviewURL>
                           </overviewDoc>
                        </instanceDetails>
                     </tModelInstanceInfo>
                  </tModelInstanceDetail>
               </tModelInstanceDetails>

            </bindingTemplate>
         </bindingTemplates>

         <categoryBag>
            <keyedReference 
                 tModelKey="C1ACF26D-9672-4404-9D70-39B756E62AB4"
                 keyName="uddi-org:types" keyValue="wsdlSpec" />
            <keyedReference 
                 tModelKey="C0B9FE13-179F-413D-8A5B-5004DB8E5BB2" 
                 keyName="ntis-gov:naics:1997" keyValue="511110" />
         </categoryBag>
      </businessService>
   </businessServices>

   <identifierBag>
      <keyedReference
 tModelKey="4064C064-6D14-4F35-8953-9652106476A9" 
         keyName="DUNS Number" keyValue="55555555" />
      <keyedReference tModelKey="" 
         keyName="US Tax ID" keyValue="111111111" />
   </identifierBag>

   <categoryBag>
      <keyedReference
 tModelKey="C0B9FE13-179F-413D-8A5B-5004DB8E5BB2" 
           keyName="optional" keyValue="511110" />
   </categoryBag>
</businessEntity>

也就是说，服务现在已经完成：Gene 现在有了一个包含服务的 businessEntity。

回页首

Nicholas Chase (ibmquestions@nicholaschase.com), 顾问, Backstop Media

2006 年 11 月 05 日

面向服务的体系结构（Service-Oriented Architectures，SOA）当前强调的重点在 Web 服务上，但很容易被所传播的各种信息搞得昏头转向。本系列教程将对主要 Web 服务规范进行全面说明，从简单对象访问协议（Simple Object Access Protocol，SOAP）一直介绍到 WS Business Process Execution Language (WS-BPEL)。本教程是系列教程的第 3 部分，将说明统一描述、发现和集成 (UDDI) 的基本概念，并介绍如何使用 Java 应用程序访问它。

开始之前

本教程介绍统一描述、发现和集成 (UDDI)。UDDI 指定 Web 服务和其他公司信息的注册中心，旨在提供一种发现可使用的新 Web 服务并在理想的情况下实现操作自动化的方法。

本教程假定您熟悉 Web 服务和 SOAP 的一般概念。熟悉 WSDL 的相关知识也将有所帮助，但本教程中会对一般概念进行回顾。

为了理解本教程最后一部分给出的代码，您需要熟悉 Java，不过其中的概念与本教程的其他内容一样，适用于任何编程语言。

关于本系列

本系列教程以假想的报社 Daily Moon 为例，为了提高在竞争激烈的环境中的工作效率，其员工将使用各种 Web 服务来创建工作流系统，我们将在此过程中讲解各个 Web 服务基本概念。

第 1 部分说明了 Web 服务背后的基本概念，并演示了如何使用 SOAP（后续教程讨论的大部分内容的基础规范）来将 Classifieds Department 连接到内容管理系统。

第 2 部分进一步深入说明如何使用 Web 服务描述语言 (WSDL) 定义 Web 服务预期产生的消息，从而使团队更方便地创建服务以及连接到服务的客户机。

在第 3 部分中，团队希望准备一系列服务，并希望能方便地查找这些服务。与此对应，统一描述、发现和集成（Universal Description, Discovery and Integration，UDDI）提供了可用服务的可搜索注册中心，以便使自己的服务为其他人所注意。

第 4 部分和第 5 部分讨论 WS-Security 和 WS-Policy，将详细说明如何保证该报社的服务的安全，以及团队为了访问这些刚提供了安全保护的服务需要进行哪些更改。

第 6 部分重点讨论互操作性，因为必须从单个系统访问来自几个不同实现的服务。这一部分还将讨论 WS-I 证书中涉及的要求和测试。

最后，第 7 部分演示如何使用业务流程执行语言（Business Process Execution Language，WS-BPEL）来从各个服务创建复杂应用程序。

接下来让我们更为详细地了解一下本教程中将讨论的内容。

回页首

关于本教程

本系列的第 1 部分 介绍了 Web 服务，并强调了 SOAP 的重要性。这些内容是通过虚构的 Daily Moon 报社的 Classifieds Department 进行相关工作的过程说明的。在本系列的第 2 部分中，Classifieds Department 决定创建自己的服务，并使用 Web 服务描述语言 (WSDL) 记录其使用方式。在第 3 部分中，报社的发行人决定全面推行 Web 服务，并强制要求使用 UDDI 注册中心来记录所有可用服务。

在本教程中，您将了解以下内容：

• 什么是 UDDI
• UDDI 的用途
• UDDI 数据的结构
• 如何有效地使用 UDDI 表示 WSDL
• 可以对 UDDI 数据执行的操作
• 使用 Java 与 UDDI 注册表交互