Microsoft SOAP Toolkit 2.0介绍 (转)

固然对于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.xmlmsdn上的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=trueweb service proxy wizard的载入地方：http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnvs600/html/webservproxwiz.asp?frame=truevb web services proxy generator(在消息组上创造的，没有过程尝试)http://www.vbxml.com/downloads/default.asp?id=v2001510204034