Webservice-WSDL详解（三）

怎样向别人介绍WS的功能呢？一般咱们会写接口文档，亦或口头告诉使用的人。这些方式都存在问题：其中一个我上篇中说过，客户端是无法直接使用服务端接口的；二是程序员在电脑前，想使用WS时，他们的工具（如Eclipse、VS）无法提供任何帮助，因为这些工具根本不了解你的WS。解决方案就是定义一套人和电脑都能阅读的规范或文档，因此WSDL首当其冲，你可以把WSDL理解成既是文档，又是代码。它基于XML语言，用来描述WS及其方法、参数、返回值。下面是我上篇发布的WSDL文档：

 

<definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://service.easyway.net.cn/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://service.easyway.net.cn/" name="MyServiceImplService">
<types>
<xsd:schema>
<xsd:import namespace="http://service.easyway.net.cn/" schemaLocation="http://localhost:8888/ws?xsd=1"/>
</xsd:schema>
</types>
<message name="login">
<part name="parameters" element="tns:login"/>
</message>
<message name="loginResponse">
<part name="parameters" element="tns:loginResponse"/>
</message>
<portType name="IMyService">
<operation name="login">
<input message="tns:login"/>
<output message="tns:loginResponse"/>
</operation>
</portType>
<binding name="MyServiceImplPortBinding" type="tns:IMyService">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
<operation name="login">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="MyServiceImplService">
<port name="MyServiceImplPort" binding="tns:MyServiceImplPortBinding">
<soap:address location="http://localhost:8888/ws"/>
</port>
</service>
</definitions>

WSDL为了描述服务、方法等，我们关注的点有五大部分：types、message、portType、binding、service，下面将一一说明每个节点。

1.types：用来定义访问的数据类型。这个类型是有谁生成的呢？请看上面代码第4行的schemaLocation属性，把http://localhost:8888/ws?xsd=1拷贝到浏览器，回车，就会出现如下文档：

 

<xs:schema xmlns:tns="http://service.easyway.net.cn/" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0" targetNamespace="http://service.easyway.net.cn/">
<xs:element name="login" type="tns:login"/>
<xs:element name="loginResponse" type="tns:loginResponse"/>
<xs:complexType name="login">
<xs:sequence>
<xs:element name="username" type="xs:string" minOccurs="0"/>
<xs:element name="password" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loginResponse">
<xs:sequence>
<xs:element name="loginUser" type="tns:user" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="user">
<xs:sequence>
<xs:element name="id" type="xs:int"/>
<xs:element name="password" type="xs:string" minOccurs="0"/>
<xs:element name="username" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:schema>

从上面文档中看出，有两个元素分别是login和loginResponse，也就是方法名和返回值，并且里面详细的定义了方法参数以及返回值的具体类型，直到基本类型（type），因此，可以看出，不论是多么复杂的数据结构，用这种方式都可以用基本类型的方式表现出来。

2.message：定义好数据类型后，我们就要存储这种信息，并且传递，存储这个信息的叫做SOAP（Simple Object Access Protocol，关于SOAP后面会重点讲），这个消息就叫做SOAPMessage，传递就是通过SOAP协议来传递的。一般有多少个方法一般就会产生二倍的消息，是因为参数需要一个消息，返回值也需要一个消息，可以继续看上面wsdl的文档，message有login和loginResponse两个，一个是用来传递参数，一个是用来传递返回值。到此时，我们就把把消息和元素对应起来了。

3.portType：定义好消息后，要在服务器端指明哪个接口对它进行操作，也就是指明接口名称，并且要指明接口中有哪些方法，大家可观察上面的wsdl文档，operation就是绑定该接口有哪些方法（login），input表示方法参数，output表示返回值。

4.binding：指明传递消息所用的格式。定义消息应该以什么样的形式呈现给用户，有两种形式：document和RPC，用的最多的是document，关于二者区别请点击。确定展现形式后，那用什么方式进行传递呢，有两种：literal和encoded，前者是通过XML方式传递，后者通过RMI的方式来访问，因为jdk6之前是不能用jax进行访问的，只能通过RMI。

 5.service：指定服务所发布的名称。需要注意的是服务的名称和上面definitions的名称是一致的，port的名称就是绑定服务的名称。

消息传递

讲完了上面这些，下面我们来简单的看一下消息是如何传递的，查看消息的传递，有很多工具Eclipse、TCPMON等，这里重点说下TCPMon，Eclipse大家可上网找相关资料。

TCPMON下载地址：http://ishare.iask.sina.com.cn/f/23935605.html；

TCPMON主要是拦截服务器和客户端之前的请求响应，他做一个中转站，让一切消息都经过他，因此我们在它里面就可以看到请求和响应的消息体了。运行tcpmon.bat批处理文件，可看到如下界面：

将服务器端发布的端口改为7777，客户端为8888，启动服务，然后运行客户端，你就可以看到下图：

消息包括消息头和消息体，现在只关注消息体，后续会讲解消息头内容，从上图消息格式中可以看出，他和http://localhost:8888/ws?xsd=1中的元素是一一对应的。

下篇开始讲SOAP。