当前位置 : 主页 > 网页制作 > Nodejs >

【WebService】5.WSDL深入详解

来源:互联网 收集:自由互联 发布时间:2021-06-24
之前我们用WebService搭建了服务端,使用客户端获取服务端提供的WebService方法,然后还学习了普通数据类型以及List和JavaBean数据类型在WebService上的传输和使用。 我们经常见到WebService中
之前我们用WebService搭建了服务端,使用客户端获取服务端提供的WebService方法,然后还学习了普通数据类型以及List和JavaBean数据类型在WebService上的传输和使用。

我们经常见到WebService中有“WSDL”字样,我们访问的WebService接口也是充满了XML配置,那么WSDL和XML有什么关系?我们的服务是怎么样让对方获取的呢?

想要知道以上这些,我们要了解WSDL、SOAP和UDDI。

其实WSDL就是Web Service Definition Lanauage,即WebService定义语言
。也就是我们之前在浏览器上访问出的xml,就是WSDL构造出的对外暴露的WebService定义语言,在客户端会通过wsdl2Java指令来翻译服务端提供的这段XML,从而在客户端获取WebService提供的方法。

我们看一下我们之前发布的webService:

即是
<definitions targetNamespace="http://impl.ws.cxf.java.org/" name="HelloworldWs">
    <import namespace="http://ws.cxf.java.org/" location="http://127.0.0.1:8082/sayHi?wsdl=1"/>
    <binding name="HelloworldWsPortBinding" type="ns1:HelloWorld"><soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
        <operation name="sayHi">
            <soap:operation soapAction=""/>
            <input>
            <soap:body use="literal"/>
        </input>
        <output>
            <soap:body use="literal"/>
            </output>
    </operation>
    <operation name="getCatsByUser">
        <soap:operation soapAction=""/>
        <input>
            <soap:body use="literal"/>
        </input>
        <output>
        <soap:body use="literal"/>
        </output>
    </operation>
     </binding>
     <service name="HelloworldWs">
         <port name="HelloworldWsPort" binding="tns:HelloworldWsPortBinding">
             <soap:address location="http://127.0.0.1:8082/sayHi"/>
         </port>
     </service>
</definitions>

简单说就是以下内容:
<definitions>
     <import/>
     <binding>
    ......
     </binding>
     <service name="HelloworldWs">
        ......
     </service>
</definitions>

我们详细解析一下这段XML。
首先第一段标签名为definitions,targetNamespace相当于Java中的package(xmlns相当于Java的import)。其内容http://impl.ws.cxf.java.org/和我们服务端的实现类的包名一样。

import标签中的namespace即是我们的接口所在的包,location是WebService对外暴露的接口的WSDL文档路径(http://127.0.0.1:8082/sayHi?wsdl=1)。

所以上面<import/>是接口的定义,下面的<binding>和<service>标签是Service的实现。

所以一个WSDL文档大致分为以下模块:


1.接口部分文档
我们首先来分析接口部分文档,我们来访问一下刚刚上面import标签中location的路径http://127.0.0.1:8082/sayHi?wsdl=1:

收起里面复杂的数据,其实大致为以下结构


其中type中存放的是一个标准的schema格式的数据
<types>
<xsd:schema>
<xsd:import namespace="http://ws.cxf.java.org/" schemaLocation="http://127.0.0.1:8082/sayHi?xsd=1"/>
</xsd:schema>
</types>

xsd:import中引入了一个namespace,location中引入了该接口所有数据类型,我们来访问一下http://127.0.0.1:8082/sayHi?xsd=1,得到:


我们可以看到里面包含了所有方法的输入参数类型和返回参数类型,其中的minOccurs是该参数出现的最小次数,maxOccurs是参数出现的最大次数。
像<xs:element name="return" type="tns:cat" minOccurs="0" maxOccurs="unbounded"/>这个标签的意思就是,像List中的Cat这种返回值类型可能出现的个数是0-N个。

可以看到wsdl文档的最后有一个portType的标签对,里面存放了所有可以调用的WebServcie服务,然后里面是服务的输入输出,其中的message属性就对应上面的message属性。

其中message属性的详细定义,就在types的xsd:schema中定义,而其中的xsd:import标签就引入了各种格式的定义文档路径。

所以,一次WebService的调用,其实并不是方法调用,而是发送SOAP消息(即XML文档片段)。
对于sayHi操作来说,传入的消息是
<sayHi>
    <arg0>字符串</arg0>
</sayHi>
传出的消息是:
<sayHiResponse>
    <return>字符串</return>
</sayHiResponse>

对于getCatsByUser操作来说,传入的消息是
<getCatsByUser>
    <arg0>
        <id>整数值</id>
        <name>字符串</name>
    <pass>字符串</pass>
        <address>字符串</address>
    </arg0>
</getCatsByUser>
传出的消息是:
<getCatsByUserResponse>
    <return>   --可能出现0-N次
        <id>整数值</id>
        <name>字符串</name>
        <color>字符串</color>
    </return>
</getCatsByUserResponse>

2.实现类部分文档
我们回到之前的路径http://127.0.0.1:8082/sayHi?wsdl:

上面我们访问的http://127.0.0.1:8082/sayHi?wsdl=1是接口类的定义文档,所以上面<import/>是接口的定义,下面的<binding>和<service>标签是Service的实现。

binding中绑定了可操作的方法,以及输入输出参数。
service中定义了该WebService对外提供的服务接口地址。

所以整个WSDL的文档结构就是:


通俗的说,WSDL文档描述了WebService如下3个方面:
--what:该WebService包含“什么”操作。
--how:该WebService的操作应该“怎么”调用。
--where:该WebService的服务地址。

调用一次WebService的本质:
1.客户端把调用方法参数,转换成XML文档片段(SOAP消息,input消息),该文档片段必须符合WSDL定义的格式。

2.通过网络,把XML文档片段从客户端传送给服务器。

3.服务器接收到XML文档片段。

4.服务器解析XML片段,提取其中的数据,并把数据转换成调用WebService所需要的参数值。

5.服务器执行方法。

6.把执行的方法得到的返回值,再次转换生成为XML文档片段(SOAP,output消息),该文档片段必须符合WSDL定义的格式。

7.通过网络,把XML文档片段传送给客户端。

8.客户端接收到XML文档片段。

9.客户端解析XML片段,提取其中的数据,并把数据转换成调用WebService所需要的返回值。

从上面调用本质来看,要一个语言支持WebService,唯一的要求就是:该语言支持XML文档解析、生成、支持网络传输。

只要得到WebService文档,程序就可以调用WebService。
转载请注明出处:http://www.voidcn.com/article/p-vskihqhd-bbb.html
网友评论