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文档的一般书写格式。 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |