码农教程 - 一技在手,衣食无忧! tools

目录

XML WSDL

❮ 上一节 下一节 ❯
  • WSDL 代表 Web 服务描述语言
  • WSDL 用于描述 Web 服务
  • WSDL 是用 XML 编写的
  • WSDL 是 W3C 自 2007 年 6 月 26 日起提出的建议

WSDL 文档

WSDL 文档描述 Web 服务。它使用以下主要元素指定服务的位置和服务的方法：

Element Description
<types> Defines the (XML Schema) data types used by the web service
<message> Defines the data elements for each operation
<portType> Describes the operations that can be performed and the messages involved.
<binding> Defines the protocol and data format for each port type

WSDL 文档的主要结构如下所示：

<definitions>

<types>
  data type definitions........
</types>

<message>
  definition of the data being communicated....
</message>

<portType>
  set of operations......
</portType>

<binding>
  protocol and data format specification....
</binding>

</definitions>

WSDL 示例

这是 WSDL 文档的简化部分：

<message name="getTermRequest">
  <part name="term" type="xs:string"/>
</message>

<message name="getTermResponse">
  <part name="value" type="xs:string"/>
</message>

<portType name="glossaryTerms">
  <operation name="getTerm">
    <input message="getTermRequest"/>
    <output message="getTermResponse"/>
  </operation>
</portType>

在这个例子中<端口类型>元素将#"glossaryTerms"定义为a的名称港口，以及 "getTerm" 作为名称手术。

"getTerm" 操作有一个输入信息称为 "getTermRequest" 和输出消息称为"getTermResponse"。

这个<消息>元素定义了部分每条消息和相关数据类型。

<portType> 元素

<portType> 元素定义网络服务， 这运营可以执行的，并且消息所涉及的。

请求-响应类型是最常见的操作类型，但 WSDL 定义了四种类型：

Type Definition
One-way The operation can receive a message but will not return a response
Request-response The operation can receive a request and will return a response
Solicit-response The operation can send a request and will wait for a response
Notification The operation can send a message but will not wait for a response

WSDL 单向操作

单向操作示例：

<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 >

在上面的示例中，portType "glossaryTerms" 定义了一种名为 "setTerm" 的单向操作。

"setTerm" 操作允许使用带有输入参数 "term" 和 "value" 的 "newTermValues" 消息来输入新词汇表术语消息。但是，没有为该操作定义输出。

WSDL 请求-响应操作

请求-响应操作示例：

<message name="getTermRequest">
  <part name="term" type="xs:string"/>
</message>

<message name="getTermResponse">
  <part name="value" type="xs:string"/>
</message>

<portType name="glossaryTerms">
  <operation name="getTerm">
    <input message="getTermRequest"/>
    <output message="getTermResponse"/>
  </operation>
</portType>

在上面的示例中，portType "glossaryTerms" 定义了一个名为 "getTerm" 的请求-响应操作。

"getTerm" 操作需要名为 "getTermRequest" 的输入消息以及名为 "term" 的参数，并将返回名为 "getTermResponse" 的输出消息以及名为 "value" 的参数。

WSDL 绑定到 SOAP

WSDL 绑定定义 Web 服务的消息格式和协议详细信息。

请求-响应操作示例：

<message name="getTermRequest">
  <part name="term" type="xs:string"/>
</message>

<message name="getTermResponse">
  <part name="value" type="xs:string"/>
</message>

<portType name="glossaryTerms">
  <operation name="getTerm">
    <input message="getTermRequest"/>
    <output message="getTermResponse"/>
  </operation>
</portType>

<binding type="glossaryTerms" name="b1">
   <soap:binding style="document"
   transport="http://schemas.xmlsoap.org/soap/http" />
   <operation>
     <soap:operation soapAction="http://example.com/getTerm"/>
     <input><soap:body use="literal"/></input>
     <output><soap:body use="literal"/></output>
  </operation>
</binding>

这个捆绑元素有两个属性 - 名称和类型。

name 属性（您可以使用您想要的任何名称）定义绑定的名称，type 属性指向绑定的端口，在本例中为 "glossaryTerms" 端口。

这个肥皂：粘合元素有两个属性——样式和传输。

样式属性可以是"rpc" 或"document"。在本例中我们使用文档。传输属性定义要使用的 SOAP 协议。在本例中我们使用 HTTP。

这个手术元素定义 portType 公开的每个操作。

对于每个操作，必须定义相应的 SOAP 操作。您还必须指定输入和输出的编码方式。在本例中我们使用"literal"。


❮ 上一节 下一节 ❯