【Java】理解 UDDI 注册中心的 WSDL

Web 服务描述语言（WSDL）有多种用法。特别是，根据应用程序的需要，WSDL 在 UDDI 注册中心有好几种使用方法。在这第 1 篇文章中（本系列共三篇），我们将介绍一下在 UDDI 注册中心使用 WSDL 的几种不同的方法。

Web 服务描述语言（WSDL）是用于描述 Web 服务的一种 XML 语言，它将 Web 服务描述为一组对消息进行操作的网络端点。一个 WSDL 服务描述包含对一组操作和消息的一个抽象定义，绑定到这些操作和消息的一个具体协议，和这个绑定的一个网络端点规范。

统一描述发现和集成（UDDI）提供一种发布和查找服务描述的方法。UDDI 数据实体提供对定义业务和服务信息的支持。WSDL 中定义的服务描述信息是 UDDI 注册中心信息的补充。UDDI 提供对许多不同类型的服务描述的支持。因此，UDDI 没有对 WSDL 的直接支持， 也没有对任何其它服务描述机制的直接支持。

UDDI 组织，即 UDDI.org，已经发布了一个优化方法文档，标题为 在 UDDI 注册中心 1.05 中使用 WSDL（请参阅 参考资料）。这个优化方法文档描述了关于如何在 UDDI 注册中心发布 WSDL 服务描述的一些元素。本文的目的就是增加这种信息。主要的焦点问题是如何将一个完整的 WSDL 服务描述映射到 UDDI 注册中心，现有的 WSDL 工具和运行时环境要求必须做到这一点。本文中的信息遵守那个优化方法文档中列出的大致过程， 且与 WSDL 1.1、UDDI 1.0 和 UDDI 2.0 规范一致（请参阅 参考资料）。

UDDI 和 WSDL 概述

在描述将 WSDL 服务描述映射到 UDDI 注册中心的过程之前，很重要的一点是要理解 UDDI 数据类型和主要的 WSDL 文档类型。

UDDI 数据类型

在 UDDI 注册中心有 4 种主要的数据类型： businessEntity、 businessService、 bindingTemplate和 tModel。 图 1展示了所有这些数据类型之间的关系。

图 1. UDDI 数据类型

businessEntity 提供关于商家的信息，可以包含一个或多个 businessService。 这个商家是服务提供者。Web 服务的技术和业务描述在 businessService 和其 bindingTemplate 中被定义。每个 bindingTemplate 包含一个对一个或多个 tModel 的引用。tModel 被用于定义服务的技术规范。

WSDL 文档类型

为帮助在 UDDI 注册中心发布和查找 WSDL 服务描述，WSDL 文档被分为两种类型： 服务接口（service interface ）和 服务实现（service implementations）（请参阅 图 2）。

图 2. WSDL 文档类型

服务接口由 WSDL 文档来描述，这种文档包含服务接口的 types、 import、 message、 portType和 binding等元素。服务接口包含将用于实现一个或多个服务的 WSDL 服务定义。它是 Web 服务的抽象定义，并被用于描述某种特定类型的服务。

通过使用一个 import 元素，一个服务接口文档可以引用另一个服务接口文档。 例如，一个仅包含 message 和 portType 元素的服务接口可以被另一个仅包含此 portType 的绑定的服务接口引用。

WSDL 服务实现文档将包含 import和 service元素。服务实现文档包含实现一个服务接口的服务的描述。import 元素中至少会有一个将包含对 WSDL 服务接口文档的引用。一个服务实现文档可以包含对多个服务接口文档的引用。

WSDL 服务实现文档中的 import 元素包含两个属性。 namespace的属性值是一个与服务接口文档中的 targetNamespace相匹配的 URL。location属性是一个用于引用包含完整的服务接口定义的 WSDL 文档的 URL。port 元素的 binding属性包含对服务接口文档中的某个特定绑定的引用。

服务接口文档由 服务接口提供者开发和发布。服务实现文档由 服务提供者创建和发布。服务接口提供者与服务提供者这两个角色在逻辑上是分离的，但他们可以是同一个商业实体。

回页首

发布和查找 WSDL 描述

这一部分描述发布和查找一个完整的 WSDL 服务描述的过程。一个完整的 WSDL 服务描述是由一个服务接口和一个服务实现文档组成的。

