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部分代码如下

  1 /******************************************************************************\
  2  *                                                                            *
  3  * Services                                                                   *
  4  *                                                                            *
  5 \******************************************************************************/
  6 
  7 
  8 //gsoap ns2  service name:    calc 
  9 //gsoap ns2  service type:    calcPortType 
 10 //gsoap ns2  service port:    http://websrv.cs.fsu.edu/~engelen/calcserver.cgi 
 11 //gsoap ns2  service namespace:    urn:calc 
 12 //gsoap ns2  service transport:    http://schemas.xmlsoap.org/soap/http 
 13 
 14 /** @mainpage calc Definitions
 15 
 16 @section calc_bindings Service Bindings
 17 
 18   - @ref calc
 19 
 20 @section calc_more More Information
 21 
 22   - @ref page_notes "Notes"
 23 
 24   - @ref page_XMLDataBinding "XML Data Binding"
 25 
 26   - @ref SOAP_ENV__Header "SOAP Header Content" (when applicable)
 27 
 28   - @ref SOAP_ENV__Detail "SOAP Fault Detail Content" (when applicable)
 29 
 30 
 31 */
 32 
 33 /**
 34 
 35 @page calc Binding "calc"
 36 
 37 @section calc_service Service Documentation "calc"
 38 gSOAP 2.7.9k generated service definition
 39 
 40 @section calc_operations Operations of Binding "calc"
 41 
 42   - @ref ns2__add
 43 
 44   - @ref ns2__sub
 45 
 46   - @ref ns2__mul
 47 
 48   - @ref ns2__div
 49 
 50   - @ref ns2__pow
 51 
 52 @section calc_ports Default endpoints of Binding "calc"
 53 
 54   - http://websrv.cs.fsu.edu/~engelen/calcserver.cgi
 55 
 56 @note Use wsdl2h option -Nname to change the service binding prefix name
 57 
 58 
 59 */
 60 //gsoap ns2  service method-protocol:    add SOAP
 61 //gsoap ns2  service method-style:    add rpc
 62 //gsoap ns2  service method-encoding:    add http://schemas.xmlsoap.org/soap/encoding/
 63 //gsoap ns2  service method-action:    add ""
 64 //gsoap ns2  service method-output-action:    add Response
 65 int ns2__add(
 66     double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
 67     double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
 68     double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
 69 );
 70 
 71 //gsoap ns2  service method-protocol:    sub SOAP
 72 //gsoap ns2  service method-style:    sub rpc
 73 //gsoap ns2  service method-encoding:    sub http://schemas.xmlsoap.org/soap/encoding/
 74 //gsoap ns2  service method-action:    sub ""
 75 //gsoap ns2  service method-output-action:    sub Response
 76 int ns2__sub(
 77     double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
 78     double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
 79     double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
 80 );
 81 
 82 //gsoap ns2  service method-protocol:    mul SOAP
 83 //gsoap ns2  service method-style:    mul rpc
 84 //gsoap ns2  service method-encoding:    mul http://schemas.xmlsoap.org/soap/encoding/
 85 //gsoap ns2  service method-action:    mul ""
 86 //gsoap ns2  service method-output-action:    mul Response
 87 int ns2__mul(
 88     double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
 89     double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
 90     double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
 91 );
 92 
 93 //gsoap ns2  service method-protocol:    div SOAP
 94 //gsoap ns2  service method-style:    div rpc
 95 //gsoap ns2  service method-encoding:    div http://schemas.xmlsoap.org/soap/encoding/
 96 //gsoap ns2  service method-action:    div ""
 97 //gsoap ns2  service method-output-action:    div Response
 98 int ns2__div(
 99     double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
100     double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
101     double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
102 );
103 
104 //gsoap ns2  service method-protocol:    pow SOAP
105 //gsoap ns2  service method-style:    pow rpc
106 //gsoap ns2  service method-encoding:    pow http://schemas.xmlsoap.org/soap/encoding/
107 //gsoap ns2  service method-action:    pow ""
108 //gsoap ns2  service method-output-action:    pow Response
109 int ns2__pow(
110     double                              :a,    ///< Input parameter, : unqualified name as per RPC encoding
111     double                              :b,    ///< Input parameter, : unqualified name as per RPC encoding
112     double                             &:result    ///< Output parameter, : unqualified name as per RPC encoding
113 );

接着生成源文件:

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。

客户端代码如下

 1 #include <cstdlib>
 2 #include "calc.nsmap"//一定要加,不要忘记
 3 #include "soapcalcProxy.h"
 4 
 5 using namespace std;
 6 
 7 /*
 8  * 
 9  */
10 int main(int argc, char** argv) {
11     calcProxy calc_clnt;
12     double add;
13     int ret=calc_clnt.add(1,2,add);
14     if(ret==SOAP_OK) {
15         printf("add=%lf", add);
16     }else
17     {
18         printf("err_code=%d", ret);
19     }
20     return 0;
21 }

运行结果

编译工程时特别要注意加上其它编译项和库

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

结果:

 

 

posted on 2018-08-03 17:12  苦涩的茶  阅读(3948)  评论(0编辑  收藏  举报

// 1.生成目录索引列表