使用Visual C++开发SOAP客户端应用

转自 http://www.itjj.net/tech/biancheng/VC/20060814/42823.html

简介

　　在本篇文章中，我们将讨论如何使用Visual C++开发一个简单的SOAP客户端应用程序，我们还将介绍SOAP API的使用。SOAP是互联网上一种非常流行的交换信息用的协议，由于是为了与HTTP、SMTP和其他的类似协议协同工作的，因此它十分简单。用它描述的信息能够被轻易地通过互联网发送到另外的计算机上，而无需担心遭到防火墙等网络安全技术的拦截。

　　在这里，我们假设读者已经对SOAP协议有了一定的理解，而且对C++比较精通。如果读者对SOAP还不熟悉，可以查看相关的资料。我们还假设读者熟悉COM的使用，特别是COM中的智能指针，因为在这篇文章中，我们将使用导入命令将COM接口转换为智能指针。另外，读者还需要安装了微软的SOAP工具包。

　　SOAP编程基础

　　我们将以介绍一个与基本的SOAP应用程序有关的类开始我们的SOAP编程之旅。然而，我们还必须首先导入必需的类型库，我们的应用程序才能使用SOAP类。

　　导入类型库

　　SOAP中使用的所有对象和接口都包含在mssoap1.dll中，这个文件包含在Microsoft SOAP Toolkit 2.0中。我们可以在C:/Program Files/Common Files/MSSoap/Binaries/MSSOAP1.dll中发现该文件。使用#import命令就可以将该文件导入到我们的源文件中。类库文件中的内容将被转换为描述了COM接口的COM智能指针。

　　SOAP使用XML作为其数据格式，因此我们还需要微软的XML Parser来处理XML内容，它包含在msxml3.dll中。在导入mssoap1.dll文件之前，我们还需要导入该文件，如下所示：

　　上面是开发一个SOAP应用程序所必需包含的所有类定义。开发一个SOAP客户端应用程序需要三个步骤：

　　　·指定并连接一个互联网服务。

　　　·准备并发送消息。

　　　·读取来自服务器的响应。

　　下面是我们用来开发一个基本的SOAP客户端应用程序所需要用到的类：

　　　　SoapConnector

　　在客户机/服务器模式中任何客户端应用程序需要作的第一件事就是与服务器进行连接。SoapConnector就是被用来实现客户机端、服务器端应用程序连接器的协议，它还充当定义实现其他协议接口的抽象类，也就是说，SOAP不仅仅局限于充当一种特定的协议。我们会发现，它的一些实现还支持MSMQ、MQ Series、SMTP和TCP/IPTransports。为了简单起见，我在这里只讨论它作为HTTP Transport的用途，这是由微软SOAP Toolkit 2.0中的HttpConnector类实现的。

使用SoapConnector类所需要的步骤

　　首先，创建SoapConnector类的一个对象：

 

　　然后，指定Web服务的地址。接下来，我们必须详细描述该Web服务。Web服务是由Property（HttpConnector的一个属性）指定的。在处理这一属性时有件事情需要指定：我们引用的哪个属性以及该属性的值。下面，我们使用EndPointURL属性指定Web服务：

　　下面的表格提供了一个属性清单（属性的名字是大小写敏感的）

　　其次，我们需要与Web服务连接。HttpConnector类的Connect方法用来初始化SoapConnector对象和准备与Web服务的连接。

　　　Connector-＞Connect();

　　在与服务器连接后，我们需要指定Web服务完成的操作。为了指定该操作，我们需要再次使用SoapConnector的Property属性：

　　在完成与Web服务的连接和其他的细节后，我们就可以调用向服务器发送SOAP信息的方法了，必须在调用SoapSerializer的其他方法之前调用该方法：

　　在完成与信息相关的操作后，我们必须调用EndMessage()函数，将消息真正地发给Web服务。

　　上面的步骤就是完成与Web服务的实际连接所必需的操作。在下面的部分，我们将讨论如何创建和准备一个信息。 1 3

 

SoapSerializer

　　SoapSerializer对象用来构建一个向Web服务发送的SOAP消息。在与服务器连接前，SoapSerializer对象必须与SoapConnector对象连接。为了使这二个对象相互连接，我们需要调用SoapSerializer对象的Init方法，该方法需要一个参数InputStream（向服务器发送数据的流）：

　　在讨论SoapSerializer的其他函数以前，我们来看一个SOAP请求的例子：

　　SOAP请求被封装在了标记中。＜Envelope＞标记是该SOAP文档的主标记，SOAP消息通常都被封装在＜Envelope＞元素中，＜Envelope＞元素包含一个由＜Body＞标记指定的消息体，该消息体包含着实际的请求。在C++中，有非常合适的方法可以创建这些标记并指定其值。下面的代码说明了如何利用这些方法：

　　上面以startXXX开头的函数都相应地有以endXXX开头、结束元素的函数。在完成消息后，系统会调用连接的endMessage()方法，真正开始向服务发送消息。

　　现在我们已经与服务相连接，准备好了我们的请求，并将它发送给了服务。最后一个步骤就是读取来自服务器的响应。下面我们就来讨论这一问题。

　　SoapReader

　　该对象读取来自Web服务的响应，并将它解析为DOM，以备进一步处理之用。下面是一个来自Web服务的响应的例子：

　　在调用任何方法获取结果前，我们联接OutputStream，读取存储在SoapReader对象中的响应（OutputStream用于接收来自Web服务的数据）：

　　在将Web服务的响应加载到SoapReader对象后，我们可以通过调用SoapReader对象的RPCResult属性获得相应的结果，但RPCResult并不返回真正的结果，它返回的是＜Body＞元素中第一个条目的第一个子元素。我们可以通过调用text属性返回真正的结果：

　　一个SOAP客户端应用程序的例子

　　为了说明如何使用本篇文章中讨论的SOAP类，我们使用了http://www.xmethods.net/上列出的一项服务，该服务能够显示用户是否正在使用Yahoo Messenger。它只需要一个参数，即Yahoo用户的登录ID。返回的结果是一个布尔型值，0表示用户不在线，1表示用户在线。

　　我一直认为，学习某种编程技术的最好的方法就是实地学习源代码，在这里，我们就采取这种方法。下面是使用SOAP调用发现Yahoo用户是否在线的一个控制台应用程序的C++代码：

　　我们可以看到，代码十分简单，即使没有使用过C++，我保证读者也能够理解上面代码的作用：首先，它与远程服务器连接；其次，它创建SOAP消息并向web服务发送该消息；最后，读取服务器的响应，并使用printf将它输出到屏幕上。

　　结论

　　在本篇文章中，我们讨论了如何使用Visual C++建立一个简单的SOAP客户端应用程序。我们还学习了SOAP Toolkit中的几个方法以及如何使用SOAP从服务器获取数据。希望通过本篇文章，使读者能够掌握如何使用C++开发SOAP客户端应用程序。