由于服务接口表示服务的可重用定义，它在 UDDI 注册中心被作为 tModel 发布。 服务实现描述服务的实例。每个实例都是使用一个 WSDL service 元素定义的。服务实现文档中的每个 service 元素都被用于发布 UDDI businessService。

当发布一个 WSDL 服务描述时，在服务实现被作为 businessService 发布之前，必须将一个服务接口作为一个 tModel 发布。

发布服务实现

服务实现在 UDDI 注册中心是作为带有一个或多个 bindingTemplate 的 businessService 发布的。 businessService 由服务提供者发布。

UDDI businessService
将为服务实现文档中定义的每个 service 元素创建一个新的 businessService。 下面的表中包含 businessService 元素列表，这些 businessService 元素可根据 WSDL 服务实现文档的内容创建。

UDDI bindingTemplate
新的 bindingTemplate 元素是在 businessService 中为 service 元素中定义的每个 port 元素而定义的。

服务实现到 businessService 的映射示例
清单 3包含 WSDL 服务实现文档的一个示例。突出显示的值是将 WSDL 信息映射到 UDDI businessService 和 bindingTemplate 时必需的值。值显示在图表关键字中。

清单 3：WSDL 服务实现示例

<?xml version="1.0"?>
<definitions name="StockQuoteService"
  targetNamespace="http://www.getquote.com/StockQuoteService"
  xmlns:interface="http://www.getquote.com/StockQuoteService-interface"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
  xmlns="http://schemas.xmlsoap.org/wsdl/">
   
  <documentation>
    This service provides an implementation of a standard stock quote service.
    The Web service uses the live stock quote service provided by XMLtoday.com.
    The XMLtoday.com stock quote service uses an HTTP GET interface to request
    a quote, and returns an XML string as a response.
    For additional information on how this service obtains stock quotes, go to
    the XMLtoday.com web site: http://www.xmltoday.com/examples/soap/stock.psp.
  </documentation>
  <import namespace="http://www.getquote.com/StockQuoteService-interface"
     location="http://www.getquote.com/wsdl/SQS-interface.wsdl"/>
  <service name="StockQuoteService">
    <documentation>Stock Quote Service</documentation>
    
    <port name="SingleSymbolServicePort"
        binding="interface:SingleSymbolBinding">
      <documentation>Single Symbol Stock Quote Service</documentation>
      <soap:address location="http://www.getquote.com/stockquoteservice"/>
    </port>
  </service>
</definitions>

关键字：

Service― service 元素的 name 属性被用作 businessService 的名称。service 元素中的 documentation 元素被用于描述 businessService。 
Import― 端口名被附加到 overviewURL，此 overviewURL 包含对服务实现文档的引用。服务的位置被用于设置 bindingTemplate 中的 accessPoint。

查找 WSDL 服务接口描述

所有的 WSDL 服务接口在 UDDI 注册中心都是作为 tModel 发布。对这些 tModel 中的每一个都要进行归类，以便将它们标识为 WSDL 服务描述。UDDI find_tModel 消息可用于查找已经分过类的 tModel。使用 UDDI V1.0 API 时， 清单 5中列出的 find_tModel 消息可用于定位所有的 WSDL 服务接口描述。

清单 5：查找 WSDL 服务接口描述

<?xml version="1.0"?>
<find_tModel generic="1.0" xmlns="urn:uddi-org:api">
  <categoryBag>
    <keyedReference tModelKey="UUID:C1ACF26D-9672-4404-9D70-39B756E62AB4"
                    keyName="uddi-org:types" keyValue="wsdlSpec"/>
  </categoryBag>
</find_tModel>

find_tModel 消息将返回一列 tModel 关键字。使用 get_tModelDetail 消息可检索特定的服务接口描述。get_tModelDetail 消息将返回一个 tModel， 比如 清单 2中列出的那个。

在检索了一个 tModel 后，可使用 overviewURL 检索 WSDL 服务接口文档的内容。

可将另外的 keyedReference 添加到 categoryBag 以限制这个查找请求的响应中返回的 tModel 集。 清单 6中的 find_tModel 消息可用于定位使用 WSDL 定义的所有股票报价服务。

清单 6：查找期望的商业用途的 WSDL 服务接口

