webservie+soap+wsdl入门

使用天气调用的webservice进行学习

http://www.webxml.com.cn/WebServices/WeatherWebService.asmx

http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?WSDL

最近因为一些特殊的需求需要提供一个基于 soap 的 webservice服务，之前没有经验，也不知道该怎么做，于是从网上查了很多东西，资料很多，但是大多不够详细，后来查到天气预报的webservice服务说明，算是看懂了一些，写在这里权做给大家做一个入门引导好了。

我觉得这个webservice有着狭义和广义的定义.

广义的来说，webservice差不多就是字面意思：web + service,也就是 服务（service）网络（web）化的意思。他力求的是跨语言，跨平台的，基于web传输的远程调用能力。他没有强调远程调用使用什么协议，所以你可以自由选择，比如soap 协议(可与基于http,smtp,等各种传输协议)，或者常见的基于http的json化的数据传输协议，基于dubbo协议的dubbo服务调用都属于web service的一种实现。

狭义的来说，这个首先声明，是我参考网上的资料已经自身的一些经历的解读哈。我认为大家经常谈的webservice是指基于soap协议实现的远程服务调用模型。

saop定义了数据交互中如何传递消息的规则。比如在http中规定了post请求的传参方式，在数据类型不同的情况下可以使用不同的参数方式。在form格式下是 key=v&key1=v1 ,同样soap也是定义这些东西的。

同样的，当我们用http方式去调用一个服务的时候我们只是知道通用的http协议的传参方式还是不够的，我们仍然需要知道目标服务的接口文档，对了，这就是wsdl,每个服务都有的接口文档，在http上可能就是我们手写的一个wiki文档，在soap中就是一个用wsdl规范编写的wsdl文档，每个服务是有能力自动生成这个文档的。wsdl规范了这个文档应该怎么写。

综上所述：soap可以类比http协议，wsdl可以类比一个http服务的接口文档。

这次用的一个比较常用的文档就是天气预报的webservice服务来进行学习

链接： http://www.webxml.com.cn/WebServices/WeatherWebService.asmx

对应的是这个文档的可读性更强的介绍，他的实际接口文档是

http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?WSDL

这篇接口文档实际上是有多个接口的描述，当然，我们这里只取一个来进行描述，取的接口是

getWeatherbyCityName

http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?op=getWeatherbyCityName

这个页面有详细的请求体和返回结果，很具体。下面我们就从他的实际接口文档wsdl中来分析一下都有什么东西。

我们知道wsdl文档包含了这么几个部分

下面我们使用getWeatherbyCityName这个接口在总的xml对应的部分做说明，将xml提取出来如下

还请学习下面的文档的时候参考 对应的可视化文档

进行对比

截取自 这里

getWeatherbyCityName

以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。

以下是 SOAP 1.2 请求和响应示例。所显示的占位符需替换为实际值。

以下是 HTTP GET 请求和响应示例。所显示的占位符需替换为实际值。

以下是 HTTP POST 请求和响应示例。所显示的占位符需替换为实际值。

什么是wsdl

SOAP简单的理解，就是这样的一个开放协议SOAP=RPC+HTTP+XML：采用HTTP作为底层通讯协议；RPC作为一致性的调用途径，XML作为数据传送的格式，允许服务提供者和服务客户经过防火墙在INTERNET进行通讯交互。RPC的描叙可能不大准确，因为SOAP一开始构思就是要实现平台与环境的无关性和独立性，每一个通过网络的远程调用都可以通过SOAP封装起来，包括DCE（Distributed Computing Environment ）　RPC CALLS，COM/DCOM CALLS, CORBA CALLS, JAVA CALLS，etc。

SOAP 使用 HTTP 传送 XML，尽管HTTP 不是有效率的通讯协议，而且 XML 还需要额外的文件解析（parse），两者使得交易的速度大大低于其它方案。但是XML 是一个开放、健全、有语义的讯息机制，而 HTTP 是一个广泛又能避免许多关于防火墙的问题，从而使SOAP得到了广泛的应用。但是如果效率对你来说很重要，那么你应该多考虑其它的方式，而不要用 SOAP。

