Webservice_03_wsdl

• Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。
• Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
• Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。
• PortType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
• Binding - 特定端口类型的具体协议和数据格式规范的绑定。
• Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
• Service- 相关服务访问点的集合。

可以参考下图来理解一下WSDL的文档结构图：

WSDL的xml schema可以参照如下网址：http://schemas.xmlsoap.org/wsdl/

三：WSDL的基本结构--详述
本节将通过一个例子详细描述WSDL文档每个元素的作用。下面一个例子是一个简单的WSDL文档的内容，
一个简单的Web Service的WSDL文档，该服务支持名为add和minus的唯一操作，该操作通过在http上运行SOAP协议来实现的。该请求接受两个整数a,b，经过处理后返回一个a+b或者a-b。浏览器：http://localhost:8888/ns?wsdl

?

<types>
	<xsd:schema>
		<xsd:import namespace="http://webservice.lichen.cn/"
			schemaLocation="http://localhost:8888/ns?xsd=1" />
	</xsd:schema>
</types>

打开http://localhost:8888/ns?xsd=1

?

<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is 
	JAX-WS RI 2.2.4-b01. -->
-
<xs:schema targetNamespace="http://webservice.lichen.cn/"
	version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://webservice.lichen.cn/">
	<xs:element type="tns:add" name="add" />
	<xs:element type="tns:addResponse" name="addResponse" />
	<xs:element type="tns:minus" name="minus" />
	<xs:element type="tns:minusResponse" name="minusResponse" />
	-
	<xs:complexType name="minus">
		-
		<xs:sequence>
			<xs:element type="xs:int" name="arg0" />
			<xs:element type="xs:int" name="arg1" />
		</xs:sequence>
	</xs:complexType>
	-
	<xs:complexType name="minusResponse">
		-
		<xs:sequence>
			<xs:element type="xs:int" name="return" />
		</xs:sequence>
	</xs:complexType>
	-
	<xs:complexType name="add">
		-
		<xs:sequence>
			<xs:element type="xs:int" name="arg0" />
			<xs:element type="xs:int" name="arg1" />
		</xs:sequence>
	</xs:complexType>
	-
	<xs:complexType name="addResponse">
		-
		<xs:sequence>
			<xs:element type="xs:int" name="return" />
		</xs:sequence>
	</xs:complexType>
</xs:schema>

• types元素使用XML模式语言声明在WSDL文档中的其他位置使用的复杂数据类型与元素；
• import元素类似于XML模式文档中的import元素，用于从其他WSDL文档中导入WSDL定义；
• message元素使用在WSDL文档的type元素中定义或在import元素引用的外部WSDL文档中定义的XML模式的内置类型、复杂类型或元素描述了消息的有效负载；
• portType元素和operation元素描述了Web服务的接口并定义了他的方法。portType元素和operation元素类似于java接口和接口中定义的方法声明。operation元素使用一个或者多个message类型来定义他的输入和输出的有效负载；
• Binding元素将portType元素和operation元素赋给一个特殊的协议和编码样式；
• service元素负责将Internet地址赋给一个具体的绑定；

?

1、definitions元素
所有的WSDL文档的根元素均是definitions元素。该元素封装了整个文档，同时通过其name提供了一个WSDL文档。除了提供一个命名空间外，该元素没有其他作用，故不作详细描述。
下面的代码是一个definitions元素的结构：

<definitions
	xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
	xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy"
	xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
	xmlns:tns="http://webservice.lichen.cn/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://webservice.lichen.cn/"
	name="MyServiceImplService">

2、types元素
WSDL采用了W3C XML模式内置类型作为其基本类型系统。types元素用作一个容器，用于定义XML模式内置类型中没有描述的各种数据类型。当声明消息部分的有效负载时，消息定义使用了在types元素中定义的数据类型和元素。在本文的WSDL文档中的types定义：

<xs:complexType name="add">
		-
		<xs:sequence>
			<xs:element type="xs:int" name="arg0" />
			<xs:element type="xs:int" name="arg1" />
		</xs:sequence>
	</xs:complexType>
	-
