首先需要下載一個gSOAP工具包 下載路徑為:https://sourceforge.NET/projects/gsoap2/
至於有關於gSOAP的一些用法和包含的文件的說明可從官網查看:http://www.genivia.com/dev.html。
下載和使用gSOAP生成一些庫文件提供給C++工程使用:
- 解壓gsoap文件夾,此處解壓的是gsoap-2.8文件夾,放在E盤
- 打開E:\gsoap-2.8\gsoap\bin\win32文件夾
- 創建一個文件名為wsmap.dat 以文本形式寫入 xsd__string = | std::wstring | wchar_t* ,此文件用來將SOAP/XML中的string轉換成std::wstrin或wchar_t*,這樣能更好地支持中文
- cmd命令行方式到 cd E:\gsoap-2.8\gsoap\bin\win32文件夾,調用wdsl2h.exe文件生成頭文件接口定義,命令為 wdsl2h -o WebService.h -n WS -t wsmap.dat http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?WSDL
WebService.h為頭文件名稱,可自選
http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?WSDL 為需要訪問的webservice的WSDL文件地址
- -o 文件名,指定輸出頭文件
- -n 名空間前綴 代替默認的ns
- -c 產生純C代碼,否則是C++代碼
- -s 不要使用STL代碼
- -t 文件名,指定type map文件,默認為typemap.dat
- -e 禁止為enum成員加上名空間前綴
5.輸入soapcpp2 -C WebService.h -i -L -I E:\gsoap-2.8\gsoap\import
- -C 僅生成客戶端代碼
- -S 僅生成服務器端代碼
- -L 不要產生soapClientLib.c和soapServerLib.c文件
- -c 產生純C代碼,否則是C++代碼(與頭文件有關)
- -I 指定import路徑(此項是必要的,因前面為指定-s)
- -x 不要產生XML示例文件
- -i生成C++包裝,客戶端為xxxxProxy.h(.cpp),服務器端為xxxxService.h(.cpp)。
6.將生成的soapH.h、soapStub.h、soapWeatherWebServiceSoapProxy.h、WeatherWebService.h、soapWeatherWebServiceSoapProxy.cpp、soapC.cpp、WeatherWebServiceSoap.nsmap E:\gsoap-2.8\gsoap文件夾下的stdsoap2.h、stdsoap2.cpp拷貝到要使用的工程目錄下
下面貼入代碼段:
首先聲明階段include 要載入的頭文件和命名空間,要引入.nsmap文件是因為此為要使用的webservice命名空間
- <pre name="code" class="cpp">#include <iostream>
- #include <vector>
- #include <string>
- #include <locale>
- //載入webservice的頭文件和命名空間
- #include "soapWeatherWebServiceSoapProxy.h"
- #include "WeatherWebServiceSoap.nsmap"
using namespace std;
上面使用了vector頭文件是為了能夠輸出信息,天氣webservice中所有返回數據都是vector類型下面我們會講到
接下來我們初始化webservice
- //初始化webservice對象
- WeatherWebServiceSoapProxy proxy("http://www.webxml.com.cn/WebServices/WeatherWebService.asmx");
- //城市名稱,可為空,為空則顯示所有的城市對應的編碼
- string City("");
- int len = MultiByteToWideChar(CP_ACP, 0, (LPCSTR)City.c_str(), -1, NULL, 0);
- wchar_t * wszutf8 = new wchar_t[len + 1];
- memset(wszutf8, 0, len * 2 + 2);
- MultiByteToWideChar(CP_ACP, 0, (LPCSTR)City.c_str(), -1, (LPWSTR)wszutf8, len);
- //設置編碼格式
- //soap_set_mode(&proxy, SOAP_C_MBSTRING);
初始化的時候使用webservice的訪問地址,不需要添加WSDL文件后綴。
初始化getSupportCity對象,getSupport對象的屬性可從http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?op=getSupportCity 中查看為
查詢本天氣預報Web Services支持的國內外城市或地區信息
輸入參數:byProvinceName = 指定的洲或國內的省份,若為ALL或空則表示返回全部城市;返回數據:一個一維字符串數組 String(),結構為:城市名稱(城市代碼)。
然后我們創建一個返回Support City信息的類對象
- <pre name="code" class="cpp"> //初始化getSupportCity對象
- _WS1__getSupportCity weatherCity;
- weatherCity.soap = &proxy;
- weatherCity.byProvinceName = wszutf8;
_WS1__getSupportCityResponse response; proxy.getSupportCity(&weatherCity, response);wcout.imbue(locale("chs"));for (int i = 0; i < response.getSupportCityResult->string.size(); i++) wcout << response.getSupportCityResult->string[i] << endl;
在這個里面可以看到我們輸出是使用的是wcout 而不是 cout 因為 這個是getSupportCityResult這個成員屬性是一個自定義的屬性,用來保存的數據都是以wchar形式保存的
至於為什么會是wchar是因為原來我們使用的那一段文字 xsd__string = | std::wstring | wchar_t* 這將string類型轉換為wstring 或 wchar。這樣可以保證中文文字的合理顯示,否則會出現亂碼。
出現亂碼的原因:HTML和XML中通用的編碼格式是UTF-8,而代碼一般是使用Unicode。但是如果webservice是使用C++編寫的,則不需要wchar也可以使用。而使用的如果是C#、Java之類的編寫的webservice則不使用wchar進行傳參就會造成亂碼。
這里需要說明的是一般的默認顯示是_ns1_getSupportCity,而我顯示的是_WS1_getSupportCity原因是因為 wdsl2h -o WebService.h -n WS -t wsmap.dat http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?WSDL這條命令中我輸出了一個-n WS將名稱前綴換掉了
從_WS1_getSupportCityResponse的定義知道getSupportCityResult這個成員變量是自定義的一個屬性
soapStub.h
- /* WeatherWebService.h:170 */
- #ifndef SOAP_TYPE__WS1__getSupportCityResponse
- #define SOAP_TYPE__WS1__getSupportCityResponse (14)
- /* WS1:getSupportCityResponse complex type: */
- class SOAP_CMAC _WS1__getSupportCityResponse
- {
- public:
- WS1__ArrayOfString *getSupportCityResult; /* SOAP 1.2 RPC return element (when namespace qualified) */ /* optional element of XSD type WS1:ArrayOfString */
- struct soap *soap; /* transient (not serialized) */
- public:
- /// Return the unique type ID value SOAP_TYPE__WS1__getSupportCityResponse (14)
- virtual int soap_type(void) const { return 14; }
- /// Set object's data members to default values
- virtual void soap_default(struct soap*);
- /// Serialize object to prepare for SOAP 1.1/1.2 encoded output (or with SOAP_XML_GRAPH) by analyzing its (cyclic) structures
- virtual void soap_serialize(struct soap*) const;
- /// Output object in XML, compliant with SOAP 1.1 encoding style, return error code or SOAP_OK
- virtual int soap_put(struct soap*, const char *tag, const char *type) const;
- /// Output object in XML, with tag and optional id attribute and xsi:type, return error code or SOAP_OK
- virtual int soap_out(struct soap*, const char *tag, int id, const char *type) const;
- /// Get object from XML, compliant with SOAP 1.1 encoding style, return pointer to object or NULL on error
- virtual void *soap_get(struct soap*, const char *tag, const char *type);
- /// Get object from XML, with matching tag and type (NULL matches any tag and type), return pointer to object or NULL on error
- virtual void *soap_in(struct soap*, const char *tag, const char *type);
- /// Return a new object of type _WS1__getSupportCityResponse, default initialized and not managed by a soap context
- virtual _WS1__getSupportCityResponse *soap_alloc(void) const { return SOAP_NEW(_WS1__getSupportCityResponse); }
- _WS1__getSupportCityResponse() { _WS1__getSupportCityResponse::soap_default(NULL); }
- virtual ~_WS1__getSupportCityResponse() { }
- friend _WS1__getSupportCityResponse *soap_instantiate__WS1__getSupportCityResponse(struct soap*, int, const char*, const char*, size_t*);
- };
- #endif
此自定義屬性為WS1_ArrayOfString 類型,此類型的定義可以看出為什么要使用wchar類型
- /* WeatherWebService.h:164 */
- #ifndef SOAP_TYPE_WS1__ArrayOfString
- #define SOAP_TYPE_WS1__ArrayOfString (12)
- /* WS1:ArrayOfString complex type: */
- class SOAP_CMAC WS1__ArrayOfString
- {
- public:
- std::vector<std::wstring> string; /* optional element of XSD type xsd:string */
- struct soap *soap; /* transient (not serialized) */
- public:
- /// Return the unique type ID value SOAP_TYPE_WS1__ArrayOfString (12)
- virtual int soap_type(void) const { return 12; }
- /// Set object's data members to default values
- virtual void soap_default(struct soap*);
- /// Serialize object to prepare for SOAP 1.1/1.2 encoded output (or with SOAP_XML_GRAPH) by analyzing its (cyclic) structures
- virtual void soap_serialize(struct soap*) const;
- /// Output object in XML, compliant with SOAP 1.1 encoding style, return error code or SOAP_OK
- virtual int soap_put(struct soap*, const char *tag, const char *type) const;
- /// Output object in XML, with tag and optional id attribute and xsi:type, return error code or SOAP_OK
- virtual int soap_out(struct soap*, const char *tag, int id, const char *type) const;
- /// Get object from XML, compliant with SOAP 1.1 encoding style, return pointer to object or NULL on error
- virtual void *soap_get(struct soap*, const char *tag, const char *type);
- /// Get object from XML, with matching tag and type (NULL matches any tag and type), return pointer to object or NULL on error
- virtual void *soap_in(struct soap*, const char *tag, const char *type);
- /// Return a new object of type WS1__ArrayOfString, default initialized and not managed by a soap context
- virtual WS1__ArrayOfString *soap_alloc(void) const { return SOAP_NEW(WS1__ArrayOfString); }
- WS1__ArrayOfString() { WS1__ArrayOfString::soap_default(NULL); }
- virtual ~WS1__ArrayOfString() { }
- friend WS1__ArrayOfString *soap_instantiate_WS1__ArrayOfString(struct soap*, int, const char*, const char*, size_t*);
- };
- #endif
定義的string其實是一個vector<wstring>類型的,這也是為什么我要使用vector頭文件和 char與wchar轉換的原因。
接下來我們先輸出一下運行結果
這是一部分,不是全部,但是毫無疑問我們輸出成功了。
然后我們再來調用天氣接口進行查看天氣。首先我們查看WeatherbyCityName對象的屬性,也是從 http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?op=getWeatherbyCityName 中查看的
根據城市或地區名稱查詢獲得未來三天內天氣情況、現在的天氣實況、天氣和生活指數
調用方法如下:輸入參數:theCityName = 城市中文名稱(國外城市可用英文)或城市代碼(不輸入默認為上海市),如:上海 或 58367,如有城市名稱重復請使用城市代碼查詢(可通過 getSupportCity 或 getSupportDataSet 獲得);返回數據: 一個一維數組 String(22),共有23個元素。
String(0) 到 String(4):省份,城市,城市代碼,城市圖片名稱,最后更新時間。String(5) 到 String(11):當天的 氣溫,概況,風向和風力,天氣趨勢開始圖片名稱(以下稱:圖標一),天氣趨勢結束圖片名稱(以下稱:圖標二),現在的天氣實況,天氣和生活指數。String(12) 到 String(16):第二天的 氣溫,概況,風向和風力,圖標一,圖標二。String(17) 到 String(21):第三天的 氣溫,概況,風向和風力,圖標一,圖標二。String(22) 被查詢的城市或地區的介紹
由此可知,如果我們上面的City不變,應該顯示的是上海,另外此輸出應該是一個有23個元素的wstring對象.
- _WS1__getWeatherbyCityName weatherName;
- weatherName.soap = &proxy;
- weatherName.theCityName = wszutf8;
- _WS1__getWeatherbyCityNameResponse weatherResponse;
- proxy.getWeatherbyCityName(&weatherName, weatherResponse);
- for (int i = 0; i < weatherResponse.getWeatherbyCityNameResult->string.size(); i++)
- wcout << weatherResponse.getWeatherbyCityNameResult->string[i] << endl;
原理與上面獲得城市信息相同,就不多說了,下面貼出運行結果
我也是初次使用C++調用webService,如果有什么更好的方法希望大家多交流