用Visual C++建立SOAP客户端应用
发表:不详 阅读:次 关键字： 字体:[大 中 小]
Soap是一个在信息交换中使用得非常广泛的协议，使用方便，并直接可与HTTP, SMTP等其它协议一起工作。本文讨论如何使用Microsoft SOAP Tookit的C++来建立一个简单的SOAP客户端应用。
=========================================================
一、先决条件：
必须熟悉使用COM，特别要熟悉COM中的Smart Pointers。我通过导入方法将COM接口转换成Smart Pointers。系统必须安装了Microsoft SOAP Toolkit和Microsoft XML Parser。文末参考一节介绍如何下载工具箱。文末附件可下载本文源程序。
二、SOAP编程基础：
下面开始介绍一个简单SOAP应用中所包含的类。在此之前，必需先导入所需的类型库，然后程序才能够使用SOAP的类。
导入类型库：
SOAP中使用的对象和接口都在mssoap1.dll文件中。这个文件在安装Microsoft SOAP Toolkit 2.0时生成，存在路径："C:\Program Files\Common Files\MSSoap\Binaries\MSSOAP1.dll"。用#import将该文件导入到程序中。类型库的内容在导入时被转换成COM smart pointers来描述COM接口。因为SOAP完全依赖于XML，因此必需用Microsoft XML Parser来处理XML。Microsoft XML parser在msxml3.dll文件里。这个文件要在导入mssoap1.dll之前导入。
#import "msxml3.dll"
using namespace MSXML2;
#import "C:\Program Files\Common Files\MSSoap\Binaries\MSSOAP1.dll" \
exclude("IStream", "ISequentialStream", "_LARGE_INTEGER", \
"_ULARGE_INTEGER", "tagSTATSTG", "_FILETIME")
using namespace MSSOAPLib;
上面这些代码是编写SOAP程序必需包含的。
建立SOAP客户端应用有以下三步骤：
1- 指定和连接Web服务器。
2- 准备和发送消息。
3- 读取服务端返回的信息。
下面是在基本SOAP客户端要使用到的类：
1- SoapConnector:
在客户/服务模式下，首先要做的事就是连接服务器。SoapConnector类执行客户端与服务端之间的消息传送协议。 SoapConnector是一个抽象类，定义了协议执行的接口。事实上， SoapConnector类不定义执行某种特定的传送协议，例如：MSMQ, MQ Series, SMTP 和 TCP/IP等。 为简便起见，本文只说明使用HTTP传送协议，它是由Microsoft SOAP Toolkit 2.0中的HttpConnector 类来执行的。
SoapConnector类使用步骤如下：
a) 创建SoapConnector类对象：
ISoapConnectorPtr connector;
Connector.CreateInstance(__uuidof(HttpConnector));
b) 指定Web服务器地址：
指定服务器，要做二件事：选择HttpConnector的属性和相应的属性值。本文示例选用EndPointURL属性：
Connector->Property ["EndPointURL"] = "some url pointing to web service";
以下是属性选项说明(属性名是大小写敏感的)：
AuthPassword：客户口令
AuthUser：客户名
EndPointURL ：客户URL
ProxyPassword： 代理(proxy)口令
ProxyPort ：代理断口
ProxyServer ：代理服务器的IP地址或主机名
ProxyUser ：代理用户名
SoapAction：HTTP的抬头值。这个属性只使用于低级API。它将忽略SoapClient接口(高级API)中的ConnectorProperty属性 。
SSLClientCertificateName：指定使用Secure Sockets Layer (SSL)加密协议。语法如下：
[CURRENT_USER | LOCAL_MACHINE\[store-name\]]cert-name with the defaults being CURRENT_USER\MY (与Microsoft Internet Explorer用法相同)。
Timeout：HttpConnector的超时限制，以毫秒为单位。
UseProxy：定义是否使用代理(proxy)。缺省值为False。如果将这个属性为真(True)，又没有设置上面的ProxyServer值，代理服务器将使用IE里的代理服务器。此时HttpConnector将不理会IE的"Bypass Proxy"(绕道)设置。
UseSSL：定义是否使用SSL(True 或 False)。此值设置为真时，HttpConnector对象不管WSDL设置是HTTP或HTTPS都用SSL连接方式。若此值设置为非真，HttpConnector对象只在WSDL设置为HTTPS时才用SSL方式连接。
c) 与Web服务器连接：
Connector->Connect();
d) 指定动作：
Connector->Property ["SoapAction"] = "some uri";
e) 启动消息句柄：
必需在SoapSerializer(消息准备函数)之前先启动消息处理机制
Connector->BeginMessage();
在消息处理完毕之后，用EndMessage()函数将消息送往服务器。
.
.
[ 消息准备代码 ]
.
.
Connector->EndMessage();
以上就是与服务器连接的过程。下面介绍如何创建和准备消息。
SoapSerializer:
用于建立送往服务器的SOAP消息。在与服务器通讯之前，SoapSerializer对象必需先与SoapConnector对象连接。SoapSerializer的初始化函数将建立这个内部连接。初始化代入的参数是InputStream (数据流)：
// 创建SoapSerializer对象，并用InputSTream进行初始化。
ISoapSerializerPtr Serializer;
Serializer.CreateInstance(_uuidof(SoapSerializer));
Serializer->Init(_variant_t((IUnknown*)Connector->InputStream));
下面是SOAP请求代码：
<SOAP: Envelope xmlns:SOAP="soap namespace">
<SOAP:Body>
<m:someMethodName xmlns:m="some namespace">
<someParameter> someParameterValue </someParameter>
<m:someMethodName>
</SOAP:Body>
</SOAP: Envelope>
SOAP请求被安放在标记之中。<Envelope>是SOAP文件的主标记。SOAP信息通常都安放在”信封“(Envelope)里。信封里的<Body>标记中安放信息体，其中包含具体请求。在C++里，用相应的方法来解释这些标记并定义有关的值。
下面的代码说明如何使用这些方法：
Serializer->startEnvelope("SOAP","","");
// 开始处理SOAP消息。第一个参数是命名空间，缺省为SOAP-ENV。
// 第二个参数定义URI。第三个参数定义Serialzier->startBody("")函数的编码方式。
// 开始处理<Body>元素，第一个参数是URI的编码类型，缺省为NONE。
Serializer->startElement("someMethodName","","","m");
// 开始处理Body里的子元素。
// 第一个参数是元素名。第二个参数是URI。
// 第三个参数编码类型。第四个参数是元素的命名空间。
Serializer->WriteString("someParameterValue")
// 写入元素值
在上面的每个startXXX函数后都要又相应的endXXX函数来结尾。消息做完之后，连接器就调用endMessage()方法将消息发送到服务器。
至此，我们已经连接了服务器，制作了相应的消息。最后一个步骤就是接收服务器回应。
SoapReader:
读取服务器返回的信息，将信息解析之后装入DOM，为进一步处理所用。下面是服务器返回的SOAP回应信息：
<SOAP: Envelope xmlns:SOAP="soap namespace">
<SOAP:Body>
<m:someMethodNameResponse xmlns:m="some namespace">
<return> someResult </return>
<m:someMethodNameResponse>
</SOAP:Body>
</SOAP: Envelope>
使用OutputStream来读取SoapReader对象中的信息。(OutputStream接收服务器返回的信息)。
// 创建SOAPReader对象，并连接到outputstream
ISoapReaderPtr Reader;
Reader.CreateInstance(_uuidof(SoapReader));
Reader->Load(_variant_t((IUnknown*)Connector->OutputStream));
// load方法还可以用于加载XML文件或字符串
将回应信息加载到SoapReader对象之后，就可以用它的RPCResult属性来获取结果。不过，But RPCResult并不直接返回结果，它返回<Body>的第一个实体元素，然后用text属性读取该元素属性值：
Reader->RPCResult->text
三、举例说明一个简单的SOAP客户端应用：
本文示例用www.xmethods.net做服务器。这个服务器指向Yahoo在线信息。
可以在http://www.xmethods.net/ve2/ViewListing.po?serviceid=156找到有关细节。
下面的代码中要输入一个参数，即Yahoo的用户ID。返回结果为0表示离线，1表示在线。
其他细节可参阅：http://www.allesta.net:51110/webservices/wsdl/YahooUserPingService.xml
四、参考：
The SOAP specification Simple Object Access Protocol (SOAP) 1.1 - W3C Note ：
http://www.w3.org/TR/SOAP
Microsoft SOAP Toolkit Download ：
http://download.microsoft.com/download/xml/soap/2.0/w98nt42kme/EN-US/SoapToolkit20.exe
五：本文示例的SOAP代码：
#include <stdio.h>
#import "msxml3.dll"
using namespace MSXML2;
#import "C:\Program Files\Common Files\MSSoap\Binaries\MSSOAP1.dll" \
exclude("IStream", "ISequentialStream", "_LARGE_INTEGER", \
"_ULARGE_INTEGER", "tagSTATSTG", "_FILETIME")
using namespace MSSOAPLib;
void main()
{
CoInitialize(NULL);
ISoapSerializerPtr Serializer;
ISoapReaderPtr Reader;
ISoapConnectorPtr Connector;
// 连接服务器
Connector.CreateInstance(__uuidof(HttpConnector));
Connector->Property["EndPointURL"] = "http://www.allesta.net:51110/webservices/soapx4/isuseronline.php";
Connector->Connect();
// 启动消息机制
Connector->Property["SoapAction"] = "uri:allesta-YahooUserPing";
Connector->BeginMessage();
// 创建SoapSerializer对象
Serializer.CreateInstance(__uuidof(SoapSerializer));
// 与输入流连接
Serializer->Init(_variant_t((IUnknown*)Connector->InputStream));
// 制作SOAP信息
Serializer->startEnvelope("","","");
Serializer->startBody("");
Serializer->startElement("isuseronline
C++调用Web services的控制台应用程序
4星 · 超过85%的资源 需积分: 10 57 浏览量
2010-12-17
14:05:19
上传
评论
收藏 137KB RAR 举报 
调用Web Services的控制台应用程序.rar （13个子文件） 
WebWeather.dsp 4KB mssoap30.tlh 83KB mssoap30.tli 71KB WebWeather.ncb 449KB WebWeather.dsw 545B mainWeb.cpp 347B msxml4.tli 155KB ButterflyWEB.cpp 5KB
程序解释.txt 8KB WebWeather.plg 1KB WebWeather.opt 53KB ButterflyWEB.h 1KB msxml4.tlh 203KB资源评论
xgready2012-10-31非常不错，有程序也有说明。感谢分享！
softxmu2012-04-27可是正常使用，可以下来学习- qq2842774382015-11-05下来学习，还不错！
风一样的大叔2014-01-25可是正常使用，可以下来学习
feede2011-12-27断电压缩包损坏，重新下
zsz371849158
- 粉丝: 8
- 资源: 12
最新资源
- Win64OpenSSL-3-3-0.exe
- 课高分程设计-基于C++实现的民航飞行与地图简易管理系统-南京航空航天大学
- 航天器遥测数据故障检测系统python源码+文档说明+数据库(课程设计)
- 北京航空航天大学操作系统课设+ppt+实验报告
- 基于Vue+Echarts实现风力发电机中传感器的数据展示监控可视化系统+源代码+文档说明(高分课程设计)
- 基于单片机的风力发电机转速控制源码
- 基于C++实现的风力发电气动平衡监测系统+源代码+测量数据(高分课程设计)
- 毕业设计- 基于STM32F103C8T6 单片机，物联网技术的太阳能发电装置+源代码+文档说明+架构图+界面截图
- 基于 LSTM（长短期记忆）（即改进的循环神经网络）预测风力发电厂中风力涡轮机产生的功率+源代码+文档说明
- 基于stm32f103+空心杯电机+oled按键+运动算法
资源上传下载、课程学习等过程中有任何疑问或建议，欢迎提出宝贵意见哦~我们会及时处理！
点击此处反馈
