WSDL - Introduction

WSDL为网络服务说明语言。 这是描述网络服务的标准格式。 WSDL是由微软和IBM联合开发的。

Features of WSDL

WSDL是在权力下放和分配的环境中进行信息交流的XML协议。

WSDL的定义描述了如何利用网络服务以及它将如何运作。

WSDL是说明如何与基于XML的服务接口的一种语言。

WSDL是世界通用说明、发现和融合(UDDI)的一个组成部分,是设在罗马的全世界商业登记处。

WSDL是UDDI使用的语言。

WSDL被宣布为大炮,并列为W-S-D-L。

WSDL Usage

WSDL经常与SOAP和XML Schema一起使用,通过因特网提供网络服务。 连接网络服务的客户方案可以读到SDL,以确定服务器上有哪些功能。 使用的任何特殊数据类型都包含在以XML Schema为形式的WSDL档案中。 然后,客户可使用SOAP实际称呼WSDL所列的职能之一。

History of WSDL

WSDL 1.1于2001年3月提交,作为W3C号说明,由Ariba、IBM和Microsoft介绍为W3CXML在XML议定书方面开展的活动。

世界网络联合会(W3C)没有认可WSDL 1.1,但刚刚发布了2版草案,作为建议(正式标准),因此得到世界3C的支持。

WSDL - Elements

WSDL将网络服务分为三个具体、可识别的内容,一旦确定,即可合并或重新使用。

可单独界定的《妇女发展权利宣言》的三个主要内容是:

Types

Operations

Binding

WSDL文件有各种内容,但这些内容载于这三个主要内容中,这些内容可以作为单独文件开发,然后可以合并或重新使用,以形成WSDL完整的档案。

WSDL Elements

世界妇女论坛文件载有以下内容:

这是妇发论坛所有文件的根本内容。 报告界定了网络服务的名称,宣布文件其余部分使用的多个名称空间,并载有本文所述的所有服务内容。

该信息中使用的数据类型是XML图。

它是数据的一个抽象定义,其形式是作为整个文件传递的信息,或作为拟被描绘成一种援引方法的论点。

这是信息操作的抽象定义,例如指明一种方法、电文或业务流程,接受和处理电文。

它是一套抽象的行动,分为一个或多个终点,界定了为具有约束力的行动收集工作;从抽象的角度来说,收集行动可以被绘制成通过各种具有约束力的运输的地图。

它是为特定港口类型确定的具体操作程序和数据格式。

它是一个具有约束力的网络地址,提供了服务通信的目标地址。

它是一份包含档案中服务定义的相关终点;该服务机构绘制了对港口具有约束力的地图,并包括任何易懂的定义。

除这些主要内容外,妇女地位部的具体规定还界定了以下用途要素:

。 这部分内容用于提供可供人阅读的文件,可列入《世界可持续发展宣言》的任何其他内容。

这一要素用于进口其他WSDL文件或XML Schemas。

NOTE-WSDL部分通常自动使用网络服务软件生成。

The WSDL Document Structure

WSDL文件的主要结构就是这样:

<definitions>
   <types>
      definition of types........
   </types>

   <message>
      definition of a message....
   </message>

   <portType>
      <operation>
         definition of a operation.......  
      </operation>
   </portType>

   <binding>
      definition of a binding....
   </binding>

   <service>
      definition of a service....
   </service>
</definitions>

妇女和自联文件还可包含其他内容,如推广内容和服务内容,从而能够将若干网络服务的定义合并为一份WSDL文件。

进一步分析世界可持续发展论坛文件的一个实例。

WSDL - Example

下面是一份WSDL文件,用于展示一个简单的WSDL方案。

让我们承担这项服务,提供一种称为sayHello的公开职能。 这项职能预期只有一个直截了当的参数,并回去了一次直观的问候。 例如,如果你通过参数world。 当时的服务职能sayHello > 回复了问答,“Hello, World>。

Example

页: 1 wsdl file -

<definitions name = "HelloService"
   targetNamespace = "http://www.examples.com/wsdl/HelloService.wsdl"
   xmlns = "http://schemas.xmlsoap.org/wsdl/"
   xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"
   xmlns:tns = "http://www.examples.com/wsdl/HelloService.wsdl"
   xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
 
   <message name = "SayHelloRequest">
      <part name = "firstName" type = "xsd:string"/>
   </message>
	
   <message name = "SayHelloResponse">
      <part name = "greeting" type = "xsd:string"/>
   </message>

   <portType name = "Hello_PortType">
      <operation name = "sayHello">
         <input message = "tns:SayHelloRequest"/>
         <output message = "tns:SayHelloResponse"/>
      </operation>
   </portType>

   <binding name = "Hello_Binding" type = "tns:Hello_PortType">
      <soap:binding style = "rpc"
         transport = "http://schemas.xmlsoap.org/soap/http"/>
      <operation name = "sayHello">
         <soap:operation soapAction = "sayHello"/>
         <input>
            <soap:body
               encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
               namespace = "urn:examples:helloservice"
               use = "encoded"/>
         </input>
		
         <output>
            <soap:body
               encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
               namespace = "urn:examples:helloservice"
               use = "encoded"/>
         </output>
      </operation>
   </binding>

   <service name = "Hello_Service">
      <documentation>WSDL File for HelloService</documentation>
      <port binding = "tns:Hello_Binding" name = "Hello_Port">
         <soap:address
            location = "http://www.examples.com/SayHello/" />
      </port>
   </service>
