查找 WSDL 服务接口描述

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

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

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

图 3包含从 WSDL 到 UDDI 的映射概览。我将在下面的部分中对这个映射加以描述。

发布服务接口

    在 UDDI 注册中心，服务接口被作为 tModel 发布。tModel 由服务接口提供者发布。tModel 中的一些元素是使用来自 WSDL 服务接口描述中的信息构建的。

UDDI tModel

表 1定义创建 tModel 步骤。一个有效的对 WSDL 服务接口定义的 tModel 引用应该是使用 targetNamespace 命名，并且必须包含 overviewURL 和 categoryBag 设置。

表 1: 创建 tModel 的步骤

服务接口到 tModel 的映射示例

清单 1包含一个示例 WSDL 服务接口文档。映射到 UDDI tModel 中的值显示在图表关键字中。

<?xml version="1.0"?>
<definitions name="StockQuoteService-interface"
  targetNamespace="http://www.getquote.com/StockQuoteService-interface"
  xmlns:tns="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>
    Standard WSDL service interface definition for a stock quote service.
  </documentation>
  <message name="SingleSymbolRequest">
    <part name="symbol" type="xsd:string"/>
  </message>
  <message name="SingleSymbolQuoteResponse">
    <part name="quote" type="xsd:string"/>
  </message>
 
  <portType name="SingleSymbolStockQuoteService">
    <operation name="getQuote">
      <input message="tns:SingleSymbolRequest"/>
      <output message="tns:SingleSymbolQuoteResponse"/>
    </operation>
  </portType>
  <binding name="SingleSymbolBinding"
           type="tns:SingleSymbolStockQuoteService">
    <soap:binding style="rpc"
                  transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="getQuote">
      <soap:operation soapAction="http://www.getquote.com/GetQuote"/>
      <input>
        <soap:body use="encoded"
            namespace="urn:single-symbol-stock-quotes"
            encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
      </input>
      <output>
        <soap:body use="encoded"
            namespace="urn:single-symbol-stock-quotes"
            encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
      </output>
    </operation>
  </binding>  
</definitions>

关键字：

Definitions― targetNamespace 将被用作 tModel 的名称。documentation 元素的内容将被用于描述 tModel。
Binding― 绑定名将被用于限定 overviewURL。

清单 2包含在发布 WSDL 服务接口定义时创建的 UDDI tModel。 值显示在图表关键字中。

<?xml version="1.0"?>
<tModel tModelKey="">
  <name>http://www.getquote.com/StockQuoteService-interface</name>
  <description xml:lang="en">
    Standard service interface definition for a stock quote service.
  </description>
  <overviewDoc>
    <description xml:lang="en">
      WSDL Service Interface Document
    </description>
    <overviewURL>
      http://www.getquote.com/services/
SQS-interface.wsdl#SingleSymbolBinding
    </overviewURL>
  </overviewDoc>
  <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>
</tModel>

关键字：

    tModel― tModel 的名称根据 targetNamespace 设置。描述是根据与 definitions 元素相关联的 documentation 元素设置的。overviewURL 被设置为 WSDL 服务接口文档可通过网络访问到的位置， 即 http://www.getquote.com/services/SQS-interface.wsdl。它还包含对服务接口文档中名为的 SingleSymbolBinding 的绑定的直接引用。既然这是服务接口文档中唯一的绑定，对绑定的这个引用就不是必需的。categoryBag 包含 wsdlSpec 条目以及其它的所有 keyedReference，keyedReference 指出这个服务接口描述的意向中的商业用途。

<?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>

<businessService businessKey="..." serviceKey="...">
  <name>StockQuoteService</name>
  <description xml:lang="en">
   Stock Quote Service
  </description>
  <bindingTemplates>
    <bindingTemplate bindingKey="..." serviceKey="...">
      <description>
        Single Symbol Stock Quote Service
      </description>
      <accesssPoint URLType="http">
       http://www.getquote.com/singlestockquote
      </accessPoint>
      <tModelInstanceDetails>
        <tModelInstanceInfo tModelKey="[tModel Key for Service Interface]">
          <instanceDetails>
            <overviewURL>
              http://www.getquote.com/services/SQS.wsdl
            </overviewURL>
          </instanceDetails>
        </tModelInstanceInfo>
      </tModelInstanceDetails>
    </bindingTemplate>
  </bindingTemplates>
  <categoryBag>
    <keyedReference tModelKey="UUID:DB77450D-9FA8-45D4-A7BC-04411D14E384" 
                    keyName="Stock market trading services" 
                    keyValue="84121801"/>
  </categoryBag>
</businessService>

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

<?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 服务实现在 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 以缩小对此消息的响应中返回的服务描述的范围。

<?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 关键字。

<?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。

清单 9包含一条 find_binding 消息，可用它来检索引用特定的 tModel 的 bindingTemplate。可将这个 tModel 与 WSDL 服务接口描述中的特定绑定关联起来。

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

    这条消息将返回一个或多个 bindingTemplate，比如 清单 10中的那个。访问过 bindingTemplate 之后，accessPoint 中列出了 Web 服务的端点。 如果 bindingTemplate 是根据现有的 WSDL 服务实现文档创建的，那么 overviewURL 可能包含一个对这个文档的引用。可访问这个文档获取额外的、人类可读的关于 Web 服务的信息， 这些信息在 UDDI 注册中心找不到。

<?xml version="1.0"?>
<bindingTemplate bindingKey="" serviceKey="">
  <accesssPoint URLType="http">
    http://www.getquote.com/singlestockquote
  </accessPoint>
  <tModelInstanceDetails>
    <tModelInstanceInfo tModelKey="[tModel Key for Service Interface]">
      <instanceDetails>
        <overviewURL>
          http://www.getquote.com/services/SQS.wsdl
        </overviewURL>
      </instanceDetails>
    </tModelInstanceInfo>
  </tModelInstanceDetails>
</bindingTemplate>

最后

以上就是清秀夕阳为你收集整理的查找 WSDL 服务接口描述的全部内容，希望文章能够帮你解决查找 WSDL 服务接口描述所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。