首页 > 开发 > 综合 > 正文

如何架构Web Service-WSDL服务描述

2024-07-21 02:21:51
字体:
来源:转载
供稿:网友

最后,我给出对应本节描述的save_category元素的schema定义的schema图示来结束本小节。

figure 1.   soap api schema图示



wsdl服务描述

对soap api消息完成schema建模之后,一方面这个数据模型可以由soap interface来使用,当发生具体调用时可以使用这个数据模型来除了传入的参数并生成传出的参数。同时,利用这个数据模型,我们可以生成相应的wsdl描述,从而将这个web服务的接口文档发布给使用者,该接口文档是具备被程序自动处理的能力的。

以下是wsdl文档详细的定义:(完整的wsdl文档是: sagitta.wsdl)


<?xml version="1.0"?>
<definitions name="catalogservice"
             targetnamespace="http://www.sagitta.com/wsdl/savecategory.wsdl"
             xmlns:tns="http://www.sagitta.com/wsdl/savecategory.wsdl"
             xmlns:myxs="http://www.sagitta.com/schema/"
             xmlns:soap="http://www.w3.org/2001/06/soap-envelope"
             xmlns="http://schemas.xmlsoap.org/wsdl/">

  <import namespace="http://www.sagitta.com/schema/" location=" http://www.sagitta.com/schema/save_category.xsd" />




这是wsdl文件的文件头,其中的import元素指明在这个wsdl文件中,types系统是由http://www.sagitta.com/schema/save_category.xsd文件具体描述,在这里仅仅是将其导入。


  <message name="save_category">
    <part name="body" element="myxs:save_category"/>
  </message>

  <message name="categorylist">
    <part name="body" element="myxs:categorylist"/>
  </message>




这里定义了两条消息:save_category消息,在前面的schema建模中已经完整地创建了根元素的结构定义。其中myxs是这里使用的命名空间(namespace),命名空间的具体定义在文件头上出现。而categorylist将会对应save_category消息的返回消息,在schema建模中没有表现,在这里我也仅列出一个元素名,相信大家在看了本文的前半部分以及本系列的前一篇文章之后,会很清楚如何来定义。


  <porttype name="save_category_porttype">
    <operation name="save_category_operation">
      <input message="tns:save_category"/>
      <output message="tns:categorylist"/>
    </operation>
  </porttype>




这部分定义了服务访问点的调用模式的类型,表明这个入口类型是请求/响应模式,请求消息是save_category,而响应消息是categorylist。


  <binding name="save_category_soapbinding" type=" save_category_porttype ">
    <soap:binding transport=" http://www.w3.org/2001/06/soap-envelope/http">
      <operation name="save_category_operation">
        <soap:operation soapaction=" http://www.sagitta.com/catalog/">
          <input>
            <soap:body use="literal" namespace=" http://www.sagitta.com/schema/"
                       encodingstyle=" http://www.w3.org/2001/06/soap-encoding"/>
          </input>
          <output>
            <soap:body use="literal" namespace=" http://www.sagitta.com/schema/"
                       encodingstyle=" http://www.w3.org/2001/06/soap-encoding"/>
          </output>
        </soap:operation>
      </operation>
    </soap:binding>
  </binding>




这部分将服务访问点的抽象定义与soap http绑定,描述如何通过soap/http来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体soap调用时,应当使用的soapaction是"http://www.sagitta.com/catalog/",而请求/响应消息的编码风格都应当采用soap规范默认定义的编码风格" http://www.w3.org/2001/06/soap-encoding "。


<service name="catalogservice">
    <documentation>online web service for catalog</documentation>
    <port name="save_category_port" binding="tns:save_category_soapbinding">
    <soap:address location="http://www.sagitta.com/catalog/"/>
    </port>
  </service>

</definitions>




这部分是具体的web服务的定义,在这个名为catalogservice的web服务中,提供了一个服务访问入口(其实还有很多,不过在这里因为演示的原因,仅仅介绍了一个),访问地址是"http://www.sagitta.com/catalog/",使用的消息模式是由前面的binding所定义的。

uddi服务发布

在前一节中,我们已经通过使用wsdl这个工具将catalog service这个web服务进行了结构化地描述。为了使更多的潜在用户能够发现这个web服务,同时也为了加强这个web服务的互操作能力和灾难恢复时的连接保持能力,我们需要使用uddi sdk将这个web服务注册到uddi注册中心中去。

假设我们之前已经注册了一个businessentity,叫做www.sagitta.com,一个在线服务提供商,这个businessentity的键值是"434554f4-6e17-1342-ea41-36e642531da1",那么我们要在这个businessentity下注册一个businessservice,以用于描述前面的catalog service。同时需要成立的假设是我们也预先注册了一个service type(tmodel),这个tmodel描述了我们这个需要发布的web服务的调用规范,具体内容是前面我定义的这个wsdl文档,在uddi中,注册的是描述的链接。

