WebService说明书的书写

基于XML规范。

1，关于命名空间：

上图中，xmlns:soap=http://schemas.xmlsoap.org/wsdl/soap/是一个命名空间，其中xmlns和后面的url是不可变的，soap命名空间名称是可变的。

如果是soap，需要这样编写XML文档：

<soap:address location="http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx"/>

可以改成xzm，然后这样写即可：当然所有与soap命名空间有关的都需要改变。

<xzm:address location="http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx"/>

 

2，说明书的阅读：

从后向前读！

例如手机归属地查询的XML说明书文档：

在最先面的位置，我们可以发现：

说明这个服务的名称是MobileCodeWS，这个在程序中是一个可以new的类。

在程序中可知，

MobileCodeWSSoap m =

              newMobileCodeWS().getMobileCodeWSSoap();

MobileCodeWS类中有getMobileCodeWSSoap()方法，通过这个方法可以获取MobileCodeWSSoap接口的实现子类。关于这个MobileCodeWSSoap接口在说明书中的描述，紧接着上图的下面的位置就有。 

又可以知道，它绑定了一个tns（target namespace）为MobileCodeWSSoap的目标命名空间。继续想上找。

在binding中，有这个tns命名的内容，他的子元素中可以发现我们需要的两个业务方法。

Type属性对应的是文档继续向上的porttype，在这些porttype中找到MobileCodeWSSoap。

在这里可以发现两个方法对应的需要的请求参数以及返回值类型。通过继续向上查找对应的message即可获取。

 

3，编写SOAP的标准写法

其实书写是模仿了HTML语言。SOAP=XML+HTTP，可以通过如下形式表现出来：

模拟了浏览器的SOAP请求：

 

POST /?wsdl HTTP/1.1

HOST: localhost:9090

请求头...

[空行]

<?xml version=1.0?>

<soap:Evnelop>       //请求首行

    <soap:headers/>  //请求头

    <soap:body>       //请求的body部分。

       这里是请求参数...（请求参数一般在body中，也可以在header中）

    </soap:body>

</soap:Envelop>

 

以上就是一个WSDL文档的一般书写格式。