gSOAP 在windows下的安裝與使用（mingw32）

 

 

gSOAP是一個綁定SOAP/XML到C/C++語言的工具，使用它可以簡單快速地開發出SOAP/XML的服務器端和客戶端。由於 gSOAP具 有相當不錯的兼容性，通過gSOAP，我們就可以調用由Java, .Net, Delhpi, PHP等語言開發的SOAP服務，或者向它們提供SOAP服務。 

（一）安裝

gSOAP的主頁是: 
http://sourceforge.net/projects/gsoap2 
下載解壓后，可以在gsoap\bin\win32里 找到wsdl2h.exe和soapcpp2.exe（另外 mac版本）。 

根據實踐證明，windows下可以不用像https://www.genivia.com/downloads.html#releases文中所說如下圖編譯安裝，直接使用。

當然想重新編譯安裝也是可以的。具體步驟如下：

首先根據說明“Tip: when autoconf, automake, flex, bison, openssl-devel, and zlib-devel are installed you can run configure to build the gSOAP tools and libraries as follows:”

需要安裝以上幾個庫和工具，否則后面的編譯會出錯。

具體可以使用mingw-get.exe安裝

 

 

完成以上安裝后，接着可以進行gsoap編譯安裝 

1、打開mingw32->msys目錄下的終端“msys.bat 美化mintty”，記得用美化mintty版，這樣可以使用右鍵copy。進入gsoap解壓后的目錄

2、執行./configure

 

3、執行make

4、安裝，執行make install

 完成以后會將soapcpp2、wsdl2h工具及庫等安裝部署到以下目錄

根據實踐證明，生成的wsdl2h運行無法正常使用

 

所以不建議編譯安裝，如果實在要使用可以將gsoap源文件夾win32下的該程序拷貝過來替換。

最后是要在windows環境變量中加入以上安裝目錄中的bin、lib、include等目錄，記得實在不同的環境變量中哦。

如果不編譯安裝，而是直接使用gsoap源文件夾win32則環境變量中加入該目錄即可。

當然不加入以上lib、include亦可，只需在編程工具的工程項目中增加即可，netbeans、qt等工具都可以添加。

 

（二）使用demo

這個參考https://blog.csdn.net/qianqiuwanzi/article/details/24120455

（以經典的calc為例）

使用gsoap\bin\win32目錄中的兩個應用：soapcpp2.exe和wsdl2h.exe，生成客戶端和服務器端框架。

使用gSOAP生成客戶端和服務器端代碼框架。我們有兩種做法：

1. 編寫WSDL，使用wsdl2h生成頭文件，再通過soapcpp2生成框架代碼；
2. 編寫頭文件，使用soapcpp2生成框架代碼；

方法1比較通用，可方便使用其他語言開發，但是編寫wsdl語法復雜；

方法2比較簡單，但不能與其他語言通用。

我個人會選擇第2個方法，效率第一！當然，如果已經從其他地方得到了wsdl文件，就用第1中方法。

方法2可參考： http://blog.csdn.net/kisaa133/article/details/7729856

 

wsdl2h命令說明

經常使用的一些指令如下：

　　-o　filename.h　　　將wsdl轉化為filename.h頭文件。

　　-s　　　　　　　　　不生成STL代碼

　　-c　　　　　　　　　生成純C風格的頭文件，這將去除C++的一些特性

　　-n  name　　　　　 使用name代替默認前綴ns

　　-t　filename.dat　　使用filename.dat代替默認的typemap.dat文件

　　-zX　　　　　　　　兼容之前的X版本

下面來說方法1：

用wsdl2h生成頭文件過程如下：

使用的wsdl為：http://www.genivia.com/calc.wsdl

將 wsdl2h.exe;soapcpp2.exe;typemap.dat;calc.wsdl 拷貝到你自己的工作目錄下（已經在環境變量中設置無需拷貝前三個了），將wsdl文件也保存為Calculator.wsdl，在cmd中，將目錄切換到工作目錄，執行 wsdl2h.exe -p calc.wsdl，將生成calc.h。

同樣也可以使用命令wsdl2h -o calc.h http://www.genivia.com/calc.wsdl

生成頭文件

calc.h部分代碼如下

/******************************************************************************\
 *                                                                            *
 * Services                                                                   *
 *                                                                            *
\******************************************************************************/


//gsoap ns2  service name:    calc 
//gsoap ns2  service type:    calcPortType 
//gsoap ns2  service port:    http://websrv.cs.fsu.edu/~engelen/calcserver.cgi 
//gsoap ns2  service namespace:    urn:calc 
//gsoap ns2  service transport:    http://schemas.xmlsoap.org/soap/http 

/** @mainpage calc Definitions

@section calc_bindings Service Bindings

  - @ref calc

@section calc_more More Information

  - @ref page_notes "Notes"

  - @ref page_XMLDataBinding "XML Data Binding"

  - @ref SOAP_ENV__Header "SOAP Header Content" (when applicable)

  - @ref SOAP_ENV__Detail "SOAP Fault Detail Content" (when applicable)


*/