businessservice注册的soap消息如下,其中使用了microsoft的test.uddi.microsoft.com站点,因此authinfo中可以填入测试用的udditest。


<?xml version="1.0" encoding="utf-8"?>
<envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  <body>
    <save_service generic="1.0" xmlns="urn:uddi-org:api">
      <authinfo>udditest</authinfo>
      <businessservice businesskey="434554f4-6e17-1342-ea41-36e642531da1" servicekey="">
        <name>categoryservice</name>
        <description xml:lang="en">online web service for catalog</description>
        <bindingtemplates>
          <bindingtemplate bindingkey="" servicekey="">
            <description xml:lang="en">categoryservice's bindingtemplate3</description>
            <accesspoint urltype="http">http://www.sagitta.com/catalog/</accesspoint>
            <tmodelinstancedetails>
              <tmodelinstanceinfo tmodelkey="uuid:e31a569a-aeff-4468-ba4d-2bf22fe4acef">
                <description xml:lang="en">sagitta web service type description</description>
                <instancedetails>
                  <description xml:lang="en">sagitta web service type description</description>
                  <overviewdoc>
                    <description xml:lang="en">sagitta web service overview</description>
                    <overviewurl>http://www.sagitta.com/wsdl/savecategory.wsdl</overviewurl>
                  </overviewdoc>
                </instancedetails>
              </tmodelinstanceinfo>
            </tmodelinstancedetails>
          </bindingtemplate>
        </bindingtemplates>
      </businessservice>
    </save_service>
  </body>
</envelope>




通过上述的api调用,我们就已经把这个服务注册进了uddi注册中心,其中bindingtemplate的accesspoint是服务的入口,而overviewdoc中的overviewurl是wsdl文档的访问位置。

潜在的使用者可以通过查询uddi注册中心找到这个web服务,通过overviewurl中保存的url找到服务的描述,然后通过accesspoint所指定的访问地址来访问这个服务。

当发生紧急服务崩溃的时候,web服务可能被迁移到另一台主机上,ip地址,甚至是访问的url都可能有很大变化,此时原先的集成的连接将不再工作。但是由于uddi注册的存在,我们可以通过自动化的程序手段来解决这个问题,使得类似的服务灾难恢复的过程非常迅速。

具体的流程一般是:

当恢复的服务启动后,自动去更新uddi注册中心上的数据,将访问入口修改到新的url位置;
连入的客户端系统当发现无法访问最终服务的时候,将会定期去查询uddi注册中心,看看新的bindingtemplate数据和本地缓存的有没有差别,如果有的话,就下载到本地,重新建立服务绑定,完成服务连接的迁移。
总结

到这篇文章为止,如何架构web service这个系列就将告一段落,在整个系列中,从为什么要有web服务开始,到什么是web服务,web服务的开发工具,对web服务作了一个概念上的全面介绍。然后以一个具体实例来介绍web服务的构建模式和各种web service "stack"技术的具体应用。希望这个系列对大家理解和接受下一代的应用包装模式web服务有一个全面的帮助。

参考资料

web service 技术/评论网站
uddi-china.org, 以uddi为主的web服务技术网站。
webservices.org, web服务的综合类技术网站。
ibm developerworks/web service zone, ibm的web服务技术资源中心
msdn online web services developer resources, microsoft的web服务的开发者资源网站
itpapers/web service, itpapers的web服务评论文章
解决b2b电子商务应用交互和集成的interop stack系列技术标准规范
uddi执行白皮书, uddi-china.org, uddi.org
uddi技术白皮书, uddi-china.org, uddi.org
uddi程序员api规范, uddi-china.org, uddi.org
uddi数据结构参考, uddi-china.org, uddi.org
web service description language (wsdl) 1.0, ibm, 25 sep 2000
soap: simple object access protocol specification 1.1, ibm, microsoft, developmentor, 2000
xml schema part 0: primer , w3c, 2 may 2001
extensible markup language (xml) 1.0 (second edition), w3c, 6 oct 2000
作者简介

柴晓路: 上海得易电子商务技术有限公司(dealeasy)首席系统架构师、xml技术顾问。uddi-china.org蓝色火焰工作室(blue blaze studio)成员。uddi advisor group成员,wsui working group成员。2000年获复旦大学计算机科学硕士学位,曾在国际计算机科学学术会议(icsc)、亚太区xml技术研讨会(xml asia/pacific'99)、中国xml技术研讨会(北京)、计算机科学期刊等各类国际、国内重要会议与期刊上发表论文多篇。专长于基于xml的系统集成和数据交换的技术研究,同时对数据库、面向对象技术及cscw等技术比较擅长。

发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表