WSDL知识汇总

来源：互联网发布：苹果mac版office2016 编辑：程序博客网时间：2024/06/07 09:49

一、简介

WSDL 是基于 XML 的用于描述 Web Services 以及如何访问 Web Services 的语言，可规定服务的位置，以及此服务提供的操作（或方法）

WSDL 指网络服务描述语言

WSDL 使用 XML 编写

WSDL 用于描述网络服务，也可用于定位网络服务

WSDL 还不是 W3C 标准

二、WSDL文档结构

1)、<portType>：描述由某个 web service 提供的合法操作，端口定义了指向某个 web service 的连接点，可以把该元素比作传统编程语言中的一个函数库（或一个模块、

或一个类），而把每个操作比作传统编程语言中的一个函数，可把 <portType> 元素比作传统编程语言中的一个函数库，其操作类型：

a)、One-way：此操作可接受消息，但不会返回响应

<message name="newTermValues">   <part name="term" type="xs:string"/>   <part name="value" type="xs:string"/></message><portType name="glossaryTerms">   <operation name="setTerm">      <input name="newTerm" message="newTermValues"/>   </operation></portType >

b)、Request-response：此操作可接受一个请求并会返回一个响应

<message name="getTermRequest">   <part name="term" type="xs:string"/></message><message name="getTermResponse">   <part name="value" type="xs:string"/></message><!-- 把 "glossaryTerms" 定义为某个端口的名称，把 "getTerm" 定义为某个操作的名称，操作 "getTerm" 拥有一个名为 "getTermRequest" 的输入消息，     以及一个名为 "getTermResponse" 的输出消息 --><portType name="glossaryTerms">  <operation name="getTerm">    <input message="getTermRequest"/>    <output message="getTermResponse"/>  </operation></portType>

c)、Solicit-response：此操作可发送一个请求，并会等待一个响应

d)、Notification：此操作可发送一条消息，但不会等待响应

2)、<message>：web service 使用的消息，可以把这些部件比作传统编程语言中一个函数调用的参数

3)、<types>：web service 使用的数据类型，为了最大程度的平台中立性，WSDL 使用 XML Schema 语法来定义数据类型

4)、<binding>：web service 使用的通信协议，为 web service 定义消息格式和协议细节

<!-- name：定义 binding 的名称，type：指向用于 binding 的端口 --><binding type="glossaryTerms" name="b1"><!-- style：可取值 "rpc" 或 "document"，transport：定义了要使用的 SOAP 协议，例子使用 HTTP --><soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />  <!-- operation 元素定义了每个端口提供的操作符,对于每个操作，相应的 SOAP 行为都需要被定义，且必须如何对输入和输出进行编码，例子使用了 "literal" -->  <operation>    <soap:operation soapAction="http://example.com/getTerm" />    <input>      <soap:body use="literal" />    </input>    <output>      <soap:body use="literal" />    </output>  </operation></binding>

实例：

<wsdl:definitions name="nmtoken"? targetNamespace="uri">    <import namespace="uri" location="uri"/> *    <wsdl:documentation .... /> ?    <wsdl:types> ?        <wsdl:documentation .... /> ?        <xsd:schema .... /> *    </wsdl:types>    <wsdl:message name="ncname"> *        <wsdl:documentation .... /> ?        <part name="ncname" element="qname"? type="qname"?/> *    </wsdl:message>    <wsdl:portType name="ncname"> *        <wsdl:documentation .... /> ?        <wsdl:operation name="ncname"> *            <wsdl:documentation .... /> ?            <wsdl:input message="qname"> ?                <wsdl:documentation .... /> ?            </wsdl:input>            <wsdl:output message="qname"> ?                <wsdl:documentation .... /> ?            </wsdl:output>            <wsdl:fault name="ncname" message="qname"> *                <wsdl:documentation .... /> ?            </wsdl:fault>        </wsdl:operation>    </wsdl:portType>    <wsdl:serviceType name="ncname"> *        <wsdl:portType name="qname"/> +    </wsdl:serviceType>    <wsdl:binding name="ncname" type="qname"> *        <wsdl:documentation .... /> ?        <-- binding details --> *        <wsdl:operation name="ncname"> *            <wsdl:documentation .... /> ?            <-- binding details --> *            <wsdl:input> ?                <wsdl:documentation .... /> ?                <-- binding details -->            </wsdl:input>            <wsdl:output> ?                <wsdl:documentation .... /> ?                <-- binding details --> *            </wsdl:output>            <wsdl:fault name="ncname"> *                <wsdl:documentation .... /> ?                <-- binding details --> *            </wsdl:fault>        </wsdl:operation>    </wsdl:binding>    <wsdl:service name="ncname" serviceType="qname"> *        <wsdl:documentation .... /> ?        <wsdl:port name="ncname" binding="qname"> *            <wsdl:documentation .... /> ?            <-- address details -->        </wsdl:port>    </wsdl:service></wsdl:definitions>

阅读全文

0 0