http://www.yesky.com/20020517/1611650.shtml
简介
在本篇文章中，我们将讨论如何使用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文件之前，我们还需要导入该文件，如下所示：
| #import "msxml3.dll"
using namespace MSXML2; #import "C:\Program Files\Common Files\MSSoap\Binaries\MSSOAP1.dll" \ |
上面是开发一个SOAP应用程序所必需包含的所有类定义。开发一个SOAP客户端应用程序需要三个步骤：
·指定并连接一个互联网服务。
·准备并发送消息。
·读取来自服务器的响应。
下面是我们用来开发一个基本的SOAP客户端应用程序所需要用到的类：
SoapConnector
在客户机/服务器模式中任何客户端应用程序需要作的第一件事就是与服务器进行连接。SoapConnector就是被用来实现客户机端、服务器端应用程序连接器的协议，它还充当定义实现其他协议接口的抽象类，也就是说，SOAP不仅仅局限于充当一种特定的协议。我们会发现，它的一些实现还支持MSMQ、MQ Series、SMTP和TCP/IPTransports。为了简单起见，我在这里只讨论它作为HTTP Transport的用途，这是由微软SOAP Toolkit 2.0中的HttpConnector类实现的。
使用SoapConnector类所需要的步骤
首先，创建SoapConnector类的一个对象：
| ISoapConnectorPtr connector; Connector.CreateInstance(__uuidof(HttpConnector)); |
然后，指定Web服务的地址。接下来，我们必须详细描述该Web服务。Web服务是由Property（HttpConnector的一个属性）指定的。在处理这一属性时有件事情需要指定：我们引用的哪个属性以及该属性的值。下面，我们使用EndPointURL属性指定Web服务：
| Connector-＞Property ["EndPointURL"] = "some url pointing to web service"; |
下面的表格提供了一个属性清单（属性的名字是大小写敏感的）
| 属性 | 描述 |
| AuthPassword | 端点认证用的口令。 |
| AuthUser | 端点认证用的用户名。 |
| EndPointURL | 端点的URL。 |
| ProxyPassword | 代理认证的口令。 |
| ProxyPort | 代理服务器使用的端口。 |
| ProxyServer | 代理服务器的主机名或IP地址。 |
| ProxyUser | 代理认证的用户名。 |
| SoapAction | HTTP头部中SoapAction中的值。这一属性只能从低级的API中设定，如果使用SoapClient接口中的ConnectorProperty属性（高级API）设置该属性，它就会被忽略。 |
| SSLClientCertificateName | 如果存在，则该字符串标明用于SSL协议中的客户端证书。其语法为： SSLClientCertificateName [CURRENT_USER | LOCAL_MACHINE\[store-name\]]证书名，其缺省的名字为 CURRENT_USER\MY。 |
| Timeout | HttpConnector的超时时间，这一时间是以毫秒计算的。 |
| UseProxy | 一个类型为布尔型的属性，表明是否使用代理服务器。缺省情况下，这一属性的值被设定为False，表明无需使用代理服务器。如果要使用代服务器，需要将该属性的值设置为True。如果将该属性的值设置为True， 而又没有设置ProxyServer属性，HttpConnector将使用IE中设置的代理服器。HttpConnector会忽略IE中的“不使用代理服务器”设置。 |
| UseSSL | 表明是否使用了SSL的布尔型值。如果该属性被设置为True，则无论WSDL中是否指定了HTTP或HTTPS，HttpConnector对象都使用SSL连接。 如果该属性的值被设置为False，则只有在WSDL中指定了HTTPS的情况下， HttpConnector对象才会使用SSL连接。 |
其次，我们需要与Web服务连接。HttpConnector类的Connect方法用来初始化SoapConnector对象和准备与Web服务的连接。
Connector-＞Connect();
在与服务器连接后，我们需要指定Web服务完成的操作。为了指定该操作，我们需要再次使用SoapConnector的Property属性：
| Connector-＞Property ["SoapAction"] = "some uri"; |
在完成与Web服务的连接和其他的细节后，我们就可以调用向服务器发送SOAP信息的方法了，必须在调用SoapSerializer的其他方法之前调用该方法：
| Connector-＞BeginMessage(); |
在完成与信息相关的操作后，我们必须调用EndMessage()函数，将消息真正地发给Web服务。
| . . [ 消息准备代码 ] . . Connector-＞EndMessage(); |
上面的步骤就是完成与Web服务的实际连接所必需的操作。在下面的部分，我们将讨论如何创建和准备一个信息。
使用SoapConnector类所需要的步骤
首先，创建SoapConnector类的一个对象：
| ISoapConnectorPtr connector; Connector.CreateInstance(__uuidof(HttpConnector)); |
然后，指定Web服务的地址。接下来，我们必须详细描述该Web服务。Web服务是由Property（HttpConnector的一个属性）指定的。在处理这一属性时有件事情需要指定：我们引用的哪个属性以及该属性的值。下面，我们使用EndPointURL属性指定Web服务：
| Connector-＞Property ["EndPointURL"] = "some url pointing to web service"; |
下面的表格提供了一个属性清单（属性的名字是大小写敏感的）
| 属性 | 描述 |
| AuthPassword | 端点认证用的口令。 |
| AuthUser | 端点认证用的用户名。 |
| EndPointURL | 端点的URL。 |
| ProxyPassword | 代理认证的口令。 |
| ProxyPort | 代理服务器使用的端口。 |
| ProxyServer | 代理服务器的主机名或IP地址。 |
| ProxyUser | 代理认证的用户名。 |
| SoapAction | HTTP头部中SoapAction中的值。这一属性只能从低级的API中设定，如果使用SoapClient接口中的ConnectorProperty属性（高级API）设置该属性，它就会被忽略。 |
| SSLClientCertificateName | 如果存在，则该字符串标明用于SSL协议中的客户端证书。其语法为： SSLClientCertificateName [CURRENT_USER | LOCAL_MACHINE\[store-name\]]证书名，其缺省的名字为 CURRENT_USER\MY。 |
| Timeout | HttpConnector的超时时间，这一时间是以毫秒计算的。 |
| UseProxy | 一个类型为布尔型的属性，表明是否使用代理服务器。缺省情况下，这一属性的值被设定为False，表明无需使用代理服务器。如果要使用代服务器，需要将该属性的值设置为True。如果将该属性的值设置为True， 而又没有设置ProxyServer属性，HttpConnector将使用IE中设置的代理服器。HttpConnector会忽略IE中的“不使用代理服务器”设置。 |
| UseSSL | 表明是否使用了SSL的布尔型值。如果该属性被设置为True，则无论WSDL中是否指定了HTTP或HTTPS，HttpConnector对象都使用SSL连接。 如果该属性的值被设置为False，则只有在WSDL中指定了HTTPS的情况下， HttpConnector对象才会使用SSL连接。 |
其次，我们需要与Web服务连接。HttpConnector类的Connect方法用来初始化SoapConnector对象和准备与Web服务的连接。
Connector-＞Connect();
在与服务器连接后，我们需要指定Web服务完成的操作。为了指定该操作，我们需要再次使用SoapConnector的Property属性：
| Connector-＞Property ["SoapAction"] = "some uri"; |
在完成与Web服务的连接和其他的细节后，我们就可以调用向服务器发送SOAP信息的方法了，必须在调用SoapSerializer的其他方法之前调用该方法：
| Connector-＞BeginMessage(); |
在完成与信息相关的操作后，我们必须调用EndMessage()函数，将消息真正地发给Web服务。
| . . [ 消息准备代码 ] . . Connector-＞EndMessage(); |
上面的步骤就是完成与Web服务的实际连接所必需的操作。在下面的部分，我们将讨论如何创建和准备一个信息。
