Microsoft SOAP Toolkit 2.0介绍 (转)
2024-07-21 02:25:11
供稿：网友
虽然关于soap的实现目前有很多种，但是我认为对于vc/vb程序员来说，选择microsoft的实现是最好的。先撇开.net的webservices的底层库不谈(因为还不熟悉l)，我们现在要讨论的是microsoft soap toolkit 2.0。
microsoft soap toolkit 2.0提供了一整套的com对象来处理与soap相关的所有数据，可以让你在不了解soap和xml的情况下(当然最好还是了解的啦)，也可以很容易和方便的使用任何一种编程语言来编写soap应用。你看到的，就是一个个的com对象（符合微软的风格，符合一般程序员的编程习惯）。
一. 功能简介：
1． 提供了客户端的组件，可以让你指定wsdl，然后轻松调用对应的web service。
2． 提供了服务端的组件，可以让你指定wsdl、wsml和com对象，自动为你生成web service。
3． 还提供了底层的处理组件，可以让你操纵soap消息的具体创建、处理和传输的过程。
二. 几个概念：
wsdl(web services description language)：用于描述服务端所提供服务的xml格式。wsdl文件里，描述了服务端提供的服务，提供的调用方法，以及调用时所要遵循的格式，比如调用参数和返回值的格式等等。wsdl 很像com编程里的idl(interface description language)，是服务器与客户端之间的契约，双方必须按契约严格行事才能实现功能。
wsml(web services meta language): 用于描述wsdl里提供的方法与实现该方法的com对象之间的映射关系。该文件是microsoft的实现中特有的，不是soap标准的一部分。一般情况下，该文件只在服务端存在。
soap消息：客户端和服务端之间的方法调用请求和结果返回值都放在这些消息里，是xml格式的数据。
三. web service调用过程：
客户端：取得服务端的服务描述文件wsdl，解析该文件的内容，了解服务端的服务信息，以及调用方式。根据需要，生成恰当的soap请求消息（指定调用的方法，已经调用的参数），发往服务端。等待服务端返回的soap回应消息，解析得到返回值。
服务端：生成服务描述文件，以供客户端获取。接收客户端发来的soap请求消息，解析其中的方法调用和参数格式。根据wsdl和wsml的描述，调用相应的com对象来完成指定功能，并把返回值放入soap回应消息返回给用户。
四. 编程的两种模式
高层接口
使用高层接口，你不需要知道soap和xml的任何信息，就可以生成和使用一个webservice。soap toolkit 2.0通过提供两个com对象――soapclient和soapserver，来完成这些功能。
在客户端，你只需要生成一个soapclient实例，并用wsdl作为参数来调用其中的mssoapinit方法。soapclient对象会自动解析wsdl文件，并在内部生成所有web service的方法和参数信息。之后，你就可以像调用idispatch接口里的方法一样，调用里面所有的方法。在vb或是脚本语言里，你甚至可以直接在soapclient对象名后面直接加上.方法(参数…)进行调用。
在服务端，有两种处理模式。一种是生成asp文件；另一种是直接使用isapi扩展，让soap toolkit提供的dll来处理对wsdl的请求。
在第一种模式中，你需要在asp文件里创建soapserver对象，并用wsdl和wsml作为参数来调用init方法，soapserver在内部会自动建立相关的映射关系。然后，用asp的request和response对象作为参数调用soapinvoke方法。soapserver会自动从request里取得用户的soap请求消息，并解析，调用相应的com完成功能，把返回值封装成soap回应消息，通过response对象返回。
在第二种模式中，soap toolkit提供的isapi扩展会自动完成以上asp模式的全部操作。
两种模式的比较是，第一种比较灵活，但是速度比较慢。而第二种虽然灵活性没有了，但是性能却很高。所以，如果没有特殊都请使用isapi模式。
低层接口
要使用低层接口，你必须对soap和xml有所了解。你可以对soap的处理过程进行控制，特别是要做特殊处理的时候。
在客户端，首先要创建一个httpconnector对象，负责http连接。设定connector的一些头部信息，比如endpoinurl和soapaction等。如果网络连接需要使用代理服务器，那也要在这里设定相关的信息。接着创建soapserializer对象，用于生成soap消息。按照wsdl里定义，把所有参数按顺序序列化，得到一个完整的soap请求消息。该soap消息，作为payload通过httpconnector被发送到服务端。最后，生成一个soapreader对象，负责读取服务端返回的soap消息，取得其中的返回值。
在服务端，首先通过asp里的request和response对象取得http连接的输入与输出。接着创建soapreader对象，读取request对象里的soap请求消息，解析出要调用的方法和调用的参数， 执行实际的调用，并取得执行结果。最后，生成一个soapserializer对象，按照wsdl的描述，序列化执行结果，生成soap回应消息，通过response对象返回给客户端。
五. 疑问与解答
为什么要有wsml?
答：因为soap本身只是对象访问的协议，至于实现的方式并没有指定。一般来说，使用soap就是把现有系统的功能以标准的方式对外公开，让外部能够访问。而在微软的平台上，为了模块的互用性，功能的实现一般是以com的方式提供的。而如何能够把wsdl里描述的方法，映射到com的接口方法上，这就是wsml所要做的。现在你可以看到，使用wsml，你不需要做太多工作，就可以把现有的应用很快的变成web service应用。在服务端，你完全保留了microsoft的com/com+应用模式。（当然，wsml也不是必须的，如果你不需要使用com的方法映射。如果你不使用soap toolkit的高层接口，而使用底层接口。那就没有必要了。）
如何处理复杂的数据类型？
答：你可以自己实现一个自定义的类型映射com对象(custom type mapper)，并在wsml里进行指定。这样，soap toolkit在处理过程当中，会调用这个mapper对soap消息里的消息进行处理。比如要返回一个复杂数据，在服务端，toolkit要懂得如何把一个复杂数据类型序列化为xml节点。而在客户端，toolkit要懂得如何把xml节点重新表示为一个复杂的数据结构。
需要说明的是，这个映射对象(mapper)并不是必须的，只是为了使用的方便而使用。也就是说，双方只要严格遵循wsdl里描述的规范，就一定能够达到调用成功。而不管你客户和服务端是如何映射这个复杂数据类型的，是一个c结构体也好，是一个com对象也好，或是一个java的类也好，都是无关紧要的。
六. 关于soap toolkit的例子
toolkit自带的例子已经非常全面，解释了使用这个toolkit需要了解的各种调用方式。通过看微软提供的代码，并亲自运行一遍，就会对该soap toolkit有比较感性的认识了。
不过，需要提醒你的是，要能正确运行附带的例子，你必须安装有iis服务，并且还要根据要求创建虚拟目录和映射主机名。具体请参见sample页的安装说明(setup instructions)。
七. soap toolkit的两个工具
wsdl generator: 该工具是toolkit自带的，主要的功能就是可以把一个com对象作为一个web service发布，用于服务端的开发。
你只要指定了com对象以及要输出的接口函数，和发布的网址等信息，该工具就会自动生成对应的wsdl和wsml文件。你只要把wsdl和wsml拷贝到对应的虚拟目录下，一个web service就完成了----该工具避免了手动书写wsdl和wsml的麻烦，但是由于该版本还无法实现复杂数据类型的映射。所以如果有复杂数据类型的情况，你还是要手动修改的。
web service proxy wizard: 该工具是在toolkit之后才发布的，所以你需要单独下载(地址见附录)。该工具完成的功能正好与wsdl generator相反，是为一个wsdl文件生成相应的com访问对象，用于客户端的开发。
你只要指定要调用webservice的wsdl文件，该工具就会自动生成一个atl的com对象类(proxy对象)。而通过调用生成的proxy对象，就可以实现对web service的调用。而在这个proxy对象里，是通过调用soap toolkit的底层接口来完成整个的soap调用过程的。而且，由于生成的是一个vc的atl com object工程，你可以再进行修改，并要进行编译而生成最后的com对象。
使用web service proxy wizard的好处就是可以在web service的调用进行前期绑定，从而提高了调用效率。而且，其他的模块只需要调用这个proxy对象，就可以实现对web service的调用，而不用跟soap toolkit有任何的直接联系。对其他调用模块来说，proxy对象就是那个远端的web service，跟一般的本地调用没什么两样。
八. 结论：
以上，我们仅仅是对microsoft soap toolkit 2.0进行了概要介绍。要真正掌握，还需不断的实践。我们将在后续的文章中对如何实作进行详细介绍。
附录：
microsoft soap toolkit 2.0的下载地址：http://msdn.microsoft.com/downloads/default.asp?url=/code/sample.asp?url=/msdn-files/027/001/580/msdncompositedoc.xml
msdn上的soap专题：
http://msdn.microsoft.com/soap/
微软soapsdk的新闻组：http://msdn.microsoft.com/newsgroups/default.asp?url=/newsgroups/loadframes.asp?icp=msdn&slcid=us&newsgroup=microsoft.public.xml.soapsdk&frame=true
web service proxy wizard的下载地址：
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnvs600/html/webservproxwiz.asp?frame=true
vb web services proxy generator(在新闻组上发现的，没有经过测试)
http://www.vbxml.com/downloads/default.asp?id=v2001510204034
