wsdl文档结构
本文转自:http://blog.csdn.net/changyuming/article/details/3042601
???
???? WSDL把service定义为网络端点(或port)集合。在WSDL中,端点和消息的抽象定义与具体的网络部署或数据格式分开定义。这允许对抽象定义的重用。
????WSDL中主要包含以下6个元素:????(1)definitions:是WSDL文档的根源素,主要用来定义web服务的名称、声明一些命名空间并包含下面的几个元素。????(2)types:包含一些WSDL文档中使用的数据类型定义。如果WSDL文档中只使用xml架构内建的简单类型,则可以省略types元素。????(3)message:是对被交换数据的抽象描述。它描述了一个单向的消息,即它要么是一个单一的请求消息,要么是一个单一的响应消息。message元素定义了消息的名称并包含0个或多个part元素,它们表示消息的参数或消息的返回值。????(4)portType:表示端点支持的一组抽象操作。可以把多个message元素结合在一起来构成一个完整的单向或双向操作。????(5)binding:为一个特定的端口类型指定了具体的协议和数据格式。????(6)service:是一组相关端口(使用port元素表示)的集合,其中,每一个端口都表示一个端点,包含具体的绑定和网络地址。????除了以上的6个主要元素之外,WSDL文档中还可以包含documentation元素(用来添加注释)和import元素(用来导入外部文档)。其中在documentation元素中可以包含肉眼可以读的注释信息,这个元素可以出项在任何的WSDL元素中。<wsdl:import namespace="http://port.waitingfortime.org/" location="http://localhost:9999/HelloWorld?wsdl=HelloWorld.wsdl" />? 导入外部文档之后,就可以在当前文档中引用外部文档中的类型和元素。????通过使用import元素,用户可以根据抽象级别把不同的元素定义放在不同的文档中,然后再根据需要导入它们。
<message name="消息名"><part name="部分名" element="name"(或type="qname")/>......</message>?其中,消息的名称应该能够在当前wsdl文档中唯一标识一个消息,部分名应该能够在当前消息中唯一地标识一个部分。如果一个消息具有多个逻辑单元,则用户可以在message元素中包含多个part子元素;也可以先定义一个表示消息逻辑结构的复杂类型,然后再message元素中仅包含一个引用该类型的part子元素。例如,下面定义的AddHttpGetin消息中包含2个part元素:
<message name="AddHttpGetin"><part name="x" type="s:string"/><part name="y" type="s:string"/></message>?下面定义的AddSoapin消息中,则只包含一个引用复杂类型的part子元素Add:
<tpyes><s:element name="Add"><s:complexType><s:sequence><s:element minOccurs="1" maxOccurs="1" name="x" type="s:int"/><s:element minOccurs="1" maxOccurs="1" name="y" type="s:int"/></s:sequence></s:complexType></tpyes><message name="AddSoapin"><part name="parameters" element="s0:Add"/></message>?4、portType元素表示端口类型的抽象定义,端口类型由一种抽象操作组成。在定义portType元素时,使用name属性指定它的名字。portType元素中可以包含0个或多个operation子元素,operation元素又可以包含对应于操作参数和返回结果的输入和输出消息,分别使用input和output元素表示,在这2个元素中可以使用message属性指定它们所对应的消息。例如:
<portType name="MyFirstWebServicesSoap"><operation name="HelloWorld"><documentation>返回字符串HelloWorld</documentation><input message="s0:HelloWorldSoapin"/><output message="s0:HelloWorldSoapOut"/></operation><operation name="Add"><documentation>返回两个整数的和</documentation><input message="s0:AddSoapin"/><output message="s0:AddSoapOut"/></operation></portType>?5、binding元素定义了portType元素中的operation和message元素的消息格式和协议细节。一个给定的portType可以具有任意数目的绑定。格式如下:
<wsdl:binding name="绑定名" type="端口类型名"><wsdl:operation name="操作名"><wsdl:input name="输入消息名"></wsdl:input><wsdl:output name="输出消息名"></wsdl:output><wsdl:fault name="错误消息名"></wsdl:fault></wsdl:operation></wsdl:binding>?