为了更好的理解SOAP,HTTP,XML如何工作的，不妨先考虑一下COM/DCOM的运行机制，DCOM处理网络协议的低层次的细节问题，如PROXY/STUB间的通讯，生命周期的管理，对象的标识。在客户端与服务器端进行交互的时候，DCOM采用NDR（Network Data Representation）作为数据表示，它是低层次的与平台无关的数据表现形式。

Web service一般就是用SOAP协议通过HTTP来调用它，其实他就是一个WSDL文档，客户都可以阅读WSDL文档来用这个Web service。客户根据WSDL描述文档，会生成一个SOAP请求消息。Web service都是放在Web服务器 (如IIS) 后面的，客户生成的SOAP请求会被嵌入在一个HTTP POST请求中，发送到Web服务器来。Web服务器再把这些请求转发给Web service请求处理器。请求处理器的作用在于，解析收到的SOAP请求，调用Web service，然后再生成相应的SOAP应答。Web服务器得到SOAP应答后，会再通过HTTP应答的方式把它送回到客户端。

个人以为就把webservice当成是Http这种请求和响应方式就可以处理大部分问题了。

webservice 的调用有3种方式

1. httpget

2. httppost

3. httpsoap

soap 的优点是 可以传递结构化的 数据，而前两种不行。

btw, soap 最终也是使用 HTTP 传送 XML

HTTP就是邮局的协议，他们规定了你的信封要怎么写，要贴多少邮票等。。。。

SOAP就是你们之间交流的协议，负责把你所需要表达的意思写在信纸上，同时也负责让对方能够看得懂你的信。

SOAP (Simple Object Access Protocol) 顾名思义，是一个严格定义的信息交换协议，用于在Web Service中把远程调用和返回封装成机器可读的格式化数据。事实上SOAP数据使用XML数据格式，定义了一整套复杂的标签，以描述调用的远程过程、参数、返回值和出错信息等等。而且随着需要的增长，又不得增加协议以支持安全性，这使SOAP变得异常庞大，背离了简单的初衷。另一方面，各个服务器都可以基于这个协议推出自己的API，即使它们提供的服务及其相似，定义的API也不尽相同，这又导致了WSDL的诞生。WSDL (Web Service Description Language) 也遵循XML格式，用来描述哪个服务器提供什么服务，怎样找到它，以及该服务使用怎样的接口规范，简言之，服务发现。现在，使用Web Service的过程变成，获得该服务的WSDL描述，根据WSDL构造一条格式化的SOAP请求发送给服务器，然后接收一条同样SOAP格式的应答，最后根据先前的WSDL解码数据。绝大多数情况下，请求和应答使用HTTP协议传输，那么发送请求就使用HTTP的POST方法。

读懂WSDL

1. WSDL 是什么

WSDL 指网络服务描述语言 (Web Services Description Language)。 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置，以及此服务提供的操作（或方法）。

2. WSDL 文档结构

WSDL 文档是利用这些主要的元素来描述某个 web service 的：

元素

定义

最重要的 WSDL 元素，它可描述一个 web service可被执行的操作以及相关的消息。

可以把 元素比作传统编程语言中的一个函数库（或一个模块、或一个类）。

用于描述一个操作的数据元素。每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。

web service 使用的数据类型定义。为了最大程度的平台中立性，WSDL 使用 XML Schema 语法来定义数据类型。

web service 使用的通信协议元素。为每个端口定义消息格式和协议细节。

一个 WSDL 文档的主要结构

l 抽象定义

Types 独立与机器和语言的类型定义

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

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

2 具体定义

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

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

文档形式为：

definition of types........

definition of a message....

definition of a port.......

definition of a binding....

WSDL 文档可包含其它的元素，比如 extension 元素，以及一个 service 元素，此元素可把若干个 web services 的定义组合在一个单一的 WSDL 文档中。

2.1.WSDL文档实例

欢迎光临DIY部落,点击这里查看更多文章教程......

参考地址：http://www.diybl.com/course/3_program/java/javajs/2008315/104672.html

