文/楊宗峰 電商支撐部

簡(jiǎn)單地說(shuō)，gSOAP是一個(gè)跨平臺(tái)的，能在Windows、Linux、MAC OS和UNIX下使用C和C++語(yǔ)言編碼，用于開(kāi)發(fā)Web Service服務(wù)端和客戶端的工具。

更具體地說(shuō)，gSOAP提供了一個(gè)SOAP/XML 關(guān)于C/C++ 語(yǔ)言的實(shí)現(xiàn)，從而讓C/C++語(yǔ)言開(kāi)發(fā)webservice服務(wù)或客戶端程序的工作變得輕松了很多。

絕大多數(shù)的C++  webservice服務(wù)工具包提供一組API函數(shù)類庫(kù)來(lái)處理特定的SOAP數(shù)據(jù)結(jié)構(gòu)，這樣就使得用戶必須改變程序結(jié)構(gòu)來(lái)適應(yīng)相關(guān)的類庫(kù)。與之相反，gSOAP利用編譯器技術(shù)提供了一組透明化的SOAP API，并將與開(kāi)發(fā)無(wú)關(guān)的SOAP實(shí)現(xiàn)細(xì)節(jié)相關(guān)的內(nèi)容對(duì)用戶隱藏起來(lái)。

gsoap自2001年以來(lái)經(jīng)過(guò)10幾年的發(fā)展，已經(jīng)非常成熟，許多工業(yè)項(xiàng)目和產(chǎn)品都在使用該工具。由于他的源代碼為開(kāi)源，并且在行業(yè)標(biāo)準(zhǔn)協(xié)議、傳輸協(xié)議、跨平臺(tái)、安全及多線程、處理速度快、占用內(nèi)存小等優(yōu)勢(shì)下，受到了廣泛開(kāi)發(fā)愛(ài)好者的青睞。

對(duì)于新東網(wǎng)來(lái)說(shuō)，有兩個(gè)省份運(yùn)營(yíng)商電信某某系統(tǒng)應(yīng)用了gsoap工具。

具體應(yīng)用場(chǎng)景為該系統(tǒng)平臺(tái)中銀聯(lián)繳費(fèi)的前置機(jī)服務(wù)。

前置機(jī)服務(wù)的代碼為標(biāo)準(zhǔn)C語(yǔ)言實(shí)現(xiàn)，為了讓前置服務(wù)提供給web前端系統(tǒng)調(diào)用，C語(yǔ)言的服務(wù)就可以通過(guò)gsoap工具輕松發(fā)布成標(biāo)準(zhǔn)規(guī)范的webservice協(xié)議，達(dá)到跨平臺(tái)的目的，同時(shí)也免除了接入系統(tǒng)開(kāi)發(fā)語(yǔ)言的限制。正因?yàn)槿绱?，web前端不受語(yǔ)言的限制，不管是行業(yè)上常用的php或是.net或是java，都能輕松通過(guò)gsoap調(diào)用C語(yǔ)言的服務(wù)。

下面介紹一下如何使用gsoap工具：

1) 解壓工具包并配置環(huán)境變量
將gsoap_2.7.12.tar.gz解壓到本地目錄，這邊需要注意，盡量不要放于帶空格或是帶中文名字的目錄，國(guó)外的軟件對(duì)中文支持欠缺些。

    將D:\gsoap-2.7\gsoap\bin路徑添加到系統(tǒng)的path中。

2) 根據(jù)wsdl描述文件生成客戶端代碼

根據(jù)web前端和前置機(jī)服務(wù)預(yù)先定義好的協(xié)議WSDL描述文件，即前端調(diào)用api規(guī)范文檔，生成C/C++客戶端代碼文件。如下圖中”bank”開(kāi)頭的文件。包含.h和.cpp文件。步驟如下：

a. 先執(zhí)行以下命令，生成頭文件：

 b、在執(zhí)行以下命令，解析bank.h文件，生成存根程序

最后出來(lái)的文件如下：

3) 將上述文件拷貝放入前置機(jī)工程中

4) 前置機(jī)工程中創(chuàng)建ServiceInterface.cpp類同時(shí)導(dǎo)入第三步生成的文件。

#include "BankPackage.h"

#include "bankHIBankBayServiceHttpBindingService.h"

#include "bankH.h"

extern CSockDeal gBankSockDeal;

5) 根據(jù)銀聯(lián)的ISO8583協(xié)議，編寫(xiě)業(yè)務(wù)邏輯代碼，下面以簽到為例進(jìn)行說(shuō)明：

如上述，方法IFA_USCOREPaymentBankReqAndResp后所帶的參數(shù)有兩個(gè)對(duì)象，這兩個(gè)重要的對(duì)象都是gsoap工具的功勞，即由gsoap封裝在bank.h頭文件中。

參數(shù)：ns1__IFA_USCOREPaymentBankReqAndResp則是接收web端的請(qǐng)求對(duì)象，根據(jù)該對(duì)象可以獲取web端上送上來(lái)的所有入?yún)⑿畔ⅰＧ爸梅?wù)根據(jù)這些入?yún)⑿畔⑻幚砗筮M(jìn)行打包并發(fā)送給銀聯(lián)。

參數(shù)：ns1__IFA_USCOREPaymentBankReqAndRespResponse則是響應(yīng)給web端的返回對(duì)象，當(dāng)在前置機(jī)服務(wù)內(nèi)，調(diào)用銀聯(lián)前置機(jī)后，可以將銀聯(lián)的返回信息處理后通過(guò)該對(duì)象返回給web前端。最后,web端將結(jié)果展示給用戶。

gSOAP是一種跨平臺(tái)的C和 C++軟件開(kāi)發(fā)工具包。生成C/C++的RPC代碼，XML數(shù)據(jù)綁定，對(duì)SOAP Web服務(wù)和其他應(yīng)用形成高效的具體架構(gòu)解析器，它們都受益于一個(gè)XML接口。 這個(gè)工具包提供了一個(gè)全面和透明的XML數(shù)據(jù)綁定解決方案，Autocoding節(jié)省大量開(kāi)發(fā)時(shí)間來(lái)執(zhí)行SOAP/XML Web服務(wù)中的C/C++。此外，使用XML數(shù)據(jù)綁定大大簡(jiǎn)化了XML自動(dòng)映射。應(yīng)用開(kāi)發(fā)人員不再需要調(diào)整應(yīng)用程序邏輯的具體庫(kù)和XML為中心的數(shù)據(jù)。