Jiang's C++ Space

创作,也是一种学习的过程。

   :: 首页 :: 新随笔 :: 联系 :: 聚合  :: 管理 ::

gSOAP是很好的东西,它弥补了C++库对Webservice支持的不足,让C++的开发者能够轻松使用Webservice,不过说轻松其实也不轻松,到目前为止,我没有用过什么开源的库是一到手就能很顺利地使用的,总是经过了这个那个的折腾,最后才能用,虽然很多问题也都是只差那么一丁点儿,但就是那么一丁点儿却让人焦头烂额。

Windows Mobile没落了……我不止一次提起这话,我甚至怀疑我现在开发的Windows Mobile程序是不是最后一个获得较多用户的Windows Mobile程序,也许弄完了这个之后,也没什么人再会涉足这个领域了。

ASMX接口定义文件

OK,废话不说了,言归正传,Webservice最最最典型的应用是什么?——更新天气,你看看Webservice的入门文章,都是拿天气更新作为范例,而我做的这个正好也是一个天气更新,接口是我定义的,具体就不贴出来了,总而言之我们要从WSDL这个接口文件出发,假设你已经有了这个WSDL文件了,文件名为“SSPWeatherService.asmx”。(不懂WSDL的话建议先了解下Webservice)

获取一份gSOAP并安装

接着要去获取一份gSOAP的代码,地址是gsoap2.sourceforge.net,我下载的版本是2.8.3,这是2011年6月更新的,在这前我下载了2.8.2,这两个版本用起来还有些微小的差别,哪个更好?当然是新的更好了。

下载完之后当然是解压缩,我是把它解压缩到“D:\gsoap”这个路径下。然后给系统环境变量“path”增加这么一个路径:“D:\gsoap\gsoap\bin\win32\”,这完全是为了一会儿方便调用到“wsdl2h.exe”和“soapcpp2.exe”,否则你还得输入exe的完整路径。

根据asmx生成相关文件

将刚才那个WSDL文件“SSPWeatherService.asmx”放到你的工作目录下,比如“D:\work\SSPWeatherUpdate_WS”,然后使用命令行工具,如下执行:

其中涉及到两个命令:
>wsdl2h SSPWeatherService.asmx -o SSPWeatherService.h
>soapcpp2 SSPWeatherService.h -ID:\gsoap\gsoap\import -C -x -i
第一个命令是根据WSDL文件生成相应的头文件,用-o参数指定生成的头文件的名称。
第二个命令死根据刚生成的头文件来生成别的头文件和cpp文件。-I后面是gSOAP的import目录的路径,这个是必须的,-C表示只生成客户端代码,这正是我们需要的,-x可以少生成一些垃圾,-i表示生成C++封装代码,用C++封装好的代码比纯C代码好用多了。

对生成内容的简单说明

接下来你查看目录中的文件可能是这样:
soapC.cpp
soapH.h
soapSSPWeatherServiceSoapProxy.cpp
soapSSPWeatherServiceSoapProxy.h
soapStub.h
SSPWeatherService.asmx
SSPWeatherService.h
SSPWeatherServiceSoap.nsmap
也就是说,除了asmx和第一步生成的h文件之外,之后生成的文件有这些:
soapC.cpp
soapH.h
soapSSPWeatherServiceSoapProxy.cpp
soapSSPWeatherServiceSoapProxy.h
soapStub.h
SSPWeatherServiceSoap.nsmap
可能你还会碰到下面这几个文件,这跟你原本的asmx的接口定义有关系:
soapSSPWeatherServiceSoap12Proxy.cpp
soapSSPWeatherServiceSoap12Proxy.h
SSPWeatherServiceSoap12.nsmap
“12”表示soap的1.2版本,你比较一下,发现这几个文件跟上面提到的几个文件的内容是几乎一致的,除了里面的名称大多都加上了“12”,对我来说这几个文件是不需要的,所以删除掉了。

创建一个工程

接下去当然是用Visual Studio创建一个工程来使用刚才生成的这些文件了。我创建的Project名称为“SSPWeatherUpdate_WS”,目录也是刚才的那个目录,为了简单起见,创建一个console类型的程序用来测试就行了。