WSDL概述

WSDL就是描述XML Web服务的标准XML格式，WSDL由Ariba、Intel、IBM和微软等开发商提出。它用一种和具体语言无关的抽象方式定义了给定Web服务收发的有关操作和消息。就其定义来说，你还不能把WSDL当作一种对象接口定义语言，例如，CORBA或COM等应用程序体系结构就会用到对象接口定义语言。 WSDL保持协议中立，但它确实内建了绑定SOAP的支持，从而同SOAP建立了不可分割的联系。所以，当我在这篇文章中讨论WSDL的时候，我会假定你把SOAP作为了你的通讯协议。

————————————————————————————

WSDL协议已经被提交给了Internet标准组织W3C审批，目前还处于“确认提交”状态。W3C维持着正规的标准化系统同时提交提案必须经过确定的一套批准过程才能最终成为官方协议。在这种情况下，WSDL的地位，照外行看，至少标准组织在考虑让其成为将来可能标准中的一部分。如果你对这方面的情况感兴趣，或碰巧是一位特关心结果的“失眠症患者”，那么你不妨到W3C网站上去读读有关的建议标准。

用WSDL说明服务

作为一种基于XML的标准，如果你对XML具有一定的了解，那么WSDL的结构对你就不会陌生了。WSDL文档由服务用来描述数据类型的一组元素、服务可以收到的“消息”以及关联每条消息的SOAP绑定组成。

清单A就是一份简单的WSDL文档，该文档同W3C网站公布的WSDL示范文本是一样的，它说明了一种股票行情服务（这也是相当标准的一种Web服务）。

再仔细阅读清单A，你可以看到，文档首先以标准的XML头开头，其中包含了一个版本标识，而文档的根元素则被称为definitions。

Definitions元素可以采用若干种可选属性，这些属性说明文档同时定义文档其余部分使用的名称空间（namespace）。在这种情况下，定义被分配了一个名字（StockQuote），某些名称空间定义是根据以下常规前缀缩写制定的：

tns—“this namespace”的缩写，包含被定义服务的主名称空间

xsdl—XML Schema (XSD)名称空间，用于定义文档中的类型

soap—SOAP绑定采用的名称空间

接下来，为了定义服务的接口需要在type元素内定义所需要的任何复杂类型。这里你必须注意使用标准的XSD句法（属性），它是创造数据类型定义最为适合的方法。不过，如果你愿意，WSDL也能扩展使用不同的类型定义系统。

消息概述

按WSDL的用法，消息可以是传递给某一服务公布对象上的方法的任何参数或者方法被调用之后的任何返回结果。为了继续使用股票行情这个Web服务例子，单一定义方法多半如以下伪代码所示：

floatgetLastTradePrice(string tickerSymbol)

这样，就像你从清单A所看到的那样，文档中定义了两条消息，一条代表方法的输入参数tickerSymbol（GetLastTradePriceInput消息）另一条代表该方法的返回值（GetLastTradePriceResult消息）——最新的股票价格。

操作把消息组织到一起而且抽象地代表方法定义。在我们的例子中，这两条消息都在 GetLastTradePrice操作元素下的getLastTradePrice对象方法定义中组织起来。在一个 WSDL文件中的所有操作又都挨个在portType元素内分组。

WSDL文档的余下部分采用服务器上的侦听端点（binding 元素）绑定消息同时把端口定义同单一服务实体（service元素）组合起来。清单A的例子就定义了通过SOAP采用服务所需要的绑定。

WSDL工具

你可以手工创建WSDL文件，不过，你还可以采用相当多的工具通过WSDL来为你自动处理和定义Web服务。推荐工具软件如下：

Omniopera—一图形用户界面的WSDL、XML和XSD编辑器

Microsoft的SOAP Toolkit—一种工具包，其中包括根据WSDL定义创建COM接口的向导程序，还包括根据COM接口创建WSDL的向导程序

IBM的Web Services Toolkit—一种工具包，其中包括产生WSDL和SOAP部署说明的向导程序

参考网址：

http://iask.sina.com.cn/b/11632650.html

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com