/**

@page calc Binding "calc"

@section calc_service Service Documentation "calc"
gSOAP 2.7.9k generated service definition

@section calc_operations Operations of Binding "calc"

  - @ref ns2__add

  - @ref ns2__sub

  - @ref ns2__mul

  - @ref ns2__div

  - @ref ns2__pow

@section calc_ports Default endpoints of Binding "calc"

  - http://websrv.cs.fsu.edu/~engelen/calcserver.cgi

@note Use wsdl2h option -Nname to change the service binding prefix name


*/
//gsoap ns2  service method-protocol:    add SOAP
//gsoap ns2  service method-style:    add rpc
//gsoap ns2  service method-encoding:    add http://schemas.xmlsoap.org/soap/encoding/
//gsoap ns2  service method-action:    add ""
//gsoap ns2  service method-output-action:    add Response
int ns2__add(
    double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
    double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
    double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
);

//gsoap ns2  service method-protocol:    sub SOAP
//gsoap ns2  service method-style:    sub rpc
//gsoap ns2  service method-encoding:    sub http://schemas.xmlsoap.org/soap/encoding/
//gsoap ns2  service method-action:    sub ""
//gsoap ns2  service method-output-action:    sub Response
int ns2__sub(
    double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
    double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
    double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
);

//gsoap ns2  service method-protocol:    mul SOAP
//gsoap ns2  service method-style:    mul rpc
//gsoap ns2  service method-encoding:    mul http://schemas.xmlsoap.org/soap/encoding/
//gsoap ns2  service method-action:    mul ""
//gsoap ns2  service method-output-action:    mul Response
int ns2__mul(
    double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
    double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
    double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
);

//gsoap ns2  service method-protocol:    div SOAP
//gsoap ns2  service method-style:    div rpc
//gsoap ns2  service method-encoding:    div http://schemas.xmlsoap.org/soap/encoding/
//gsoap ns2  service method-action:    div ""
//gsoap ns2  service method-output-action:    div Response
int ns2__div(
    double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
    double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
    double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
);

//gsoap ns2  service method-protocol:    pow SOAP
//gsoap ns2  service method-style:    pow rpc
//gsoap ns2  service method-encoding:    pow http://schemas.xmlsoap.org/soap/encoding/
//gsoap ns2  service method-action:    pow ""
//gsoap ns2  service method-output-action:    pow Response
int ns2__pow(
    double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
    double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
    double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
);

接着生成源文件：

soapcpp2 頭文件
常用選項
-C 僅生成客戶端代碼
-S 僅生成服務器端代碼
-L 不要產生soapClientLib.c和soapServerLib.c文件
-c 產生純C代碼，否則是C++代碼(與頭文件有關)
-I 指定import路徑（見上文）
-x 不要產生XML示例文件
-i 生成C++包裝，客戶端為xxxxProxy.h(.cpp)，服務器端為xxxxService.h(.cpp)。--wsj本人建議加上

在cmd命令行下進入工程目錄，執行： 
soapcpp2  -L -w -x -i -I D:\tools\gsoap-2.8\gsoap\import calc.h

即生成一堆文件，包括客戶端和服務端框架代碼。

通過netbeans創建工程項目soap_calc（client）

並將生成的soapC.cpp、soapH.h、soapStub.h、soapcalcProxy.h、soapcalcProxy.cpp、calc.nsmap、stdsoap2.h和stdsoap2.cpp文件加入到工程，其中stdsoap2.h和stdsoap2.cpp為gsoap文件夾中的文件拷貝過來即可，如果是c語言則stdsoap2.cpp替換為stdsoap2.c。

客戶端代碼如下

#include <cstdlib>
#include "calc.nsmap"//一定要加，不要忘記
#include "soapcalcProxy.h"

using namespace std;

/*
 * 
 */
int main(int argc, char** argv) {
    calcProxy calc_clnt;
    double add;
    int ret=calc_clnt.add(1,2,add);
    if(ret==SOAP_OK) {
        printf("add=%lf", add);
    }else
    {
        printf("err_code=%d", ret);
    }
    return 0;
}

運行結果

編譯工程時特別要注意加上其它編譯項和庫

netbeans中在

中設置即可。

 

 qtcreator只需在pro文件里添加即可

 

 

 注意事項（關鍵）：---wsj

當直接使用 soapcpp2 頭文件 生成文件時，如果頭文件的命名是

int downloadCAGCtrl(std::string strXMLParams,std::string *strXMLResult);時

使用soapcpp2 I2Server.h命令只能生成以下文件，無法生成wsdl、xml類型文件，這個wsdl文件在此頭文件生成webservice服務端的時候很關鍵，在webservice調用的時候要使用。

 

這時候，就要將頭文件內容修改下：

int ns__downloadCAGCtrl(std::string strXMLParams,std::string *strXMLResult);

對了就是在函數名前面加了命名空間名字，通常用默認的ns__

同樣的命令：soapcpp2 I2Server.h 結果如下

 

 服務端的話，建議采用命令soapcpp2  -L -S -i I2Server.h

結果：