Web Service描述语言 WSDL 详解
为什么使用WSDL?
  像Internet协议之类的标准有没有为权威所利用,或者人们这样看待它是因为顺之所获的好处远远超出了代价?曾经有许多试图建立的标准都流产了。有时候,那些还没有普遍使用的标准甚至由法令或政府规定强行推出:Ada语言就是一例。
  我相信正是跟随标准所带来的好处使它广泛接受。例如,对于铁路服务来说,真正重要的是,不同公司所铺设的铁路结合到一起,或者是来自好几个公司的产品协调的工作在一起。几家大的企业合力建立了SOAP标准。Web Service描述语言(WSDL)向这种Web Service的提供商和用户推出了方便的协调工作的方法,使我们能更容易的获得SOAP的种种好处。几家公司的铁道并在一起不算什么难事,他们所需遵循的只是两轨间的标准距离。对Web Service来说,这要复杂得多。我们必须先制定出指定接口的标准格式。
  曾经有人说SOAP并不真需要什么接口描述语言。如果SOAP是交流纯内容的标准,那就需要一种语言来描述内容。SOAP消息确实带有某些类型信息,因此SOAP允许动态的决定类型。但不知道一个函数的函数名、参数的个数和各自类型,怎么可能去调用这个函数呢?没有WSDL,我可以从必备文档中确定调用语法,或者检查消息。随便何种方法,都必须有人
参与,这个过程可能会有错。而使用了WSDL,我就可以通过这种跨平台和跨语言的方法使Web Service代理的产生自动化。就像COM和CORBA的IDL文件,WSDL文件由客户和服务器约定。
  注意由于WSDL设计成可以绑定除SOAP以外的其他协议,这里我们主要关注WSDL在HTTP上和SOAP的关系。同样,由于SOAP目前主要用来调用远程的过程和函数,WSDL支持SOAP传输的文档规范。WSDL 1.1已经作为记录递交给W3C(见/TR/wsdl.html)

WSDL文档结构

  若要理解XML文档,将之看作块状图表非常有用。下图以XML的文档形式说明了WSDL的结构,它揭示了WSDL文档五个栏之间的关系。
  WSDL文档可以分为两部分。顶部分由抽象定义组成,而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息,它们并不包含任何随机器或语言而变的元素。这就定义了一系列服务,截然不同的网站都可以实现。随网站而异的东西如序列化
便归入底部分,因为它包含具体的定义。

  l 抽象定义
    Types
    独立与机器和语言的类型定义

    Messages
    包括函数参数(输入与输出分开)或文档描述

    PortTypes
    引用消息部分中消息定义来描述函数签名(操作名、输入参数、输出参数)

  2 具体定义
    Bindings
    PortTypes部分的每一操作在此绑定实现


    Services
    确定每一绑定的端口地址
  下面的图中,箭头连接符代表文档不同栏之间的关系。点和箭头代表了引用或使用关系。双箭头代表"修改"关系。3-D的箭头代表了包含关系。这样,各Messages栏使用Types栏的定义,PortTypes栏使用Messages栏的定义;Bindings栏引用了PortTypes栏,Services栏引用Bindings栏,PortTypes和Bindings栏包含了operation元素,而Services栏包含了port元素。PortTypes栏里的operation元素由Bindings栏里的operation元素进一步修改或描述。
  在此背景中,我将使用标准的XML术语来描述WSDL文档。Element是指XML的元素,而"attribute"指元素的属性。于是:
<element attribute="attribute-value">contents</element>
内容也可能由一个或多个元素以递归的方式组成。根元素是所有元素之中最高级的元素。子元素总是从属于另一个元素,父元素。
service fault
  注意,文档之中可能只有一个Types栏,或根本没有。所有其他的栏可以只有零元素、单元素或是多元素。WSDL的列表要求所有的栏以固定的顺序出现:import, types, message, portType, binding, service。所有的抽象可以是单独存在于别的文件中,也可以从主文档中导入。
图一:抽象定义和具体定义
WSDL文件示例

  让我们来研究一下WSDL文件,看看它的结构,以及如何工作。请注意这是一个非常简单的WSDL文档实例。我们的意图只是说明它最显著的特征。以下的内容中包括更加详细的讨论。
<?xml version="1.0" encoding="UTF-8" ?>
<definitions name="FooSample"
 targetNamespace="/wsdl/"
 xmlns:wsdlns="/wsdl/"
 xmlns:typens="/xsd"
 xmlns:xsd="/2001/XMLSchema"
 xmlns:soap="/wsdl/soap/"
 xmlns:stk="schemas.microsoft/soap-toolkit/wsdl-extension"
 xmlns="/wsdl/">

<types>
<schema targetNamespace="/xsd"
  xmlns="/2001/XMLSchema"
  xmlns:SOAP-ENC="/soap/encoding/"
  xmlns:wsdl="/wsdl/"
  elementFormDefault="qualified" >
</schema>
</types>

<message name="Simple.foo">
 <part name="arg" type="xsd:int"/>
</message>

<message name="Simple.fooResponse">
 <part name="result" type="xsd:int"/>
</message>

<portType name="SimplePortType">
 <operation name="foo" parameterOrder="arg" >
  <input message="wsdlns:Simple.foo"/>
  <output message="wsdlns:Simple.fooResponse"/>
 </operation>
</portType>

<binding name="SimpleBinding" type="wsdlns:SimplePortType">
 <stk:binding preferredEncoding="UTF-8" />
 <soap:binding
  transport="/soap/http"/>
 <operation name="foo">
  <soap:operation soapAction="/action/Simple.foo"/>
  <input>
   <soap:body use="encoded" namespace="/message/"
    encodingStyle="/soap/encoding/" />
  </input>
  <output>
   <soap:body use="encoded" namespace="/message/"
    encodingStyle="/soap/encoding/" />
  </output>
 </operation>
</binding>

<service name="FOOSAMPLEService">
 <port name="SimplePort" binding="wsdlns:SimpleBinding">
  <soap:address location="carlos:8080/FooSample/FooSample.asp"/>
 </port>
</service>
</definitions>

  以下是该实例文档的总述:稍后我将详细讨论每一部分的细节。
  第一行申明该文档是XML。尽管这并不是必需的,但它有助于XML解析器决定是否解析WSDL文件或只是报错。第二行是WSDL文档的根元素:<definitions>。一些属性附属于根元素,就像<schema>子元素对于<types>元素。

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。