本文由wenzheng0322贡献
pdf文档可能在WAP端浏览体验不佳。建议您优先选择TXT，或下载源文件到本机查看。
■
用ＳＯＡ擎？翥溺越荻ｉｔ开发１９％ｂ Ｓ６ｒｖｌｅｅ＋．７。６
Ｉ
。
÷。一，．。
一ｏ、－”
。。｜。
ｊ，。一
ｌ。Ｊ
ｊｊ
＋髑搿｝ 彳纠∥’ｊ’｜谬
’ｆ ｆ
ｆ扩
一、Ｗｅｂ Ｓｅｒｖｉｃｅ、ＳＯＡＰ、ＷＳＤＬ、ＷＳＭＬ简介
１．Ｗｅｂ Ｓｅｎｒｉｃｅ简介
简单的讲ｓ０ＡＰ定义了一种消息交互机制，采用消息交互 来完成类似于传统的ＲＰｃ（Ｒｅｍｏｔｅ
Ｐｍｃｅｄｕｒｅ
ｃａｌｌ远程方法调
ＲＭＩ
用）的功能。与传统的ＲＰＣ机制如ＤｃＯＭ、ｃ０ＭＢＡ、Ｊａｖａ
在目前的分布式的应用开发中，ｗｅｂ ｓｅｒｖｉｃｅ（ｗｅｂ服务， 本文将统一采用ｗｅｂ ｓｅｒｖｉｃｅ，而不使用ｗｅｂ服务这个词）已 经成为一个热点。ｗｅｂ Ｓｅｎｒｉｃｅ简单的说就是部署在ｗｅｂ上的 对象／组件，具有良好的封装性，对外提供定义良好的接口供 访问，这种对象和接口都是通过ｗｓＤＬ（ｗｅｂ
Ｓｅｎｒｉｃｅ
不同的是，ｓ０ＡＰ采用ｘＭＬ进行编码，而一般的ＲＰｃ机制则是 传送二进制数据并且绑定于特定语言或者特定平台（比如 ＣＯＭ／ＤＣＯＭ／ＣＯＭ＋就限于Ｗｉｎｄｏｗｓ平台），由于ｘＭＬ能够 被任何安装有ｘＭＬ解析器的平台所理解，因此ｓ０ＡＰ天生就 具有一种连接异构平台的能力。同时ｓ０ＡＰ消息是一般通过
Ｄｅｓｃ啷ｎｉ∞
Ｓｅ卜
ＬａｎｇＩｌａｇｅ）来描述的，并且公开给感兴趣的访问者。ｗｅｂ
ＨＴＩ＇Ｐ协议传送的，由于Ｈ竹Ｐ得到了广泛的支持和应用，因
此ｓ０ＡＰ协议很容易在异构网络上传输，并且能够很容易的穿 过防火墙（传统的ＤｃＯＭ和ｃＯＲＢＡ都需要在防火墙上打开特 定的端口，可能会有潜在的安全漏洞，相比之下ＳＯＡＰ使用 Ｈ７Ｉ’ｒＰ的８０端口可无须特别设定）与各种应用系统进行通 信。综上所述，ｓ０ＡＰ由于其高度的集成能力和灵活性得到了 越来越广泛的支持，ｗｅｂ Ｓｅｒｖｉｃｅ也是使用ＳＯＡＰ来进行调用 的。 ｓ０ＡＰ是典型的请求／响应模型，下面是两段经过简化了的
ｖｉｃｅ的访问是通过ＳＯＡＰ（Ｓｉｍｐｌｅ Ｏｂｊｅｃｔ Ａｃｃｅ鹪Ｐｍｂｏｃ０１）协议
来进行的，而ｓ０ＡＰ协议一般又是利用Ｈ７Ｉ皿发送ｓ０ＡＰ请求
和接收ＳＯＡＰ响应的。因此ｗｅｂ Ｓｅｒｖｉｃｅ一般都是
位于ｗｅｂ服 务器之后的，通过各种不同的机制，ｗｅｂ服务器中的部件对 ＳＯＡＰ请求加以解析并词用相应的ｗｅｂ ｓｅｒｖｉｃｅ，并且把执行的 结果以ＨＴＴＰ响应的方式返回给客户端。如图ｌ所示。
客户端
ｓ０ＡＰ请求和响应，可以看到都是用ｘＭＬ编码的。
一个ｓ０ＡＰ请求消息，调用了Ａｄｄ方法，参数分别为４和
５。
图ｌ
ＳＯＡＰ
７Ｉ钿ｌｋｉｔ开发的Ｗｅｂ Ｓｅｎ，ｉｃｅ的基本工作原理
＜７ｘｍＩ Ｖｅｒｓｉｏｎ＝”１．Ｏ”ｅｎｃｏｄｉｎｇ＝’ＵＴＦ一８”ｓｔａｎｄａＩｏｎｅ＝“ ｎｏ”７＞
＜ＳＯＡＰ—ＥＮＶ：ＥｎｖｅｌＯＤｅ＞
由于ｘＭＬ（ｓＯＡＰ和ｗｓＤＬ都是基于ｘＭＬ的）、ｓ０ＡＰ、 ＷＳＤＬ和Ｈ，Ｉ－Ｉ＇Ｐ都是被业界广泛接受的标准，因此ｗｅｂ
Ｓｅｒｖｉｃｅ
＜ＳＯＡＰ—ＥＮＶ：Ｂｏｄｙ ＳＯＡＰ—ＥＮＶ：ｅｎｃｏｄｉｎｇＳｔｙｌｅ＝”ｈｔｔｐ：／／ ｓｃｈｅｍａｓ．ｘｍＩｓＯａｐ．Ｏｒｇ／ｓＯａｐ／ｅｎｃＯｄｉｎｇ／”＞ ＜ＳＯＡＰＳＤＫ４：
Ｓｅｒ． Ａｄｄ
．
具有高度的集成能力，能够把各种异构平台上的各种服务跨 越异构的网络连接起来，提供一种统一的解决方案。 各家厂商比如Ｓ帅、ｍＭ，微软都推出了各自的ｗｅｂ
×ｍｌｎｓ：
ＳＯＡＰＳＤＫ４＝“
ｈｔｔｐ：／／ｙａｏ—
ｔｏｎｇ．Ｏｒｇ／／ＳｏａｐＡｄｄ／ｍｅｓｓａｇｅ／”＞
＜ｉ＞４＜／．＞
ｖｉｃｅ开发方案。Ｗｉｎｄｏｗｓ平台上微软的解决方案，主要是两 种，一种是基于．ＮＥＴ的解决方案，配合Ｖｉｓｕａｌ ｓｍｄｉｏ．ＮＥＴ的 集成开发环境，开发ｗｅｂ ｓｅⅣｉｃｅ非常方便高效，这种方案的 缺点是在服务器方一定要有．ＮＥＴ运行支撑环境的支持。另外
＜ｊ＞５＜／ｐ‘
＜／ＳＯＡＰＳＤＫ４：Ａｄｄ＞ ＜／ＳＯＡＰ—ＥＮＶ：Ｂｏｄｖ＞ ＜／ＳＯＡＰ—ＥＮＶ：ＥｎｖｅｌｏＤｅ＞
一种方案是采用ｓ０ＡＰ‰ｌｌ【ｉｔ进行开发，这种方案的优点是无 需对系统进行大的升级，仅仅需要安装ｓ０ＡＰ‰ｌｋｉｔ就可以
了，而且有ＣＯＭ组件开发经验就可以进行开发。本文将介绍 基于ＳＯＡＰ’Ｉｂｏｌｋｉｔ的Ｗｅｂ Ｓｅｒｖｉｃｅ的开发。 为了更好的理解ｗｅｂ ｓｅｎｒｉｃｅ，我们将简要的介绍一下 ＳＯＡＰ、ＷＳＤＬ和ＷＳＭＬ（Ｗｅｂ ２．ｓＯＡＰ协议简介
Ｓｅｒｖｉｃｅ Ｍｅｔａ
一个ｓ０ＡＰ响应消息，返回结果为９。
＜７ｘｍＩ Ｖｅｒｓｉｏｎ＝”１．Ｏ”ｅｎｃｏｄｉｎｇ＝”ＵＴＦ一８”ｓｔａｎｄａＩＯｎｅ＝”
ｎｏ”７＞
api接口和sdk接口的区别
＜ＳＯＡＰ—ＥＮＶ：ＥｎｖｅｌｏＤｅ＞ ＜ＳＯＡＰ—ＥＮＶ：Ｂｏｄｙ ＳＯＡＰ—ＥＮＶ：ｅｎｃｏｄｉｎｇＳｔｙｌｅ＝”ｈｔｔｐ：／／ ｓｃｈｅｍａｓ．ｘｍＩｓＯａｐ．Ｏｒｇ／ｓｏａｐ／ｅｎｃｏｄｉｎｇ／”＞ ＜ＳＯＡＰＳＤＫ４：ＡｄｄＲｅｓｐｏｎｓｅ ｘｍＩｎｓ：ＳＯＡＰＳＤＫ４＝”ｈｔｔｐ：／／ ｙａＯｔｏｎｇ．ｏｒｇ／／ＳｏａｐＡｄｄ／ｍｅｓｓａｇｅ／”＞
＜ＲｅｓｕＩｔ＞９＜／Ｒｅｓ川ｔ＞
Ｌ肋ｇＩｌａｇｅ）。
。湖▲。一
２００３．３
万  方数据
撺嚣’Ｆ辫◇辍较鼍鬻ｅ鞲ＫＱ乳０《
＜Ｉ＞４＜／Ｉ＞ ＜ｐｏｒｔ
ｎａｍｅ＝’Ｃ ＪａｓｓＡｄｄＳｏａｐＰｏｒｔ’＞ ｎａｍｅ＝’Ａｄｄ’＞ ｕｓｅｓ＝’ＣＩａｓｓＡｄｄＯｂｉｅｃｔ’
ｍｅｔｈｏｄ＝７ Ａｄｄ
＜ｊ＞５＜／ｊ＞
＜／ＳＯＡＰＳＤＫ４：ＡｄｄＲｅｓＤｏｎｓｅ＞ ＜／ＳＯＡＰ—ＥＮＶ：Ｂｏｄｖ＞ ＜／ＳＯＡＰ—ＥＮＶ：ＥｎｖｅＩｏＤｅ＞
＜ｏＤｅｒａｔｉｏｎ ＜ｅ×ｅｃｕｔｅ
ｄｉｓｏＩＤ＝’１６１０８０９３４４’＞ ＜Ｄａｒａｍｅｔｅｒ ｃａ…ｎｄｅｘ＝’一１’ ｎａｍｅ＝’ｒｅｔｖａＩ’ ｅＩｅ—
希望进一步了解ｓ０ＡＰ读者可以按照附录中提供的网址访 问Ｗ３Ｃ的ＳＯＡＰ规范文档。 ３．ｗＳＤＬ简介 ＷＳＤＬ（Ｗｅｂ Ｓｅｎｒｉｃｅ Ｄｅｓｃｒｉｐｔｉｏｎ Ｌａｎｇｕａｇｅ）就是Ｗｅｂ
ｓｅ卜
ｍｅｎｔＮａｍｅ＝’Ｒｅｓｕｆｔ’／＞
＜Ｄａｒａｍｅｔｅｒ Ｎａｍｅ＝７ｉ‘／＞ ｃａｌＩＩｎｄｅｘ＝７ １ ｎａｍｅ＝’ｉ’ ｅＩｅｍｅｎｔ—
＜ｐａｒａｍｅｔｅｒ Ｎａｍｅ＝７ｉ’／＞
＜／ｅ×ｅｃｕｔｅ＞ ＜／０ＤｅｒａｔｊＯｎ＞ ＜／００ｒｔ＞ ＜／ｓｅｒｖｉｃｅ＞ ＜／ｓｅｒｖＩｃｅｍａｐｐｍｇ＞
ｃａＩ｝Ｉｎｄｅｘ＝’
２’
ｎａｍｅ＝’
ｊ
ｅＩｅｍｅｎｔ—
ｖｉｃｅ描述语言。ｗｓＤＬ是一种基于ｘＭＬ的语言，用于描述服 务器所提供的服务。一般来说，ｗｅｂ ＳｅⅣｉｃｅ都有一个相应的 ｗｓＤＬ文件用于描述本服务，比如服务的具体位置、提供的方 法、方法的参数以及调用方法所对应的ｓＯＡＰ消息格式等。通 过解析ｗｓＤＬ文件，客户端应用程序就可以得到ｗｅｂ
Ｓｅｒｖｉｃｅ
上边的代码将ｗｅｂ
ｓｅｒｖｉｃｅ
ｓｏａｐＡｄｄ映射到了一个ＣＯＭ组
各种信息，并且确切地知道调用该服务的方法。下面的一段 ｗｓＤＬ代码就是本文的例子中所用到的ｗｓＤＬ的一部分。这段 ｗｓＤＬ描述了一个名为ｓｏ印Ａｄｄ的ｗｅｂ服务，一个端口为 ｃｌ鹪ｓＡｄｄｓｏ印Ｐ０ｒｔ（端口的定义参加ｓＯＡＰ相关文档），访问该
件ｓｏａｐＰｒｏｊ．ｃｌａｓｓＡｄｄ，Ｗｅｂ Ｓｅｎ，ｉｃｅ的Ａｄｄ方法映射到了ＣＯＭ 组件的Ａｄｄ方法。 和ｗｓＤＬ不同，ｗｓＭＬ仅仅是微软在自己的ｓ０ＡＰ
Ｔｏｏｌｋｉｔ
中使用的语言，并不是一种业界标准，这点应该注意，因为各 家厂商实现ｗｅｂ ｓｅｎｒｉｃｅ的手段几乎都不一样。ｗｓＭＬ文件也 不用手动编写，用ｓＯＡＰ Ｔ００ｌｋｉｔ中的工具也可以自动生成。
服务的网络地址为ｈｔｔｐ：／／１０ｃａｌｈｏｓｔ／Ｍｓｓｏ印ｓ锄ｐｌｅｓ３０／ｓｏａ—
ｐａｄｄ／ｓｏ印Ａｄｄ．ＷＳＤＬ。
＜ｓｅｒｖｊｃｅ
ｎａｍｅ＝’ＳｏａＤＡｄｄ’＞ ｎａｍｅ＝’ＣＩａｓｓＡｄｄＳｏａｐＰＯｒｔ’
７＞
＜ｐＯｒｔ
ｂｊｎｄｊｎｇ＝’ｗｓ—
二、ＳＯＡＰ Ｔ００ｌｋｉｔ介绍
ｓ０ＡＰ
ｄＩｎｓ：ＣＩａｓｓＡｄｄＳＯａｐＢｉｎｄｉｎｇ ＜ｓｏａｐ：ａｄｄｒｅｓｓ
Ｊｏｃａｔｉｏｎ＝７
ｈｔｔｐ：／／ＪｏｃａＩｈｏｓｔ／ＭＳＳｏａｐＳａｍ．
Ｔ００ｌｋｉｔ是微软推出的一套开发ｗｅｂ ｓｅｎｒｉｃｅ的开发
ｐＩｅｓ３０／ｓｏａｐａｄｄ／ＳｏａｐＡｄｄ．ＷＳＤＬ ７／＞
＜／ＤＯｒｔ＞ ＜／ｓｅｒｖｉｃｅ＞
包。目前的最新版本是３．０，本文的ＳＯＡＰ Ｔｏｏｌｋｉｔ的基本思路 是通过对ＣＯＭ组ｆ牛／对象进行进一步的封装，使其成为可以
部署在ｗｅｂ上的组ｆ牛／对象，中间的各种转换有ｓ０ＡＰ‰ｌｋｉｔ
完成。
ｓ０ＡＰ
ｗｓＤＬ已经是一个被标准化的并且被业界广泛接受的规 范，详细的规范文档见附录中提供的网址。由于ｗｓＤＬ文件的 编写很麻烦，因此在实际开发中一般很少有人手工编写，大多 数时候是由开发工具自动生成的，ｓ０ＡＰ Ｔｏｏｌｋｉｔ也提供了这样 工具，后面将会介绍工具的使用。 希望进～步了解ＷＳＤＬ的读者可以按照附录中提供的网址 访问ｗ３Ｃ的ＷＳＤＬ的规范文档。 ４．ＷＳＭＬ简介 ＷｓＭＬ（Ｗｅｂ
Ｓｅｒｖｉｃｅ Ｍｅｔａ
Ｔｏｏｌｋｉｔ由以下部分组成：
●客户端组件。该客户
端组件允许应用程序以非常简单 的方式调用以ｗｓＤＬ文件描述的ｗｅｂ Ｓｅｎ，ｉｃｅ所提供的各种服 务。 ●服务器端组件。服务器端组件将客户端的以ｘＭＬ格式 （ＳＯＡＰ消息）发出的ｗｅｂ ｓｅｎ，ｉｃｅ的操作调用映射为对ＣＯＭ 组件的方法调用，这一过程的完成需要借助于ｗｓＭＬ文件中
ＩＪａｎｇｕａｇｅ）就是Ｗｅｂ服务元语
的描述信息。 ●ｓ０ＡＰ相关组件。这部分组件被用来建立、传送、读取 和处理ＳＯＡＰ消息。 ●辅助工具。主要包括ｗＳＤＬ／ＷＳＭＬ生成工具，ＳＯＡＰ
言。ｗｓＭＬ也是一种基于ｘＭＬ的语言，主要作用是提供ｗｅｂ ｓｅｎｒｉｃｅ与ｃ０Ｍ组件之间的映射关系。下面是例子中将用到的 ｗｓＭＬ代码。
＜７ｘｍ
ｖｅｒｓｉｏｎ＝’１．Ｏ ｅｎｃｏｄｉｎｇ＝’ＵＴＦ一８ ７＞
＜ｓｅｒＶｉｃｅｍａｐｐｉｎｇ ｎａｍｅ＝７
ＳｏａｐＡｄｄ’
Ｔｒａｃｅ工具，这些工具可以有效的帮助开发人员进行ｓ０ＡＰ应 用的开发和调试。
ｓ０ＡＰ
×ｍＩｎｓ：ｄｉｍｅ＝’ｈｔｔｐ：／／ｓｃｈｅｍａｓ．ｘｍ｛ｓｏａｐ．Ｏｒｇ／ｗｓ／２００２／ ０４／ｄｉｍｅ／ｗｓｄｌ／’＞
＜ｓｅｒＶｉｃｅ ＜ｕｓｉｎｇ
ｒＩ硼ｋｉｔ所需的运行环境如下页表。
３．０需要Ｉｎｔｅｍｅｔ
Ｅｘｐｌｏｒｅｒ
ｎａｍｅ＝７ＳｏａＤＡｄｄ’＞ ＰＲＯＧｆＤ＝７ ＳｏａｐＰｒｏｊ．ＣＩａｓｓＡｄｄ’
ｃａｃｈａｂＩｅ＝７ ０’
说明：
ＳＯＡＰ‰ｌｋｉｔ
ｌＤ＝’ＣｌａｓｓＡｄｄＯｂｉｅｃｔ ７／＞
５．０１以上版本。
，越●一—兰！坚３ 万  方数据
运行的位置 服务器端
最小的系统要求
●Ｗｉｎｄｏｗｓ ＸＰ ●Ｗｉｎｄｏｗｓ２０００ ●Ｗｉｎｄｏｗｓ ＮＴ４ ＳＰ６
这是比较关键的一步，ＩＳＡＰＩ过滤器是用来截获对ｗｓＤＬ 文件的访问的，在ＳＯＡＰ ７Ｉｋｌｋｉｔ中，客户端调用ｗｅｂ
Ｓｅｎｒｉｃｅ
的ＵＲＬ是如下形式：ｈｔｔｐ：／／服务器地址／路径名／ｗｓｄｌ文件名 ．ｗｓＤＬ，经过由于ＩＩｓ本身并不能解析这种调用，所以需要一 个ｌｓＡＰＩ过滤器来进行解析，并且创建Ｓｏ印ｓｅｎｒｅｒ３０对象，并 把客户端传来的ｓｏＡＰ调用传给ｓｏａｐｓｅⅣｅｒ３０对象，最后把调 用的结果返回。ＳＯＡＰ
Ｔ００１ｋｉｔ
其他需求：ＩＩＳ 客户端
●Ｍｉｃｍｓｏｆｔ Ｗｉｎｄｏｗｓ ＸＰ ●Ｍｉｃｒｏｓｏｆｔ Ｗｉｎｄｏｗｓ