<?xml version="1.0"?>
<find_tModel generic="1.0" xmlns="urn:uddi-org:api">
  <categoryBag>
    <keyedReference tModelKey="UUID:C1ACF26D-9672-4404-9D70-39B756E62AB4"
                    keyName="uddi-org:types" keyValue="wsdlSpec"/>
    <keyedReference tModelKey="UUID:DB77450D-9FA8-45D4-A7BC-04411D14E384" 
                    keyName="Stock market trading services" 
                    keyValue="84121801"/>
  </categoryBag>
</find_tModel>

回页首

查找 WSDL 服务实现描述

WSDL 服务实现在 UDDI 注册中心是作为 businessService 发布的。businessService 将包含一个或多个 bindingTemplate。对 businessService 进行归类，以便将它看作基于 WSDL 的服务描述。使用 UDDI V1.0 API 时，必须找到一个 businessEntity 或一个 businessEntity 集才能使用 businessService 的查找 API。同样地，也必须找到一个 businessService 或一个 businessService 集才能使用查找 API 定位 bindingTemplate。

查找 UDDI businessService
有两种基本方法可用于查找服务描述。使用特定的分类法，UDDI find_service 消息可用于查找服务描述，或者说它可用于查找实现某个特定的服务接口的服务描述。

使用 UDDI V1.0 API 时，可为某个特定的 businessEntity 发出 清单 7中的消息，以便定位股票报价服务实现这个 businessService。可将另外的 keyedReference 添加到 categoryBag 以缩小对此消息的响应中返回的服务描述的范围。

清单 7：查找 WSDL 服务实现描述

<?xml version="1.0"?>
<find_service businessKey="..." generic="1.0" xmlns="urn:uddi-org:api">
  <categoryBag>
   <keyedReference tModelKey="UUID:DB77450D-9FA8-45D4-A7BC-04411D14E384" 
                    keyName="Stock market trading services" 
                    keyValue="84121801"/>
  </categoryBag>
</find_service>

find_service 消息也可用于定位 businessService ― 该 businessService 是某个特定服务接口的实现。 清单 8中的消息包含 find_service 消息的一个示例，它将查找 businessEntity 中的所有 businessService，这个 businessEntity 实现了股票报价服务的服务接口。由于服务接口是用 tModel 来表示，tModelBag 就被用于指定 WSDL 服务接口与股票报价服务相关联的 tModel 关键字。

清单 8：使用 tModelBag 查找 WSDL 服务实现描述

<?xml version="1.0"?>
<find_service businessKey="..." generic="1.0" xmlns="urn:uddi-org:api">
  <tModelBag>
    <tModelKey>[tModel key for WSDL service interface]</tModelKey> 
  </tModelBag>
</find_service>

find_service 消息将返回一列服务关键字。可使用 get_serviceDetail 消息检索 businessService 描述。get_serviceDetail 消息将返回一个 businessService，比如 清单 4中的那个。

检索了一个 businessService 后，可选择某个特定的 bindingTemplate 调用 Web 服务。bindingTemplate 中的 accessPoint 是服务的端点。overviewURL 可用于检索 WSDL 服务实现文档的内容，该文档可能包含关于已实现服务的额外详细信息。

查找 UDDI bindingTemplate
如果 businessService 包含多个 bindingTemplate，可能会很难确定要使用哪个 bindingTemplate。 find_binding 消息可用于定位应该使用的 bindingTemplate。

总结

本文已经描述了在 UDDI 注册中心发布和查找完整的 WSDL 服务描述的过程。WSDL 服务接口描述是作为 UDDI tModel 发布的，而 WSDL 服务实现描述是作为 UDDI businessService 发布的。 图 4提供了从 WSDL 服务接口和服务实现文档到 UDDI 注册中心条目的映射概览。

在本系列的下一篇文章中，我们将讨论在开发者经常遇到的 5 种不同情形下在 UDDI 注册中心使用 WSDL 所需的精确代码。

图 4：从 WSDL 到 UDDI 的映射概览

在本系列的下一篇文章中，我们将对不同的 WSDL 用法个案研究应用本文中描述的过程。 每个用法个案研究都将举例说明应该如何在 UDDI 注册中心发布不同类型的 WSDL 服务描述。