`

SOAP和WSDL的一些必要知识

阅读更多
    http://blog.csdn.net/emon123/article/details/6836544
    SOAP和WSDL对Web Service、WCF进行深入了解的基础,因此花一些时间去了解一下是很有必要的。

一、SOAP(Simple Object Access Protocol)

如果我们要调用远程对象的方法,就必定要告诉对方,我们要调用的是一个什么方法,以及这个方法的参数的值等等。然后对方把数据返回给我们。

这其中就涉及到两个问题:1、数据如何在网络上传输。2、如何表示数据?用什么格式去表示函数以及它的参数等等。

1、SOAP的传输协议

SOAP的传输协议使用的就是HTTP协议。只不过HTTP传输的内容是HTML文本,而SOAP协议传输的是SOAP的数据。看一下下面的例子:

这是一个HTTP请求(请求google的首页)的内容:
GET / HTTP/1.1 Accept: image/gif, image/jpeg, image/pjpeg, image/pjpeg, application/x-shockwave-flash, application/x-ms-application, application/x-ms-xbap, application/vnd.ms-xpsdocument, application/xaml+xml, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */*
Accept-Language: en-us
User-Agent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/4.0; .NET CLR 2.0.50727; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729; CIBA) chromeframe/4.0
Accept-Encoding: gzip, deflate
Connection: Keep-Alive
Host: www.google.com
Cookie: PREF=ID=d8f9f1710bfa5f72:U=a5b3bec86b6433ef:NW=1:TM=1260238598:LM=1260241971:GM=1:S=q2agYsw3BsoOQMAs; NID=29=JgIGDDUx70IQTBVAnNEP_E9PLLKBI9STjzaBjgq1eWuDg-_jCgFpka59DrOC0aZKLbj4q77HU1VMKscXTP3OaseyTbv643c2XPe9dS7lsXDHAkAnS46vy-OU8XRqbmxJ; rememberme=true; SID=DQAAAH4AAABW7M4nVkTeOR7eJUmC1AJ4R6hYbmVewuy_uItLUTzZMUTpojdaHUExhPa_EPAkO9Ex1u3r7aPXZ5cj28xHnv2DbfRYf5AyaBcimciuOTITKSIkqn3QSpGDFkRS1Xn7EGzDpCV0V1xFlCu0erf_jfe_D6GOgC2P2S08jNdFS9Vpmw; HSID=AFEFTMA68EgNjkbil; __utmx=173272373.; __utmxx=173272373.

---------如果有Post的数据,这里还会有Post的数据--------



这个是一个SOAP请求的内容:

POST /WebServices/WeatherWebService.asmx HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 2.0.50727.3603)
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://WebXml.com.cn/getSupportCity"
Host: www.webxml.com.cn
Content-Length: 348
Expect: 100-continue
Connection: Keep-Alive

<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><soap:Body><getSupportCity xmlns="http://WebXml.com.cn/"><byProvinceName>广东</byProvinceName></getSupportCity></soap:Body></soap:Envelope>


可以看到,一个SOAP请求其实就是一个HTTP请求,但为了表明内容是SOAP的数据,需要加入上面请求中红色字的部分来以示区别。也就是说,如果请求头中有SOAPAction这一段,那么请求会被当作SOAP的内容来处理而不会当作HTML来解析。可以用上面指定SOAPAction头来表示内容是SOAP的内容,也可以指定 Content-Type: application/soap+xml 来表示内容是SOAP的内容。SOAP请求中最后的那段XML数据,这个就是请求的具体内容,这个就是SOAP规定的请求的数据格式,下面再详细对格式进行说明。



2、SOAP的数据格式

现在知道了SOAP是通过HTTP协议的POST方法来传输数据的,只不过是请求的Header中加了一些标志来说明自己是一个SOAP请求。那么数据的具体格式是怎么规定的呢,我们把上面请求的XML数据展开看一下:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <getSupportCity xmlns="http://WebXml.com.cn/">
            <byProvinceName>广东</byProvinceName>
        </getSupportCity>
    </soap:Body>
</soap:Envelope>
其中的<soap:Body>里面的内容就是请求的内容,请求的方法为getSupportCity,该方法有一个名为byProvinceName的参数,参数的值为“广东”这个字符串。再看一下返回的内容:
HTTP/1.1 200 OK
Date: Mon, 14 Dec 2009 05:55:39 GMT
Server: Microsoft-IIS/6.0
X-Powered-By: ASP.NET
X-AspNet-Version: 2.0.50727
Cache-Control: private, max-age=0
Content-Type: text/xml; charset=utf-8
Content-Length: 1052

<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><soap:Body><getSupportCityResponse xmlns="http://WebXml.com.cn/"><getSupportCityResult><string>广州 (59287)</string><string>深圳 (59493)</string><string>潮州 (59312)</string><string>韶关 (59082)</string><string>湛江 (59658)</string><string>惠州 (59298)</string><string>清远 (59280)</string><string>东莞 (59289)</string><string>江门 (59473)</string><string>茂名 (59659)</string><string>肇庆 (59278)</string><string>汕尾 (59501)</string><string>河源 (59293)</string><string>揭阳 (59315)</string><string>梅州 (59117)</string><string>中山 (59485)</string><string>德庆 (59269)</string><string>阳江 (59663)</string><string>云浮 (59471)</string><string>珠海 (59488)</string><string>汕头 (59316)</string><string>佛山 (59279)</string></getSupportCityResult></getSupportCityResponse></soap:Body></soap:Envelope>

返回的HTTP头中并没有标志来表明是一个SOAP的响应,因为的确没有必要,请求方发送出的SOAP请求,返回的肯定是SOAP的响应。

一个典型的SOAP请求格式的结构如下:

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

<soap:Header>
  <m:Trans xmlns:m="http://www.w3schools.com/transaction/"
  soap:mustUnderstand="1">234
  </m:Trans>
</soap:Header>

<soap:Body>
  <m:GetPrice xmlns:m="http://www.w3schools.com/prices">
    <m:Item>Apples</m:Item>
  </m:GetPrice>
</soap:Body>

</soap:Envelope>

下面逐个解释里面的元素:

a) Envelope

SOAP的请求内容必须以Envelope做为根节点。

xmlns:soap="http://www.w3.org/2001/12/soap-envelope",不能修改,否则会出错。http://www.w3.org/2001/12/soap-envelope里面有Envelope的schema的相关定义。有兴趣的可以去这个链接的内容。

soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding",这个指定了数据元素的类型。



b) Header

这个是可选的,如果需要添加Header元素,那么它必须是Envelope的第一个元素。

Header的内容并没有严格的限制,我们可以自己添加一些和应用程序相关的内容,但是客户端一定要记得处理这些Header元素,可以加上mustUnderstand强制进行处理。



c) Body

这个就是请求的主题内容了,请求什么函数,参数是什么类型等等都在这里面指定。

用标签表示一个函数,然后用子元素表示它的参数。

 

在调用中没有指定参数和返回类型,这里不需要指定,因为提供服务的一方自己已经规定好了数据类型,在调用时指定数据类型没有任何意义。



二、WSDL(Web Services Description Language)

  WSDL是用来描述WebService的,它用XML的格式描述了WebService有哪些方法、参数类型、访问路径等等。我们要使用一个WebService肯定首先要获取它的WSDL,在VS中添加一个Web 引用时,这些工作由开发环境帮我们做了,开发环境根据WSDL文档给Web Service生成了相应的代理类供我们使用。

下面是一个HelloWorld的WebService的服务端代码:
public class Service : System.Web.Services.WebService
{
    public Service () {

        //Uncomment the following line if using designed components
        //InitializeComponent();
    }

    [WebMethod]
    public DateTime HelloWorld(int i)
    {
        return DateTime.Now;
    }
}
  其对应的WebService的WSDL文档如下:
<?xml version="1.0" encoding="utf-8"?>
2 <wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://tempuri.org/" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" targetNamespace="http://tempuri.org/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
3   <wsdl:types>
4     <s:schema elementFormDefault="qualified" targetNamespace="http://tempuri.org/">
5       <s:element name="HelloWorld">
6         <s:complexType>
7           <s:sequence>
8             <s:element minOccurs="1" maxOccurs="1" name="i" type="s:int" />
9           </s:sequence>
10         </s:complexType>
11       </s:element>
12       <s:element name="HelloWorldResponse">
13         <s:complexType>
14           <s:sequence>
15             <s:element minOccurs="1" maxOccurs="1" name="HelloWorldResult" type="s:dateTime" />
16           </s:sequence>
17         </s:complexType>
18       </s:element>
19     </s:schema>
20   </wsdl:types>
21   <wsdl:message name="HelloWorldSoapIn">
22     <wsdl:part name="parameters" element="tns:HelloWorld" />
23   </wsdl:message>
24   <wsdl:message name="HelloWorldSoapOut">
25     <wsdl:part name="parameters" element="tns:HelloWorldResponse" />
26   </wsdl:message>
27   <wsdl:portType name="ServiceSoap">
28     <wsdl:operation name="HelloWorld">
29       <wsdl:input message="tns:HelloWorldSoapIn" />
30       <wsdl:output message="tns:HelloWorldSoapOut" />
31     </wsdl:operation>
32   </wsdl:portType>
33   <wsdl:binding name="ServiceSoap" type="tns:ServiceSoap">
34     <soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
35     <wsdl:operation name="HelloWorld">
36       <soap:operation soapAction="http://tempuri.org/HelloWorld" style="document" />
37       <wsdl:input>
38         <soap:body use="literal" />
39       </wsdl:input>
40       <wsdl:output>
41         <soap:body use="literal" />
42       </wsdl:output>
43     </wsdl:operation>
44   </wsdl:binding>
45   <wsdl:binding name="ServiceSoap12" type="tns:ServiceSoap">
46     <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" />
47     <wsdl:operation name="HelloWorld">
48       <soap12:operation soapAction="http://tempuri.org/HelloWorld" style="document" />
49       <wsdl:input>
50         <soap12:body use="literal" />
51       </wsdl:input>
52       <wsdl:output>
53         <soap12:body use="literal" />
54       </wsdl:output>
55     </wsdl:operation>
56   </wsdl:binding>
57   <wsdl:service name="Service">
58     <wsdl:port name="ServiceSoap" binding="tns:ServiceSoap">
59       <soap:address location="http://localhost:2206/WebSite1/Service.asmx" />
60     </wsdl:port>
61     <wsdl:port name="ServiceSoap12" binding="tns:ServiceSoap12">
62       <soap12:address location="http://localhost:2206/WebSite1/Service.asmx" />
63     </wsdl:port>
64   </wsdl:service>
65 </wsdl:definitions>


一个WSDL文档由四部分组成:

1、types

  指定了WebService用到的所有数据类型,上面用到了两种数据类型,int和datetime


2、message

  指明一个操作所用到的数据类型。

  HelloWorldSoapIn是指HelloWorld的输入操作用到的数据类型,HelloWorldSoapOut是指HelloWorld的输出操作用到的数据类型。二者的element元素指出了与types中对应到的具体类型。



3、portType

  指出了这个WebService所有支持的操作,就是说有哪些方法可供调用。

  这里支持一个HelloWorld调用,它的输入和输出对应到HelloWorldSoapIn和HelloWorldSoapOut这个两个数据类型。



4、binding

  soap12:binding元素的transport指明传输协议,这里是http协议。

  operation 指明要暴露给外界调用的操作。

  use属性指定输入输出的编码方式,这里没有指定编码。



5、services

  指定服务的一些信息,主要是指定服务的访问路径。
分享到:
评论

相关推荐

    (转)WebService之WSDL和SOAP实例(基于JAVA)

    【标题】"WebService之WSDL和SOAP实例(基于JAVA)"主要涵盖了两个核心概念:Web服务描述语言(WSDL)和简单对象访问协议(SOAP),这些都是在Java环境下实现Web服务的关键技术。 **Web服务描述语言(WSDL)** WSDL是...

    java调用soap接口案例

    通过以上知识点的学习和实践,你可以掌握如何使用Java调用SOAP接口,以及如何根据具体需求进行定制。在处理天气信息这样的案例中,理解SOAP协议和相关API的使用,将使你能够轻松地与各种Web服务进行交互。

    wsdl教程文档

    WSDL通常使用SOAP作为消息传递格式和通信协议,因此WSDL文档中会有与SOAP相关的绑定定义。 总之,WSDL是一个强大的工具,用于描述、发布、定位和调用网络服务。它为Web服务的实现提供了标准化的接口描述,确保了...

    PHP的soapDemo

    通过提供服务的URL和必要的选项,`SoapClient`可以初始化并调用远程服务的方法。请求和响应都是基于SOAP格式的XML字符串。 5. **使用示例**: - `SoapClient`实例化: ```php $client = new SoapClient('...

    Delphi的SOAP Header问题

    然而,在处理特定的SOAP Header结构时,Delphi开发者可能会遇到一些挑战。 ### SOAP Header的结构 SOAP消息由四个主要部分组成:信封(Envelope)、头(Header)、体(Body)和尾注(Fault)。其中,Header部分...

    wsdl 的 xml 方式删除操作

    这篇博客文章可能探讨的是如何通过XML表示来执行对WSDL文件的删除操作,这在维护或更新Web服务接口时可能是必要的。 **知识点1:WSDL概述** WSDL文件是Web服务的核心组成部分,它提供了服务消费者和服务提供者之间...

    SOAP

    - **XML**:SOAP基于XML,因此了解XML的基础语法和结构是必要的,包括元素、属性、命名空间等。 - **SOAP消息结构**:包括Header和Body两部分,Header通常用于传递元数据,Body则包含实际的业务数据。 - **SOAP ...

    用于object-C 的PHP Soap搭建

    WSDL和SOAP基础概念 WSDL(Web Services Description Language)是XML格式的描述语言,用于描述网络服务的接口、消息格式以及协议绑定。它允许开发者理解网络服务的细节,包括服务做什么以及如何与之交互。WSDL文件...

    一个支持SOAP11和12规范的PHP客户端

    5. **命名空间(Namespaces)**: SOAP消息中经常涉及到XML命名空间,理解如何正确处理和使用它们是必要的。 6. **错误处理和异常处理**: 在处理SOAP响应时,需要考虑错误和异常情况,比如HTTP请求失败、SOAP错误等。...

    SoapClient_20150904.zip

    6. **设置选项**:`SoapClient`还支持一些可选参数,如`soap_version`、`wsdl_cache`、`trace`等,用于自定义行为。例如,启用`trace`选项可以帮助跟踪请求和响应,方便调试。 7. **使用SoapUI**:虽然这个压缩包...

    Web服务与soap

    ### Web服务与SOAP知识点解析 #### 一、Web服务与SOAP概述 Web服务是一种通过网络提供的服务,可以被其他应用程序通过标准的网络协议调用。Web服务的主要优势在于其平台无关性和语言无关性,使得不同系统之间能够...

    WSDL请求Demo

    在IT领域,Web服务是一种通过网络进行...对于Java开发者而言,掌握Web服务和WSDL的知识对于构建可互操作的分布式系统至关重要。在实际项目中,Web服务常用于不同系统间的集成,使得数据和功能的共享变得简单且标准化。

    PB9-soap-WEBSERVICE例子.rar

    通常,这种SDK会提供必要的库和工具,使PB9能够生成和解析SOAP消息。 在PB9中调用Web服务的过程包括以下几个步骤: 1. **配置Web引用**:首先,开发者需要在PB9中添加Web服务的引用,这通常涉及输入Web服务的WSDL...

    WSDL 简介 pdf

    1. **XML**:WSDL 是基于 XML 的,因此了解 XML 基本语法是必要的。 2. **XML 命名空间**:命名空间用于避免不同文档中的标签冲突,这对于处理复杂的数据结构尤为重要。 3. **XML Schema**:用于定义 XML 文档的结构...

    sp采用WEBSERVICE接口通知订购关系需要的WSDL文件

    WSDL文件是一种XML格式的文件,它包含了关于服务的所有必要信息,包括: - **抽象接口**:定义了服务提供者支持的操作。 - **具体绑定**:定义了抽象接口在特定传输协议(如HTTP)上的实现。 - **服务元素**:将...

    java 调用soap

    Java调用SOAP(Simple Object Access Protocol)服务是Java开发者在集成不同系统或服务时常见的需求。SOAP是一种基于XML的协议,用于在...正确理解和运用这些知识点,可以帮助你有效地在Java应用中集成和使用SOAP服务。

    Soap webService 需要的 资源包 jar文件

    以下是一些重要的知识点,与SOAP Web服务及其所需的资源包jar文件密切相关: 1. **SOAP协议**:SOAP是一种轻量级、独立于语言和传输协议的消息传递协议,它定义了消息的结构以及如何处理这些消息。SOAP消息通常封装...

    SOAP:XML跨平台Web Service开发技术

    然而,由于明确要求生成的知识点应围绕标题和描述中的内容,即SOAP及XML跨平台Web服务开发技术,我们将基于这些关键词展开详细讨论。 ### SOAP:XML跨平台Web Service开发技术 #### 1. 简介 SOAP(Simple Object ...

    gsoap2.8.15移植之wsdl文件

    gSOAP 2.8.15是一个成熟的C/C++库,它允许开发者处理SOAP(简单对象访问协议)和WSDL(Web服务描述语言)接口,以便实现跨平台的网络服务交互。本篇文章将详细介绍如何利用gSOAP 2.8.15进行移植,并重点讨论与最新...

Global site tag (gtag.js) - Google Analytics