</definitions>

Example Analysis

Type——使用内在数据类型,并在XMLSchema中加以界定。

声明HelloRequest - first 姓名

说Helloresponse——回报值

Bled - 指示使用SOAP HTTP运输协议。

- 与URI有约束力的合伙人:http://www.examples.com/SayHello/,可在那里获得经营服务。

WSDL - <definition> Element

<definitions> 内容必须是妇发委会所有文件的根本内容。 它界定了网络服务的名称。

这里是使用定义/i>要素的最后一章中的代码。

<definitions name="HelloService"
   targetNamespace="http://www.examples.com/wsdl/HelloService.wsdl"
   xmlns="http://schemas.xmlsoap.org/wsdl/"
   xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
   xmlns:tns="http://www.examples.com/wsdl/HelloService.wsdl"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   ................................................
</definitions>

<types>
   <schema targetNamespace = "http://example.com/stockquote.xsd"
      xmlns = "http://www.w3.org/2000/10/XMLSchema">
		
      <element name = "TradePriceRequest">
         <complexType>
            <all>
               <element name = "tickerSymbol" type = "string"/>
            </all>
         </complexType>
      </element>
		
      <element name = "TradePrice">
         <complexType>
            <all>
               <element name = "price" type = "float"/>
            </all>
         </complexType>
      </element>
		
   </schema>
</types>

<message name = "SayHelloRequest">
   <part name = "firstName" type = "xsd:string"/>
</message>

<message name = "SayHelloResponse">
   <part name = "greeting" type = "xsd:string"/>
</message>

<portType name = "Hello_PortType">
   <operation name = "sayHello">
      <input message = "tns:SayHelloRequest"/>
      <output message = "tns:SayHelloResponse"/>
   </operation>
</portType>

<wsdl:definitions .... > 
   <wsdl:portType .... > *
      <wsdl:operation name = "nmtoken">
         <wsdl:input name = "nmtoken"? message = "qname"/>
      </wsdl:operation>
   </wsdl:portType >
</wsdl:definitions>

<wsdl:definitions .... >
   <wsdl:portType .... > *
      <wsdl:operation name = "nmtoken" parameterOrder = "nmtokens">
         <wsdl:input name = "nmtoken"? message = "qname"/>
         <wsdl:output name = "nmtoken"? message = "qname"/>
         <wsdl:fault name = "nmtoken" message = "qname"/>*
      </wsdl:operation>
   </wsdl:portType>
</wsdl:definitions>

<wsdl:definitions .... >
   <wsdl:portType .... > *
      <wsdl:operation name = "nmtoken" parameterOrder = "nmtokens">
         <wsdl:output name = "nmtoken"? message = "qname"/>
         <wsdl:input name = "nmtoken"? message = "qname"/>
         <wsdl:fault name = "nmtoken" message = "qname"/>*
      </wsdl:operation>
   </wsdl:portType >
</wsdl:definitions>

<wsdl:definitions .... >
   <wsdl:portType .... > *
      <wsdl:operation name = "nmtoken">
         <wsdl:output name = "nmtoken"? message = "qname"/>
      </wsdl:operation>
   </wsdl:portType>
</wsdl:definitions>

<binding name = "Hello_Binding" type = "tns:Hello_PortType">

<binding name = "Hello_Binding" type = "tns:Hello_PortType">
   <soap:binding style = "rpc" transport = "http://schemas.xmlsoap.org/soap/http"/>
   <operation name = "sayHello">
      <soap:operation soapAction = "sayHello"/>
			
      <input>
         <soap:body
            encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
            namespace = "urn:examples:helloservice" use = "encoded"/>
      </input>
			
      <output>
         <soap:body
            encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
            namespace = "urn:examples:helloservice" use = "encoded"/>
      </output>
   </operation>
</binding>

<wsdl:definitions .... >
   <wsdl:service .... > *
      <wsdl:port name = "nmtoken" binding = "qname"> *
         <-- extensibipty element (1) -->
      </wsdl:port>
   </wsdl:service>
</wsdl:definitions>

<service name = "Hello_Service">
   <documentation>WSDL File for HelloService</documentation>
   <port binding = "tns:Hello_Binding" name = "Hello_Port">
      <soap:address
         location = "http://www.examples.com/SayHello/">
   </port>
</service>

<service name = "Hello_Service">
   <documentation>WSDL File for HelloService</documentation>
   <port binding = "tns:Hello_Binding" name = "Hello_Port">
      <soap:address
         location = "http://www.examples.com/SayHello/">
   </port>
</service>

<binding name =" Hello_Binding" type = "tns:Hello_PortType">
   <soap:binding style = "rpc"
      transport = "http://schemas.xmlsoap.org/soap/http"/>
   <operation name = "sayHello">
      <soap:operation soapAction = "sayHello"/>
		
      <input>
         <soap:body
            encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
            namespace = "urn:examples:helloservice" use = "encoded"/>
      </input>
			
      <output>
         <soap:body
            encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
            namespace = "urn:examples:helloservice" use = "encoded"/>
      </output>
   </operation>
</binding>