php webservice

1.什么是 SOAP、 WSDL?

 

   SOAP  : SOAP（Simple Object Access Protocol ）简单对象访问协议是在分散或分布式的环境中交换信息的简

                单的协议，是一个基于XML的协议

   WSDL : WSDL（Web Service Description Language）就是描述XML Web服务的标准XML格式。

 

2.WSDL文档结构

  WSDL文档可以分为两部分。顶部分由抽象定义组成，而底部分则由具体描述组成。

 

    2.1 抽象定义
　　　 Types :　独立与机器和语言的类型定义

　　　 Messages :　包括函数参数（输入与输出分开）或文档描述

　　　 PortTypes : 引用消息部分中消息定义来描述函数签名（操作名、输入参数、输出参数）

　2.2 具体定义

　　　 Bindings : PortTypes部分的每一操作在此绑定实现

　　　 Services : 确定每一绑定的端口地址

 

      注意，文档之中可能只有一个Types栏，或根本没有。所有其他的栏可以只有零元素、单元素或是多元素。

      WSDL的列表要求所有的栏以固定的顺序出 现：import, types, message, portType, binding, service。

      所有的抽象可以是单独存在于别的文件中，也可以从主文档中导入。

 

     2.3 WSDL文件示例

 

<?xml version="1.0"?>
<definitions name="StockQuote"
          targetNamespace="http://example.com/stockquote.wsdl"
          xmlns:tns="http://example.com/stockquote.wsdl"
          xmlns:xsd1="http://example.com/stockquote.xsd"
          xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
          xmlns="http://schemas.xmlsoap.org/wsdl/">
    <types>
      <schema targetNamespace="http://example.com/stockquote.xsd"
              xmlns="http://www.w3.org/2000/10/XMLSchema">
           <element name="TradePriceRequest">
              <complexType>
                  <all>
                      <element name="tickerSymbol" type="string"/>
                  </all>
              </complexType>
           </element>
           <element name="TradePrice">
              <complexType>
                  <all>
                      <element name="price" type="float"/>
                  </all>
              </complexType>
           </element>
       </schema>
    </types>
    <message name="GetLastTradePriceInput">
        <part name="body" element="xsd1:TradePriceRequest"/>
    </message>
    <message name="GetLastTradePriceOutput">
        <part name="body" element="xsd1:TradePrice"/>
    </message>
    <portType name="StockQuotePortType">
        <operation name="GetLastTradePrice">
           <input message="tns:GetLastTradePriceInput"/>
           <output message="tns:GetLastTradePriceOutput"/>
        </operation>
    </portType>
    <binding name="StockQuoteSoapBinding" type="tns:StockQuotePortType">
        <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="GetLastTradePrice">
           <soap:operation soapAction="http://example.com/GetLastTradePrice"/>
           <input>
               <soap:body use="literal"/>
           </input>
           <output>
               <soap:body use="literal"/>
           </output>
        </operation>
    </binding>
    <service name="StockQuoteService">
        <documentation>My first service</documentation>
        <port name="StockQuotePort" binding="tns:StockQuoteBinding">
           <soap:address location="http://example.com/stockquote"/>
        </port>
    </service>
</definitions>

 

     2.3.1  各部分含义:

          (1) <definitions> 部分 : 文档各名称空间声明.URI 字符串的值对于 XML 和 XSL 处理器一点不重要，但它必须是唯一的。

          (2) <types>部分 : 各类型声明。 其中对于复杂类型的，一般使用<all>或<sequence>来限定其类型出现的次序和次数。若用<all> 则限定子元素能够以任意顺序出现，每个子元素可出现零次或一次。若用<sequence> 则要求子元素必须按顺序出现。每个子元素可出现 0 到任意次数。

          (3) <message>部分 :输入及输出消息;

          (4) <portType>和<operation>元素 : PortType定义了一些抽象的操作。PortType中的operation元素定义了调用PortType中所有方法的语法，每一个 operation元素声明了方法的名称、参数（使用＜message＞元素）和各自的类型（＜part＞元素要在所有＜message＞中声明）。

          (5) <binding>和<operation>元素 : Binding栏是完整描述协议、序列化和编码的地方，Types, Messages和PortType栏处理抽象的数据内容，而Binding栏是处理数据传输的物理实现。Binding栏把前三部分的抽象定义具体化。

          (6) <service>和<port>元素 : service是一套＜port＞元素。在一一对应形式下，每个＜port＞元素都和一个location关联。如果同一个＜binding＞有多个＜port＞元素与之关联，可以使用额外的URL地址作为替换。