【新東網(wǎng)技術大咖帶您走進gSOAP】一個強大的開源工具
發(fā)布時間: 2016-11-11 11:51:49
文/楊宗峰 電商支撐部
新東網(wǎng)自2001年成立以來,掌握大數(shù)據(jù)、云計算、通信、物聯(lián)網(wǎng)及區(qū)塊鏈等信息技術,擁有一支逾16年經(jīng)驗的強大IT團隊。為沉淀企業(yè)技術實力,繼續(xù)發(fā)揮行業(yè)優(yōu)勢,《東網(wǎng)快訊》特邀新東網(wǎng)技術大咖帶您走進這些先進信息技術,揭秘新東網(wǎng)16年來的技術成果,每周五發(fā)布。
簡單地說,gSOAP是一個跨平臺的,能在Windows、Linux、MAC OS和UNIX下使用C和C++語言編碼,用于開發(fā)Web Service服務端和客戶端的工具。
更具體地說,gSOAP提供了一個SOAP/XML 關于C/C++ 語言的實現(xiàn),從而讓C/C++語言開發(fā)webservice服務或客戶端程序的工作變得輕松了很多。
絕大多數(shù)的C++ webservice服務工具包提供一組API函數(shù)類庫來處理特定的SOAP數(shù)據(jù)結構,這樣就使得用戶必須改變程序結構來適應相關的類庫。與之相反,gSOAP利用編譯器技術提供了一組透明化的SOAP API,并將與開發(fā)無關的SOAP實現(xiàn)細節(jié)相關的內(nèi)容對用戶隱藏起來。
gsoap自2001年以來經(jīng)過10幾年的發(fā)展,已經(jīng)非常成熟,許多工業(yè)項目和產(chǎn)品都在使用該工具。由于他的源代碼為開源,并且在行業(yè)標準協(xié)議、傳輸協(xié)議、跨平臺、安全及多線程、處理速度快、占用內(nèi)存小等優(yōu)勢下,受到了廣泛開發(fā)愛好者的青睞。
對于新東網(wǎng)來說,有兩個省份運營商電信某某系統(tǒng)應用了gsoap工具。
具體應用場景為該系統(tǒng)平臺中銀聯(lián)繳費的前置機服務。
前置機服務的代碼為標準C語言實現(xiàn),為了讓前置服務提供給web前端系統(tǒng)調用,C語言的服務就可以通過gsoap工具輕松發(fā)布成標準規(guī)范的webservice協(xié)議,達到跨平臺的目的,同時也免除了接入系統(tǒng)開發(fā)語言的限制。正因為如此,web前端不受語言的限制,不管是行業(yè)上常用的php或是.net或是java,都能輕松通過gsoap調用C語言的服務。
下面介紹一下如何使用gsoap工具:
1) 解壓工具包并配置環(huán)境變量
將gsoap_2.7.12.tar.gz解壓到本地目錄,這邊需要注意,盡量不要放于帶空格或是帶中文名字的目錄,國外的軟件對中文支持欠缺些。
將D:\gsoap-2.7\gsoap\bin路徑添加到系統(tǒng)的path中。
2) 根據(jù)wsdl描述文件生成客戶端代碼
根據(jù)web前端和前置機服務預先定義好的協(xié)議WSDL描述文件,即前端調用api規(guī)范文檔,生成C/C++客戶端代碼文件。如下圖中”bank”開頭的文件。包含.h和.cpp文件。步驟如下:
a. 先執(zhí)行以下命令,生成頭文件:
b、在執(zhí)行以下命令,解析bank.h文件,生成存根程序
最后出來的文件如下:
3) 將上述文件拷貝放入前置機工程中
4) 前置機工程中創(chuàng)建ServiceInterface.cpp類同時導入第三步生成的文件。
#include "BankPackage.h"
#include "bankHIBankBayServiceHttpBindingService.h"
#include "bankH.h"
extern CSockDeal gBankSockDeal;
5) 根據(jù)銀聯(lián)的ISO8583協(xié)議,編寫業(yè)務邏輯代碼,下面以簽到為例進行說明:
如上述,方法IFA_USCOREPaymentBankReqAndResp后所帶的參數(shù)有兩個對象,這兩個重要的對象都是gsoap工具的功勞,即由gsoap封裝在bank.h頭文件中。
參數(shù):ns1__IFA_USCOREPaymentBankReqAndResp則是接收web端的請求對象,根據(jù)該對象可以獲取web端上送上來的所有入?yún)⑿畔?。前置服務根?jù)這些入?yún)⑿畔⑻幚砗筮M行打包并發(fā)送給銀聯(lián)。
參數(shù):ns1__IFA_USCOREPaymentBankReqAndRespResponse則是響應給web端的返回對象,當在前置機服務內(nèi),調用銀聯(lián)前置機后,可以將銀聯(lián)的返回信息處理后通過該對象返回給web前端。最后,web端將結果展示給用戶。
gSOAP是一種跨平臺的C和 C++軟件開發(fā)工具包。生成C/C++的RPC代碼,XML數(shù)據(jù)綁定,對SOAP Web服務和其他應用形成高效的具體架構解析器,它們都受益于一個XML接口。 這個工具包提供了一個全面和透明的XML數(shù)據(jù)綁定解決方案,Autocoding節(jié)省大量開發(fā)時間來執(zhí)行SOAP/XML Web服務中的C/C++。此外,使用XML數(shù)據(jù)綁定大大簡化了XML自動映射。應用開發(fā)人員不再需要調整應用程序邏輯的具體庫和XML為中心的數(shù)據(jù)。