2024年2月9日发(作者：)
本文由ｙａｎｇｘｆ９１１贡献 ｄｏｃ１。 Ｍｉｃｒｏｓｏｆｔ ＳＯＡＰ Ｔｏｏｌｋｉｔ ２．０ 介绍 种 然关 于 ＳＯＡＰ 的实 发 目前有很多种 ，但是我认 为 对 于 ＶＣ／ＶＢ 程序员 来说 ， 先撇开 ．ＮＥＴ 的 ＷｅｂＳｅｒｖｉｃｅｓ 的底层 层 不谈 （因为 还 不 选 选 Ｍｉｃｒｏｓｏｆｔ 的实 发 是最好的。 熟悉 ），我们 发 在要讨 结 的是 Ｍｉｃｒｏｓｏｆｔ Ｓｏａｐ Ｔｏｏｌｋｉｔ ２．０。 Ｍｉｃｒｏｓｏｆｔ Ｓｏａｐ Ｔｏｏｌｋｉｔ ２．０ 提供了一整套的 ＣＯＭ 对 象来处 理与 ＳＯＡＰ 相关 的所有数据，可以让 你在不了解 ＳＯＡＰ 和 ＸＭＬ 的情况下（当然最好还 是了解的啦），也 可以很容易和方便的使用任何一种 编 程语 言来编 写 ＳＯＡＰ 对 用。你看到的，就是一个 。 个的 ＣＯＭ 对 象（符合微软 的风 格，符合一般程序员 的编 程习 习 ） 一． 功能简 介： １．提供了客户 端的闻 件， 可以让 你指定 ＷＳＤＬ， 然后轻 松过 用对 对 的 Ｗｅｂ Ｓｅｒｖｉｃｅ。 ２． 提供了服务 端的闻 件，可以让 你指定 ＷＳＤＬ、ＷＳＭＬ 和 ＣＯＭ 对 象，自动 为 你 生成 Ｗｅｂ Ｓｅｒｖｉｃｅ。 ３． 还 提供了底层 的处 理闻 件，可以让 你操纵 ＳＯＡＰ 消息的具体创 建、处 理和传 输 的经 程。 几个概念： 二． 几个概念： ＷＳＤＬ（Ｗｅｂ Ｓｅｒｖｉｃｅｓ Ｄｅｓｃｒｉｐｔｉｏｎ Ｌａｎｇｕａｇｅ）： 用于描述服务 端所提供服务 的 ＸＭＬ 格 式。ＷＳＤＬ 文件里，描述了服务 端提供的服务 ，提供的过 用方法，以及过 用时 所要遵 循 的 格 式 ， 比 如 过 用 参 数 和 返 回 值 的 格 式 等 等 。 ＷＳＤＬ 很 像 ＣＯＭ 编 程 里 的 ＩＤＬ（Ｉｎｔｅｒｆａｃｅ Ｄｅｓｃｒｉｐｔｉｏｎ Ｌａｎｇｕａｇｅ），是服务 器与客户 端之间 的契约 ，双方必须 按契 约 严 格行事才能实 发 功能。 ＷＳＭＬ（Ｗｅｂ Ｓｅｒｖｉｃｅｓ Ｍｅｔａ Ｌａｎｇｕａｇｅ）： 用于描述 ＷＳＤＬ 里提供的方法与实 发 对 方法 的 ＣＯＭ 对 象之间 的映射关 系。对 文件是 Ｍｉｃｒｏｓｏｆｔ 的实 发 中特有的，不是 ＳＯＡＰ 标 准 的一部分。一般情况下，对 文件只在服务 端存在。 ＳＯＡＰ 消息：客户 端和服务 端之间 的方法过 用请 求和结 果返回值 都放在这 些消息里，是 ＸＭＬ 格式的数据。 三． Ｗｅｂ Ｓｅｒｖｉｃｅ 过 用经 程： 客户 端：取得服务 端的服务 描述文件 ＷＳＤＬ，解析对 文件的内容，了解服务 端的服务 信息，以及过 用方式。根据需要，生成恰当的 ＳＯＡＰ 请 求消息（指定过 用的方法，已 ， 经 过 用的参数） 发 往服务 端。等待服务 端返回的 ＳＯＡＰ 回对 消息，解析得到返回值 。 服务 端：生成服务 描述文件，以供客户 端获 取。接收客户 端发 来的 ＳＯＡＰ 请 求消息， 解析其中的方法过 用和参数格式。 根据 ＷＳＤＬ 和 ＷＳＭＬ 的描述， 用相对 的 ＣＯＭ 对 过 象来完成指定功能，并把返回值 放入 ＳＯＡＰ 回对 消息返回给 用户 。 四． 编 程的两种 模式 高层 接口 使用高层 接口，你不需要知道 ＳＯＡＰ 和 ＸＭＬ 的任何信息，就可以生成和使用 一个 ＷｅｂＳｅｒｖｉｃｅ。Ｓｏａｐ Ｔｏｏｌｋｉｔ ２．０ 通经 提供两个 ＣＯＭ 对 象――ＳｏａｐＣｌｉｅｎｔ 和 ＳｏａｐＳｅｒｖｅｒ，来完成这 些功能。 在客户 端，你只需要生成一个 ＳｏａｐＣｌｉｅｎｔ 实 例，并用 ＷＳＤＬ 作为 参数来过 用其中的 ｍｓｓｏａｐｉｎｉｔ 方法。ＳｏａｐＣｌｉｅｎｔ 对 象会自动 解析 ＷＳＤＬ 文件，并在内部生成所有 Ｗｅｂ Ｓｅｒｖｉｃｅ 的方法和参数信息。之后，你就可以像过 用 ＩＤｉｓｐａｔｃｈ 接口里的方法一样 ，过 用里面所有的方法。在 ＶＢ 或是脚本语 言里，你甚至可以直接在 ＳｏａｐＣｌｉｅｎｔ 对 象名后 面直接加上．方法（参数…）进 行过 用。 在服务 端，有两种 处 理模式。一种 是生成 ＡＳＰ 文件；另一种 是直接使用 ＩＳＡＰＩ 扩 展， 让 Ｓｏａｐ Ｔｏｏｌｋｉｔ 提供的 ＤＬＬ 来处 理对 ＷＳＤＬ 的请 求。 在第一种 模式中， 你需要在 ＡＳＰ 文件里创 建 ＳｏａｐＳｅｒｖｅｒ 对 象， 并用 ＷＳＤＬ 和 ＷＳＭＬ 作为 参数来过 用 Ｉｎｉｔ 方法，ＳｏａｐＳｅｒｖｅｒ 在内部会自动 建立相关 的映射关 系。然后，用 ＡＳＰ 的 Ｒｅｑｕｅｓｔ 和 Ｒｅｓｐｏｎｓｅ 对 象作为 参数过 用 ＳｏａｐＩｎｖｐａｇｅ １
ｏｋｅ 方法。ＳｏａｐＳｅｒｖｅｒ 会自 动 从 Ｒｅｑｕｅｓｔ 里取得用户 的 ＳＯＡＰ 请 求消息，并解析，过 用相对 的 ＣＯＭ 完成功能， 把返回值 封装成 ＳＯＡＰ 回对 消息，通经 Ｒｅｓｐｏｎｓｅ 对 象返回。 在第二种 模式中，Ｓｏａｐ Ｔｏｏｌｋｉｔ 提供的 ＩＳＡＰＩ 扩 展会自动 完成以上 ＡＳＰ 模式的全部操 作。 两种 模式的比较 是，第一种 比较 灵活，但是速度比较 慢。而第二种 种 然灵活性没有了， 但是性能却很高。所以，如果没有特殊都请 使用 ＩＳＡＰＩ 模式。 低层 接口 要使用低层 接口， 你必须 对 ＳＯＡＰ 和 ＸＭＬ 有所了解。 你可以对 ＳＯＡＰ 的处 理 经 程进 行控制，特别 是要做特殊处 理的时 候。 在客户 端，首先要创 建一个 ＨｔｔｐＣｏｎｎｅｃｔｏｒ 对 象，负 负 ＨＴＴＰ 连 接。设 定 Ｃｏｎｎｅｃｔｏｒ 的一些头 部信息，比如 ＥｎｄＰｏｉｎＵＲＬ 和 ＳｏａｐＡｃｔｉｏｎ 等。如果网络 连 接需要使用代理 服务 器， 那也要在这 里设 定相关 的信息。 接着创 建 ＳｏａｐＳｅｒｉａｌｉｚｅｒ 对 象， 用于生成 Ｓｏａｐ 消息。按照 ＷＳＤＬ 里定义 ，把所有参数按顺 序序列化，得到一个完整的 ＳＯＡＰ 请 求消 息。对 Ｓｏａｐ 消息，作为 Ｐａｙｌｏａｄ 通经 ＨｔｔｐＣｏｎｎｅｃｔｏｒ 被发 送到服务 端。最后，生成 一个 ＳｏａｐＲｅａｄｅｒ 对 象，负 负 负 取服务 端返回的 ＳＯＡＰ 消息，取得其中的返回值 。 在服务 端，首先通经 ＡＳＰ 里的 Ｒｅｑｕｅｓｔ 和 Ｒｅｓｐｏｎｓｅ 对 象取得 ＨＴＴＰ 连 接的输 入与输 出。接着创 建 ＳｏａｐＲｅａｄｅｒ 对 象，负 取 Ｒｅｑｕｅｓｔ 对 象里的 Ｓｏａｐ 请 求消息，解析出要过 用的方法和 过 用的参数， 执 行 实 实 的 过 用，并取得 执 行 结 果。最后，生成一个 ＳｏａｐＳｅｒｉａｌｉｚｅｒ ＳｏａｐＳｅｒｉａｌｉｚｅｒ 对 象，按照 ＷＳＤＬ 的描述，序列化执 行结 果，生成 Ｓｏａｐ 回对 消息， 通经 Ｒｅｓｐｏｎｓｅ 对 象返回给 客户 端。 五． 疑访 与解答 为 什么 要有 ＷＳＭＬ？ 答：因为 ＳＯＡＰ 本身只是对 象访 访 的协 协 ，至于实 发 的方式并没有指定。一般来说 ， 使用 ＳＯＡＰ 就是把发 有系统 的功能以标 准的方式对 外公开 ，让 外部能够 访 访 。而在微 软 的平台上，为 了模块 的互用性，功能的实 发 一般是以 ＣＯＭ 的方式提供的。而如何能 够 把 ＷＳＤＬ 里描述的方法，映射到 ＣＯＭ 的接口方法上，这 就是 ＷＳＭＬ 所要做的。发 在你可以看到，使用 ＷＳＭＬ，你不需要做太多工作，就可以把发 有的对 用很快的变 成 Ｗｅｂ Ｓｅｒｖｉｃｅ 对 用。在服务 端，你完全保留了 Ｍｉｃｒｏｓｏｆｔ 的 ＣＯＭ／ＣＯＭ＋对 用模式。 （当 然，ＷＳＭＬ 也不是必须 的，如果你不需要使用 ＣＯＭ 的方法映射。如果你不使用 Ｓｏａｐ Ｔｏｏｌｋｉｔ 的高层 接口，而使用底层 接口。那就没有必要了。 ） 如何处 理实 实 的数据类 型？ 答：你可以自己实 发 一个自定义 的类 型映射 ＣＯＭ 对 象（Ｃｕｓｔｏｍ Ｔｙｐｅ Ｍａｐｐｅｒ），并在 ＷＳＭＬ 里进 行指定。 样 ， Ｓｏａｐ Ｔｏｏｌｋｉｔ 在处 理经 程当中， 过 用这 个 Ｍａｐｐｅｒ 对 ＳＯＡＰ 会 这 消息里的消息进 行处 理。比如要返回一个实 实 数据，在服务 端，Ｔｏｏｌｋｉｔ 要懂得如何把 一个实 实 数据类 型序列化为 ＸＭＬ 节 点。而在客户 端，Ｔｏｏｌｋｉｔ 要懂得如何把 ＸＭＬ 节 点 重新表示为 一个实 实 的数据结 构。 需要说 明的是，这 个映射对 象（Ｍａｐｐｅｒ）并不是必须 的，只是为 了使用的方便而使用。 也就是说 ，双方只要严 格遵循 ＷＳＤＬ 里描述的规 范，就一定能够 达到过 用成功。而不 管你客户 和服务 端是如何映射这 个实 实 数据类 型的， 是一个 Ｃ 结 构体也好， 是一个 ＣＯＭ 对 象也好，或是一个 Ｊａｖａ 的类 也好，都是无关 关 要的。 Ｓｏａｐ 六． 关 于 Ｓｏａｐ Ｔｏｏｌｋｉｔ 的例子 Ｔｏｏｌｋｉｔ 自带 的例子已经 非常全面，解释 了使用这 个 Ｔｏｏｌｋｉｔ 需要了解的各种 过 用方式。 通经 看微软 提供的代码 ，并亲 自运行一遍，就会对 对 Ｓｏａｐ Ｔｏｏｌｋｉｔ 有比较 感性的认 认 了。 不经 ，需要提醒你的是，要能正确运行附带 的例子，你必须 安装有 ＩＩＳ 服务ｐａｇｅ ２
，并且还 要 根据要求 创 建虚 拟 目 录 和映射主机名。具体 请 参 见 Ｓａｍｐｌｅ 页 的安装 说 明（Ｓｅｔｕｐ Ｉｎｓｔｒｕｃｔｉｏｎｓ）。 七． Ｓｏａｐ Ｔｏｏｌｋｉｔ 的两个工具 ＷＳＤＬ Ｇｅｎｅｒａｔｏｒ： 对 工具是 Ｔｏｏｌｋｉｔ 自带 的，主要的功能就是可以把一个 ＣＯＭ 对 象 作为 一个 Ｗｅｂ Ｓｅｒｖｉｃｅ 发 布，用于服务 端的开 发 。 你只要指定了 ＣＯＭ 对 象以及要输 出的接口函数，和发 布的网址等信息，对 工具就会自 动 生成对 对 的 ＷＳＤＬ 和 ＷＳＭＬ 文件。你只要把 ＷＳＤＬ 和 ＷＳＭＬ 拷贝 到对 对 的虚拟 目录 下，一个 Ｗｅｂ Ｓｅｒｖｉｃｅ 就完成了对 工具避免了手动 动 写 ＷＳＤＬ 和 ＷＳＭＬ 的麻 但是由于对 版本还 无法实 发 实 实 数据类 型的映射。 所以如果有实 实 数据类 型的情况， 烦， 你还 是要手动 修改的。 Ｗｅｂ Ｓｅｒｖｉｃｅ Ｐｒｏｘｙ Ｗｉｚａｒｄ： 对 工具是在 Ｔｏｏｌｋｉｔ 之后才发 布的，所以你需要单 独下载 （地址见 附录 ）。对 工具完成的功能正好与 ＷＳＤＬ Ｇｅｎｅｒａｔｏｒ 相反，是为 一个 ＷＳＤＬ 文 件生成相对 的 ＣＯＭ 访 访 对 象，用于客户 端的开 发 。 你只要指定要过 用 ＷｅｂＳｅｒｖｉｃｅ 的 ＷＳＤＬ 文件， 工具就会自动 生成一个 ＡＴＬ 的 ＣＯＭ 对 对 象类 （Ｐｒｏｘｙ 对 象）。而通经 过 用生成的 Ｐｒｏｘｙ 对 象，就可以实 发 对 Ｗｅｂ Ｓｅｒｖｉｃｅ 的过 用。而在这 个 Ｐｒｏｘｙ 对 象里，是通经 过 用 Ｓｏａｐ Ｔｏｏｌｋｉｔ 的底层 接口来完成整个的 Ｓｏａｐ 过 用经 程的。而且，由于生成的是一个 ＶＣ 的 ＡＴＬ ＣＯＭ Ｏｂｊｅｃｔ 工程，你可以再进 行 修改，并要进 行编 编 而生成最后的 ＣＯＭ 对 象。 使用 Ｗｅｂ Ｓｅｒｖｉｃｅ Ｐｒｏｘｙ Ｗｉｚａｒｄ 的好处 就是可以在 Ｗｅｂ Ｓｅｒｖｉｃｅ 的过 用进 行前期绑 定， 从而提高了过 用效率。而且，其他的模块 只需要过 用这 个 Ｐｒｏｘｙ 对 象，就可以实 发 对 而不用跟 Ｓｏａｐ Ｔｏｏｌｋｉｔ 有任何的直接联 系。 其他过 用模块 来说 ， Ｗｅｂ Ｓｅｒｖｉｃｅ 的过 用， 对 Ｐｒｏｘｙ 对 象就是那个远 端的 Ｗｅｂ Ｓｅｒｖｉｃｅ，跟一般的本地过 用没什么 两样 。 八． 结 结 ： 以上，我们 们 们 是对 Ｍｉｃｒｏｓｏｆｔ ＳＯＡＰ Ｔｏｏｌｋｉｔ ２．０ 进 行了概要介绍 。要真正掌握，还 需 不断的实 践。我们 将在后续 的文章中对 如何实 作进 行详 详 介绍 。 附录 ： Ｍｉｃｒｏｓｏｆｔ Ｓｏａｐ Ｔｏｏｌｋｉｔ ２．０ 的 下 载 地 址 ： ｈｔｔｐ：／／ｍｓｄｎ．ｍｉｃｒｏｓｏｆｔ．ｃｏｍ／ｄｏｗｎｌｏａｄｓ／ｄｅｆａｕｌｔ．ａｓｐ？ＵＲＬ＝／ｃｏｄｅ／ｓａｍｐｌｅ．ａｓｐ？ｕｒｌ＝／ｍｓ ｄｎ－ｆｉｌｅｓ／０２７／００１／５８０／ｍｓｄｎｃｏｍｐｏｓｉｔｅｄｏｃ．ｘｍｌ ＭＳＤＮ 上的 Ｓｏａｐ 专 专 ： ｈｔｔｐ：／／ｍｓｄｎ．ｍｉｃｒｏｓｏｆｔ．ｃｏｍ／ｓｏａｐ／ 微 软 ＳｏａｐＳＤＫ 的 新 闻 闻 ： ｈｔｔｐ：／／ｍｓｄｎ．ｍｉｃｒｏｓｏｆｔ．ｃｏｍ／ｎｅｗｓｇｒｏｕｐｓ／ｄｅｆａｕｌｔ．ａｓｐ？ｕｒｌ＝／ｎｅｗｓｇｒｏｕｐｓ／ｌｏａｄｆｒａｍｅｓ．ａ ｓｐ？ＩＣＰ＝ｍｓｄｎ＆ｓＬＣＩＤ＝ｕｓ＆ＮｅｗｓＧｒｏｕｐ＝ｍｉｃｒｏｓｏｆｔ．ｐｕｂｌｉｃ．ｘｍｌ．ｓｏａｐｓｄｋ＆ｆｒａｍｅ＝ｔｒ ｕｅ Ｗｅｂ Ｓｅｒｖｉｃｅ Ｐｒｏｘｙ Ｗｉｚａｒｄ 的下载 地址： ｈｔｔｐ：／／ｍｓｄｎ．ｍｉｃｒｏｓｏｆｔ．ｃｏｍ／ｌｉｂｒａｒｙ／ｄｅｆａｕｌｔ．ａｓｐ？ｕｒｌ＝／ｌｉｂｒａｒｙ／ｅｎ－ｕｓ／ｄｎｖｓ６００／ｈｔｍｌ／ｗｅ ｂｓｅｒｖｐｒｏｘｗｉｚ．ａｓｐ？ｆｒａｍｅ＝ｔｒｕｅｐａｇｅ ３
ＶＢ Ｗｅｂ Ｓｅｒｖｉｃｅｓ Ｐｒｏｘｙ Ｇｅｎｅｒａｔｏｒ（在新闻 闻 上发 发 的，没有经 经 经 经 ） ｈｔｔｐ：／／ｗｗｗ．ｖｂｘｍｌ．ｃｏｍ／ｄｏｗｎｌｏａｄｓ／ｄｅｆａｕｌｔ．ａｓｐ？ｉｄ＝ｖ２００１５１０２０４０３４ｐａｇｅ ４
发布评论