<xs:complexType name="addResponse">
		-
		<xs:sequence>
			<xs:element type="xs:int" name="return" />
		</xs:sequence>
</xs:complexType>

上面是数据定义部分，该部分定义了两个元素，一个是add，一个是addResponse：
add：定义了一个复杂类型，仅仅包含两个个简单的整数，将来用来描述操作的参入传入部分；
addResponse：定义了一个复杂类型，仅仅包含一个简单的整数，将来用来描述操作的返回值；

3、import元素
import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候，该功能是非常有效果的。
import的格式如下：

<wsdl:import namespace="http://xxx.xx.xxx/xxx/xxx" location="http://xxx.xxx.xxx/xxx/xxx.wsdl"/> 

?

????必须有namespace属性和location属性： namespace属性：值必须与正导入的WSDL文档中声明的targetNamespace相匹配； location属性：必须指向一个实际的WSDL文档，并且该文档不能为空。

?

4、message元素

message元素描述了Web服务使用消息的有效负载。message元素可以描述输出或者接受消息的有效负载；还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。在本文中的message元素的定义，本文档使用了采用文档样式的消息传递：

?

<message name="add">
		<part name="parameters" element="tns:add"></part>
</message>
<message name="addResponse">
		<part name="parameters" element="tns:addResponse"></part>
</message>

?

该部分是消息格式的抽象定义：定义了两个消息add和addResponse：
sayHelloResponse：add操作的响应消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；
如果采用RPC样式的消息传递，只需要将文档中的element元素应以修改为type即可。

?

5、portType元素
portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口，都是定义了一个抽象类型和方法，没有定义实现。在WSDL中，portType元素是由binding和service元素来实现的，这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及Internet地址。
一个portType中可以定义多个operation，一个operation可以看作是一个方法，本文中WSDL文档的定义：

?

<portType name="IMyService">
		<operation name="add">
			<input wsam:Action="http://webservice.lichen.cn/IMyService/addRequest"
				message="tns:add"></input>
			<output wsam:Action="http://webservice.lichen.cn/IMyService/addResponse"
				message="tns:addResponse"></output>
		</operation>
		<operation name="minus">
			<input wsam:Action="http://webservice.lichen.cn/IMyService/minusRequest"
				message="tns:minus"></input>
			<output wsam:Action="http://webservice.lichen.cn/IMyService/minusResponse"
				message="tns:minusResponse"></output>
		</operation>
	</portType>

?

portType定义了服务的调用模式的类型，这里包含两个个操作add和minus方法，同时包含input和output表明该操作是一个请求／响应模式，请求消息是前面定义的minusRequest，响应消息是前面定义的minusResponse。input表示传递到Web服务的有效负载，output消息表示传递给客户的有效负载。

?

６、binding
binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用，本文中的例子：

<binding name="MyServiceImplPortBinding" type="tns:IMyService">
		<soap:binding transport="http://schemas.xmlsoap.org/soap/http"
			style="document"></soap:binding>
		<operation name="add">
			<soap:operation soapAction=""></soap:operation>
			<input>
				<soap:body use="literal"></soap:body>
			</input>
			<output>
				<soap:body use="literal"></soap:body>
			</output>
		</operation>
		<operation name="minus">
			<soap:operation soapAction=""></soap:operation>
			<input>
				<soap:body use="literal"></soap:body>
			</input>
			<output>
				<soap:body use="literal"></soap:body>
			</output>
		</operation>
	</binding>

?

这部分将服务访问点的抽象定义与SOAP HTTP绑定，描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体SOAP调用时，应当使用的soapAction是""。
具体的使用需要参考特定协议定义的元素。

?

７、service元素和port元素
service元素包含一个或者多个port元素，其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding，甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。文档中的例子：

?

<service name="MyServiceImplService">
	<port name="MyServiceImplPort" binding="tns:MyServiceImplPortBinding">
		<soap:address location="http://localhost:8888/ns"></soap:address>
	</port>
</service>

?

这部分是具体的Web服务的定义，在这个名为MyService的Web服务中，提供了一个服务访问入口，访问地址是http://localhost:8888/ns，使用的消息模式是由前面的binding所定义的。