然后把刚才生成的这些文件添加到这个Project中去:
soapC.cpp
soapH.h
soapSSPWeatherServiceSoapProxy.cpp
soapSSPWeatherServiceSoapProxy.h
soapStub.h
SSPWeatherService.h
也许你注意到了,asmx和nsmap文件是不需要添加的。

然后是很关键的一部,把D:\gsoap\gsoap目录下的stdsoap2.h和stdsoap2.cpp复制到刚创建的工程目录并添加到工程中去。完了之后Project里应该有这些东西:

编译以及可能的问题

编译一下看看,能不能通过。可能出现了一大堆的错误,可能你会看到这样的出错提示:
“1>.\soapC.cpp(16) : warning C4627: '#include "soapH.h"': skipped when looking for precompiled header use”
这是因为工程设置了使用“预编译头”,我们不要使用预编译头,工程属性设置如下图:

设置后rebuild,看看还有没有什么问题?在我这里出现了这样的错误提示:
1>.\soapC.cpp(850) : error C3861: 'soap_outdateTime': identifier not found
1>.\soapC.cpp(855) : error C3861: 'soap_indateTime': identifier not found
表面上看是漏掉某个头文件,或者某个编译选项不正确引起,但其实,这正是让我郁闷了好久,努力了好久,最后才发现无解的问题,其中波折就不想在这里赘述了,如果你认为自己技术水平不错,可以直接摆平这个问题的话不妨尝试一下看,但如果时间不是很多的话我劝你就算了,直接采纳我这个结论:gSOAP在WM环境下不支持WSDL中的datetime类型!我不知道这算不算bug,可能准确说“支持不佳”,如果前面的asmx是你定义的话,你就改一改,把其中的datetime类型改为string,然后自己在程序中再作转换,如果asmx不是你定义的话,那就很不幸了,我也没辙了,修改gSOAP的代码是很痛苦的工作,我费了很大力气最后都没解决,如果你有能力解决,不妨跟我分享一下。

使用Webservice

我直接贴上我的完整代码,希望能够抛砖引玉。

#include "stdafx.h"
#include 
<string>
#include 
"soapSSPWeatherServiceSoapProxy.h"
#include 
"SSPWeatherServiceSoap.nsmap"

using namespace std;

