[WS]一个简单的WSDL文档(上)
来源:互联网 发布:rac安装yum配置 编辑:程序博客网 时间:2024/04/30 15:16
http://www.cnblogs.com/bjzhanghao/archive/2004/10/13/51614.html
现在,简单解释一下《使用Axis发布简单的Web服务》中发布的Web服务所对应WSDL文档的内容和结构。请注意,同样的Java类在不同的Web服务开发包中得到的WSDL文档不一定完全相同,这里还是以使用Axis的情况作为例子。
虽然比较长,但为了方便起见还是把完整的WSDL贴在下面,然后进行说明。由于我对Web服务的认识还很不够,所以几乎可以肯定会存在一些误解,仅作参考。
<wsdl:definitions targetNamespace="http://localhost:8080/bookstore/services/BookSvc"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://localhost:8080/bookstore/services/BookSvc"
xmlns:intf="http://localhost:8080/bookstore/services/BookSvc"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns1="http://model.bookstore.com"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema targetNamespace="http://model.bookstore.com" xmlns="http://www.w3.org/2001/XMLSchema">
<import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
<complexType name="Book">
<sequence>
<element name="ISDN" nillable="true" type="xsd:string"/>
<element name="name" nillable="true" type="xsd:string"/>
<element name="page" type="xsd:int"/>
</sequence>
</complexType>
</Schema>
</wsdl:types>
<wsdl:message name="addBookResponse">
</wsdl:message>
<wsdl:message name="addBookRequest">
<wsdl:part name="book" type="tns1:Book"/>
</wsdl:message>
<wsdl:portType name="BookSvc">
<wsdl:operation name="addBook" parameterOrder="book">
<wsdl:input message="intf:addBookRequest" name="addBookRequest"/>
<wsdl:output message="intf:addBookResponse" name="addBookResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="BookSvcSoapBinding" type="intf:BookSvc">
<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="addBook">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="addBookRequest">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://bookstore.com" use="encoded"/>
</wsdl:input>
<wsdl:output name="addBookResponse">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://localhost:8080/bookstore/services/BookSvc" use="encoded"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="BookSvcService">
<wsdl:port binding="intf:BookSvcSoapBinding" name="BookSvc">
<wsdlsoap:address location="http://localhost:8080/bookstore/services/BookSvc"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
每个WSDL的根元素都是<definitions>,一般都在这里定义文档中的各种名称空间。对于上面的WSDL,定义了不少名称空间,现在来说说它们的作用。
我们都知道,WSDL应该是格式正确的XML文档。进一步,还应该把它看作一个Schema,因此,<definitions>元素中可以定义targetNamespace属性,表示在这个元素下的所有元素都属于这个目标名称空间。
xmlns表示缺省的名称空间,请注意在上面的文档中,这个缺省名称空间的值和xmlns:wsdl的值是相同的(都是http://schemas.xmlsoap.org/wsdl/)。因此,在这个WSDL中的很多<wsdl:XXX>元素,例如<wsdl:types>、<wsdl:portType>等等,实际上省略掉前面的“wsdl:”效果也是一样的。
名称空间xmlns:apachesoap在文档中并没有使用到,这个应该是Axis为某些情况预留的名称空间,或者是为了兼容以前的版本使用,因为Axis的前身是Apache Soap项目。
名称空间xmlns:intf和xmlns:impl分别代表接口(interface)和实现(implement),可以看出它们的值也是相同的,并且和<definitions>的targetNamespace一致。这是为了在文档中引用已定义的属于该目标名称空间的元素使用的,例如“<wsdl:binding name="BookSvcSoapBinding" type="intf:BookSvc">”,其中的BookSvc一定是在前面某个元素中定义的,并且属于<definitions>中指定的目标名称空间。Axis把intf和impl分开是有道理的,因为在很多情况下,一个WSDL会引用另外一个WSDL,后者可能只定义了数据类型、消息和端口类型这些抽象元素,而前者中定义绑定和服务端口等和实现有关的内容。这里先不做讨论。
名称空间xmlns:soapenc在这个文档里也没有用到,所以先不解释了。
名称空间xmlns:tns1,在很多WSDL里这个名字都叫tns的,没有后面的数字1,不知道Axis为什么起这样的名字。不过没有关系,名称空间的名字本来就没有实际的意义,只是一个代号而已。tns是This NameSpace的缩写,用来对当前WSDL进行引用。由于一个WSDL映射一个包(package),所以Axis为我们生成的WSDL里,tns1的值(http://model.bookstore.com)包含java包(com.bookstore.model)的信息就是顺理成章的了。请注意,tns1的值和<wsdl:types>里的<schema>元素的targetNamespace值是相同的。
名称空间xmlns:wsdlsoap是在与soap绑定时使用的,例如<wsdlsoap:binding>、<wsdlsoap:operation>等元素会用到。
名称空间xmlns:xsd是对XML Schema中各种数据类型的引用,例如string、boolean等等。想知道XML Schema中一共都定义了哪些数据类型,只要查看该名称空间的值(http://www.w3.org/2000/10/XMLSchema)即可。
没想到只是名称空间就写了这么多,而WSDL的结构还有不少内容,所以还是分为两部分吧,下一篇说说这个WSDL中的各个元素的作用。
参考资料:
- Web Services Description Language (WSDL) 1.1
- 使用 XML Schema 定义元素的基本知识
- 使用Axis发布简单的Web服务
- [WS]一个简单的WSDL文档(上)
- 简单了解一个WSDL,SOAP的格式
- JAX-WS与WSDL的映射关系
- JAX-WS与WSDL的映射关系
- 如果看懂一个WSDL文档
- 一个完整的WSDL文档及各标签详解
- [翻译]CXF用户指南:一个简单的JAX-WS服务
- apache cxf之 一个简单的JAX-WS服务程序
- 一个很简单的Java调用WSDL示例
- 一个很简单的Java调用WSDL示例
- 简单的WSDL的创建(WSDL)-php
- WSDL文档结构的 描述
- WebService的WSDL文档结构
- webservice的WSDL文档详解
- JAX-WS和WSDL两个概念的理解
- soap-ws 获取wsdl中所有方法 (一)
- soap-ws 获取wsdl中所有方法 (二)
- soap-ws 获取wsdl中所有方法 (三)
- 组态王、力控、MCGS、瑞尔、杰控等国内组态软件一点看法
- w3
- Olly Script Editor V2.0
- 勾股定理的证明
- OpenGL概述
- [WS]一个简单的WSDL文档(上)
- 语义网
- 神经网络在线
- OpenGL基本图元
- Introduction to COM(转自www.codeproject.com)
- Reversing CrackMe Phoenix2 protected with PEX 0.99
- 语义web相关名词
- owl-s api
- 一个计算机高手的成长(转帖)