[gSOAP]MFC调用WEBService

gSOAP编译工具提供了一个SOAP/XML 关于C/C++ 语言的实现，从而让C/C++语言开发web服务或客户端程序的工作变得轻松了很多。

gSOAP官网：点击打开链接

我现在只想说：gSOAP就是个傻瓜相机——非常好用！

本文介绍如何利用gSOAP，达到在MFC下调用WEBService的API的目的。仅客户端。

工具&环境：

0、WIN XP
1、VC6
2、gSOAP 2.8.17（官方下载地址）
3、一个目标（一个WEBService，一般以WSDL结尾，如果是asmx结尾的，在URL后面加上“?wsdl”）

步骤：

1、下载好gSOAP后，解压。在解压后的文件夹里打开gsoap-2.8\gsoap\bin\win32，可以看见2个exe文件。

（当然在bin文件夹内你还能看到macosx、linux386，为什么我要进入win32呢?因为擦屁!）

2、打开cmd.exe（什么?cmd怎么打开?乖，洗洗睡吧）。将路径设置到gsoap-2.8\gsoap\bin\win32。

3、
（1）输入命令：wsdl2h -s -o MLGB.h XXXXXXXXXXXXXXXXXXXXXX。说明，wsdl2h就是那个exe之一，-s、-o都是参数。-s代表不使用STL，取而代之需要在工程中包含stdsoap2.h和stdsoap2.cpp。-o file代表指定输出文件名称。-t 文件名，指定type map文件，默认为typemap.dat。还有很多参数，自己输入“?”问号查看。XXXXXXXXXXX就是你的URL。成功后在win32文件夹里多了个MLGB.h文件。

（2）输入命令：soapcpp2 -i -C MLGB.h。说明，soapcpp2就是另外那个exe，-i代表使用Proxy ，-C代表生成客户端代码。注意大小写。有的童鞋可能遇到了问题，提示找不到文件？在gsoap文件夹里找import文件夹（我的是C:\gsoap-2.8\gsoap\import），在刚才的命令后面加上“-I XXXX”，XXXX是你的import文件夹路径，绝对路径。成功后在win32文件夹里多了一大波文件。好吧，很头疼，其实不需要这么多，再输入“del *.xml”，回车~~~~世界都清静了。

（3）介个时候，回到win32文件夹，比起第一步时，应该又多了soapStub.h、soapH.h、soapC.cpp、soapXXXXSoapProxy.h、soapXXXXSoapProxy.cpp、XXXXSoap.nsmap、soapClient.cpp。XXXX是啥，这不是你决定的，由那个URL指向的服务器名决定（我的叫ADReportWebService1）。刚说的这个几个文件，除了soapClient.cpp全部拷贝出来，放到你的工程目录下。

（4）用VC6新建一个MFC的EXE工程，不要包含SOCKET因为gSOAP已经包含了。这里就是工程目录。文件管理中加入拷过来的所有H、CPP文件。就像这样

修改所有的、你加进来的4个CPP文件，在开头增加，

#include "stdafx.h"

在stdsoap2.cpp里还要加

#include "XXXXSoap.nsmap"

将整个工程里以下代码删除

#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif

（5）在你要用的头文件H里加入

#include "soapXXXXSoapProxy.h"

在CPP文件里这样使用

//此处我的API函数原型:string UserCheck(string logid, string password)
//gSOAP生成了XXXXSoapProxy::UserCheck()，参数略去未写。一般的使用是2个参数，第一个是原函数的输入值，第二个是原函数的返回值，此处都为引用传参。
//gSOAP根据该函数生成2个类，
//_ns1__UserCheck，该函数的参数
//_ns1__UserCheckResponse，该函数的返回值
//UserCheck函数使用如下：
	XXXXSoapProxy ClientSoap;					//XXXXSoapProxy 就是你的类名
	_ns1__UserCheck userCheckReq;
	_ns1__UserCheckResponse userCheckRer;
	userCheckReq.logid = "QN";					//给传入参数赋值
	userCheckReq.password = "MLGB";					//赋值
	if (SOAP_OK == ClientSoap.UserCheck(&userCheckReq, &userCheckRer))
	{
		CString strResult = userCheckRer.UserCheckResult;	//NB你成功了！userCheckRer.UserCheckResult里保存的就是返回值
	}

如果你还遇到了soap_send的错误，把类似

soap_send(soap_encode_url_string(soap, strLogid)

的地方改为

soap_send(soap, soap_encode_url_string(soap, strLogid)

解决中文乱码

参考资料： gsoap中文乱码及内存清理等问题的解决方案

一、问题和分析

gsoap在调用Webservice过程中，如果字符串中有汉字，很容易出现乱码。 由于网络间一般用UTF8表示字串（ANSI字串- (char < 128)本身已经符合UTF8编码规则），所以ANSI字符不会乱码，而一个汉字的传统表示需要两个字符，而在wchar_t宽字符串中只需一个字符表示。

一个汉字用UTF8表示通常占用3个BYTE, 如：
         你  --〉0xe4, 0xbd, 0xa0
         好  --> 0xe5, 0xbd, 0x21

gSoap在封装XML包时，在进行utf8字符转换时：
   1）如果入口参数为 char* / std::string (即用多字节表示汉字)时，汉字因为已经用2个字节（窄字符）表示，此时的UTF8编码已近不是对该汉字的码值编码，而是对组成该汉字的两个字符进行utf8编码，结果自然不对了。因此乱码。
                    UTF8(0xAABB)   !=  UTF8(0XAA + 0XBB)
   2）如果入口参数为 wchar_t* / std:wstring(即一个汉字用一个字符表示）时，汉字因为用1个宽字符表示（两个字节），因此UTF8转换没有问题。
 
gSoap在解包时，因为来源字符串已经用UTF8表示，因此在gsoap的response中，用std::string/char*,道理上，在转换到当前字符集，应该不会乱码。

二、解决方案

很简单，在gsoap的数据类型中，用wchar_t* 或std::wstring代替std:string/char*.
由于gsoap的调用代码是自动生成的，如何办？我们需要在生成gSoap调用代码时，强制使用wchar_t*/std::wstring. 我们可以修改default类型转换文件或者强制使用某个类型转换文件。在mytypema.dat(拷贝自typemap.dat)里写
    xsd__string = | std::wstring | wchar_t*    # 注释符号为#
 那么SOAP/XML中的string将转换成std::wstring或wchar_t*，这样能更好地支持中文。

然后将步骤3（1）的
wsdl2h -s -o MLGB.h XXXXXXXXXXXXXXXXXXXXXX
改为
wsdl2h -s -o MLGB.h -t mytypemap.dat XXXXXXXXXXXXXXXXXXXXXX