BOOL UTF8ToTChar(
const char* pUTF8Str, TCHAR* &pTChar)
{
 
//First, convert it to UNICODE
 INT len = MultiByteToWideChar(CP_UTF8, 0, pUTF8Str, -1, NULL, 0);
 WCHAR 
*pWC = new WCHAR[len];
 MultiByteToWideChar(CP_UTF8, 
0, pUTF8Str, -1, pWC, len);
 pWC[len
-1= '\0';

 
//Second, convert UNICODE to TCHAR
#ifdef UNICODE
 pTChar 
= pWC;
#else
 len 
= WideCharToMultiByte(CP_ACP, 0, pWC, -1, NULL, 0, NULL, NULL);
 pTChar 
= new TCHAR[len];
 WideCharToMultiByte(CP_ACP, 
0, pWC, -1, pTChar, len, NULL, NULL);
 pTChar[len
-1= '\0';
 delete[] pWC;
#endif

 
return TRUE;
}

BOOL TCharToUTF8(
const TCHAR* pTChar, char* &pUTF8Str)
{
 INT len;
#ifdef UNICODE
 
const WCHAR* pWC = pTChar;
#else
 len 
= MultiByteToWideChar(CP_ACP, 0, pTChar, -1, NULL, 0);
 WCHAR 
*pWC = new WCHAR[len];
 MultiByteToWideChar(CP_ACP, 
0, pTChar, -1, pWC, len);
 pWC[len
-1= '\0';
#endif
 len 
= WideCharToMultiByte(CP_UTF8, 0, pTChar, -1, NULL, 0, NULL, NULL);
 pUTF8Str 
= new char[len];
 WideCharToMultiByte(CP_UTF8, 
0, pTChar, -1, pUTF8Str, len, NULL, NULL);
 pUTF8Str[len
-1= '\0';
#ifdef UNICODE
 
//
#else
 delete[] pWC;
#endif
 
return TRUE;
}

void ReleaseChar(char* &pChar)
{
 
if(pChar!=NULL)
 {
  delete[] pChar;
  pChar 
= NULL;
 }
}

void ReleaseTChar(TCHAR* &pTChar)
{
 
if(pTChar!=NULL)
 {
  delete[] pTChar;
  pTChar 
= NULL;
 }
}

#define OUTPUT_BUFF_LEN 512 
void DbgStrOut(const TCHAR *fmt, 

 TCHAR szOutStr[OUTPUT_BUFF_LEN]; 

 va_list ap; 
 va_start(ap, fmt); 
 StringCbVPrintf(szOutStr, OUTPUT_BUFF_LEN, fmt, ap); 
 va_end(ap); 

 OutputDebugString(szOutStr); 
}

int _tmain(int argc, _TCHAR* argv[])
{

 SSPWeatherServiceSoapProxy gs(SOAP_C_UTFSTRING);
 gs.soap_endpoint 
= "http://www.sosopi.com/weathercastservice/SSPWeatherService.asmx";

 _ns1__FindCityByString input;
 _ns1__FindCityByStringResponse output;
 CHAR
* pszUTF8;
 TCHAR
* pszCityCode;
 TCHAR
* pszCityName;
 TCharToUTF8(L
"闵行", pszUTF8);
 input.CityToFind 
= pszUTF8;
 ReleaseChar(pszUTF8);
 
if(SOAP_OK==gs.FindCityByString(&input, &output))
 {
  std::vector
<ns1__CityInfo * >::iterator it = output.CityInfo.begin();
  
while (it!=output.CityInfo.end())
  {
   ns1__CityInfo 
*pCityInfo = (*it);

   UTF8ToTChar(pCityInfo
->CityCode.c_str(), pszCityCode);
   UTF8ToTChar(pCityInfo
->CityName.c_str(), pszCityName);
   DbgStrOut(L
"%s %s\n", pszCityCode, pszCityName);
   ReleaseTChar(pszCityCode);
   ReleaseTChar(pszCityName);
   
++it;
  }
  
  
if(output.MatchCityNumber>=1)
  {
   _ns1__GetWeatherByCityCode input2;
   _ns1__GetWeatherByCityCodeResponse output2;
   input2.CityCode 
= output.CityInfo[0]->CityCode;
   
if(SOAP_OK==gs.GetWeatherByCityCode(&input2, &output2))
   {
    TCHAR
* pszUpdateTime;
    
float fRtTemperature;
    TCHAR
* pszWindDirection;
    TCHAR
* pszWindForce;

    UTF8ToTChar(output2.WeatherCast
->UpdateTime.c_str(), pszUpdateTime);
    fRtTemperature 
= output2.WeatherCast->RtTemperature;
    UTF8ToTChar(output2.WeatherCast
->RtWindDirection.c_str(), pszWindDirection);
    UTF8ToTChar(output2.WeatherCast
->RtWindForce.c_str(), pszWindForce);
    
    DbgStrOut(L
"Update Time : %s\n", pszUpdateTime);
    DbgStrOut(L
"Temperature : %.1f\n", fRtTemperature);
    DbgStrOut(L
"Wind Direction : %s\n", pszWindDirection);
    DbgStrOut(L
"Wind Force : %s\n", pszWindForce);

    ReleaseTChar(pszUpdateTime);
    ReleaseTChar(pszWindDirection);
    ReleaseTChar(pszWindForce);

    ns1__ArrayOfOneDayWeather 
*pOneDay = output2.WeatherCast->DayWeather;
    std::vector
<class ns1__OneDayWeather * >::iterator itDW = pOneDay->OneDayWeather.begin();
    
//std::vector<ns1__CityInfo * >::iterator it = output.CityInfo.begin();
    while (itDW!=pOneDay->OneDayWeather.end())
    {
     DbgStrOut(L
"##########\n");
     ns1__OneDayWeather 
*pDayWeather = *itDW;
     DbgStrOut(L
"\tDay temp : %.1f\n", pDayWeather->DtTemperature);
     DbgStrOut(L
"\tDay weather : %d\n", pDayWeather->DtWeatherID);
     TCHAR
* pszDayWindDirection;
     TCHAR
* pszDayWindForce;
     UTF8ToTChar(pDayWeather
->DtWindDirection.c_str(), pszDayWindDirection);
     UTF8ToTChar(pDayWeather
->DtWindForce.c_str(), pszDayWindForce);
     DbgStrOut(L
"\tDay Wind Direction : %s\n ", pszDayWindDirection);
     DbgStrOut(L
"\tDay Wind Force : %s\n", pszDayWindForce);
     ReleaseTChar(pszDayWindDirection);
     ReleaseTChar(pszDayWindForce);

     DbgStrOut(L
"\tNight temp : %.1f\n", pDayWeather->NtTemperature);
     DbgStrOut(L
"\tNight weather : %d\n", pDayWeather->NtWeatherID);
     TCHAR
* pszNightWindDirection;
     TCHAR
* pszNightWindForce;
     UTF8ToTChar(pDayWeather
->NtWindDirection.c_str(), pszNightWindDirection);
     UTF8ToTChar(pDayWeather
->NtWindForce.c_str(), pszNightWindForce);
     DbgStrOut(L
"\tNight Wind Direction : %s\n ", pszNightWindDirection);
     DbgStrOut(L
"\tNight Wind Force : %s\n", pszNightWindForce);
     ReleaseTChar(pszNightWindDirection);
     ReleaseTChar(pszNightWindForce);
     
++itDW;
    }
   }
  }
 }
 
return 0;
}

代码说明

使用Webservice的过程中,我通过查找“闵行”来找到我的城市,再根据城市ID来获取天气,其实代码并不多,多在字符编码转换和Debug输出这部分,因为我们的XML使用UTF-8编码,而我们的软件界面通常使用Unicode编码,所以得转换,英文的情况下不转换是没什么问题的,但汉字一定得转,否则就是乱码了。

另外特别注意这个地方:
 SSPWeatherServiceSoapProxy gs(SOAP_C_UTFSTRING);
 gs.soap_endpoint = "http://www.sosopi.com/weathercastservice/SSPWeatherService.asmx";
SOAP_C_UTFSTRING,这个是用来指定UTF-8编码的,一定不能少,下面这个soap_endpoint参数则用来指明这个Webservice的服务地址。

可能的问题以及解决方案

1,超时

程序发布之后有人反映不能使用,Windows Mobile如果用电脑直连的话就没任何问题,但如果用GPRS上网的话还真的可能出现失败的情况,我认为这是因为GPRS速度太慢(用起来感觉还不如以前56K猫拨号上网)导致超时的缘故。可以通过下面办法来解决:
 pGS.accept_timeout = 30;
 pGS.connect_timeout = 30;
 pGS.recv_timeout = 30;
 pGS.send_timeout = 30;
 pGS.linger_time = 30;

2,无法用WAP方式更新

许多人用手机上网的时候都喜欢用WAP方式,就是那种用代理服务器的方式,移动的接入点叫cmwap,联通的叫uniwap,代理的地址是“10.0.0.172”。由于连接用了代理,gSOAP也得显示指定一个代理,方法如下:
pGS->proxy_host = “10.0.0.172”;
pGS->proxy_port = 80;
可能不一定是“10.0.0.172”,端口也可能不是80,这两个信息可以通过连接管理器相关的API来获得,具体就不展开了,提示一下,用这个:ConnMgrProviderMessage。

我不知道还有什么疑难杂症,这篇文章也无法囊括所有内容,大家只能见招拆招了。

posted on 2011-08-02 13:57 Jiang Guogang 阅读(2858) 评论(1)  编辑 收藏 引用

评论

# re: gSOAP在Windows Mobile平台上的使用总结 2011-08-02 16:11 乐购网
看得我挺糊里糊涂的。  回复  更多评论
  


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理