linux gsoap 开发教程,gsoap使用笔记

gsoap入门

1 使用gsoap搭建web service

参考了参考文档[2]中的介绍，有一点点修改。

1.1 编译calc客户端

根据wsdl文件生成gsoap用的头文件

wsdl2h -o calc.h http://www.genivia.com/calc.wsdl

如果用我们自己搭建的webserver，需要修改头文件中的如下代码，

把port字段修改为自己的webservice的url。

//gsoap ns2 service port: http://websrv.cs.fsu.edu/~engelen/calcserver.cgi

改为

//gsoap ns2 service port: http://localhost:9999/cgi-bin/calcserver.cgi

生成client proxy类的源代码

soapcpp2 -j -CL -I/usr/share/gsoap/import calc.h

-j生成C++ proxy类，供client调用，-CL生成客户端程序，-I指明gsoap相关头文件路径，这个根据gsoap安装位置而定，例子中的路径是ubuntu通过apt-get安装的gsoap的路径。

编写client程序calcclient.cpp

#include "calc.nsmap" // XML namespace mapping table (only needed once at the global level)

#include "soapcalcProxy.h" // the proxy class, also #includes "soapH.h" and "soapStub.h"

int main()

{

calcProxy calc;

double sum;

if (calc.add(1.23, 4.56, sum) == SOAP_OK)

std::cout << "Sum = " << sum << std::endl;

else

calc.soap_stream_fault(std::cerr);

calc.destroy(); // same as: soap_destroy(calc.soap);

soap_end(calc.soap);

}

调用proxy类calcProxy 的 add方法，传递了2个参数1.23 4.56，打印结果。

编译

c++ -o calcclient calcclient.cpp soapC.cpp soapcalcProxy.cpp -lgsoap++

如果第二步没修改port的话，这时候执行calcclient就能得到结果了，如果修改了port，我们需要自己搭建一个webservice来提供calc服务。

1.2 搭建服务器

1.2.1 编译服务器端程序

与client第一步一样，生成calc.h

wsdl2h -o calc.h http://www.genivia.com/calc.wsdl

生成server端的接口类

soapcpp2 -j -SL -I/usr/share/gsoap/import calc.h

编写cgi程序calcserver.cpp，实现calc服务器端的接口

#include "calc.nsmap" // XML namespace mapping table (only needed once at the global level)

#include "soapcalcService.h" // the service class, also #includes "soapH.h" and "soapStub.h"

int main()

{

calcService calc(SOAP_XML_INDENT);

if (calc.serve() != SOAP_OK)

calc.soap_stream_fault(std::cerr);

calc.destroy(); // same as: soap_destroy(calc.soap);

soap_end(calc.soap);

}

int calcService::add(double a, double b, double &result)

{

result = a + b;

return SOAP_OK;

}

int calcService::sub(double a, double b, double &result)

{

result = a - b;

return SOAP_OK;

}

int calcService::mul(double a, double b, double &result)

{

result = a * b;

return SOAP_OK;

}

int calcService::div(double a, double b, double &result)

{

if (b == 0.0)

{

char *msg = (char*)soap_malloc(this->soap, 1024);

snprintf(msg, 1024, "Trying to divide %f by zero", a);

return this->soap_senderfault(msg, NULL);

}

result = a / b;

return SOAP_OK;

}

int calcService::pow(double a, double b, double &result)

{

result = ::pow(a, b);

// soap_errno is like errno, but compatible with Win32

if (soap_errno == EDOM)

{

char *msg = (char*)soap_malloc(this->soap, 1024);

snprintf(msg, 1024, "Can't take power of %f to %f", a, b);

return this->soap_senderfault("Power function domain error", msg);

}

return SOAP_OK;

}

编译，测试

c++ -o calcserver calcserver.cpp soapC.cpp soapcalcService.cpp -lgsoap++

./calcserver < calc.add.req.xml

这时候calcserver是一个cgi程序，从标准输入读取soap命令，输出到标准输出上。接下来搭建一个webserver来提供cgi服务。

1.2.2 搭建cgi服务器

简单起见，使用docker启动一个apache来作为web server。

下载apache镜像

docker pull httpd:2.4

修改http.conf文件，启动apache对cgi的支持。

取得http.conf文件，修改其中的cgi支持，打开下面内容的注释即可

LoadModule cgi_module modules/mod_cgi.so

http.conf在docker container的路径为：/usr/local/apache2/conf/httpd.conf

这步不做的话，运行client的时候，会提示如下错误，即apache把cgi请求当成了下载文件的请求。

Error 200 fault: SOAP-ENV:Client[no subcode]

"Error 200"

Detail: [no detail]

启动服务,在calcserver和http.conf所在目录输入如下命令:

docker run -it --rm --name my-apache-app -p 9999:80 -v "$PWD":/usr/local/apache2/cgi-bin -v "$PWD"/http.conf:/usr/local/apache2/conf/httpd.conf -v /usr/lib/x86_64-linux-gnu/libgsoap++.so.4:/usr/lib/x86_64-linux-gnu/libgsoap++.so.4 httpd:2.4

1.3 其他

1.3.1 问题

gsoap也支持自己作为web服务器提供服务，只需要修改server代码，即可，但我没有试验成功。

int main()

{

calcService calc(SOAP_XML_INDENT);

//if (calc.serve() != SOAP_OK)

if (calc.run(9999) != SOAP_OK)

calc.soap_stream_fault(std::cerr);

calc.destroy(); // same as: soap_destroy(calc.soap);

soap_end(calc.soap);

}

这时运行服务器程序时始终提示：

setsockopt unset IPV6_V6ONLY failed in soap_bind()

1.3.2 curl调试webservice服务器

可以使用curl模拟客户端请求一个soap服务[4]，命令如下：

curl -v --header "content-type: application/soap+xml" --data @calc.add.req.xml localhost:9999/cgi-bin/calcserver.cgi

2 编译arm-linux版本的gsoap

2.1 下载gsoap源码

2.2 配置编译环境

下载linaro toolchain，解压到目录/usr/local/linaro-multilib-2014.06-gcc4.9

设置PATH环境变量。export PATH=/usr/local/linaro-multilib-2014.06-gcc4.9:$PATH

2.3 config&make

2.3.1 生成makefile

gsoap-2.8$ ./configure --host=arm-linux-gnueabihf --prefix=/usr/local/arm-linux

checking for a BSD-compatible install... /usr/bin/install -c

checking whether build environment is sane... yes

checking for arm-linux-gnueabihf-strip... arm-linux-gnueabihf-strip

checking for a thread-safe mkdir -p... /bin/mkdir -p

checking for gawk... gawk

checking whether make sets $(MAKE)... yes

checking whether make supports nested variables... yes

checking build system type... x86_64-unknown-linux-gnu

checking host system type... arm-unknown-linux-gnueabihf

checking whether make sets $(MAKE)... (cached) yes

checking for arm-linux-gnueabihf-g++... arm-linux-gnueabihf-g++

checking whether the C++ compiler works... yes

checking for C++ compiler default output file name... a.out

checking for suffix of executables...

checking whether we are cross compiling... yes

...

--host=arm-linux-gnueabihf - 表明编译的库是运行在arm linux上，这个也是gcc编译器的前缀。

--prefix=/usr/local/arm-linux - 表明变编译好的库的安装路径

2.3.2 手动生成wsdl.h文件

gsoap-2.8$ cd gsoap/wsdl

gsoap-2.8/gsoap/wsdl$ ../../target-amd64/bin/soapcpp2 -SC -pwsdl -I. -I../../gsoap/import ./wsdl.h

** The gSOAP code generator for C and C++, soapcpp2 release 2.8.33

** Copyright (C) 2000-2016, Robert van Engelen, Genivia Inc.

** All Rights Reserved. This product is provided "as is", without any warranty.

** The soapcpp2 tool and its generated software are released under the GPL.

** ----------------------------------------------------------------------------

** A commercial use license is available from Genivia Inc., [e-mail]

** ----------------------------------------------------------------------------

soapcpp2: using both options -C and -S omits client/server code

Saving wsdlStub.h annotated copy of the source interface file

Saving wsdlH.h serialization functions to #include in projects

Saving xmime.nsmap namespace mapping table

Saving wsdlC.cpp serialization functions

Compilation successful

../../target-amd64/bin/soapcpp2这个是你的host机器可以运行的soapcpp2

如果不做这步，在编译过程中会提示如下错误，因为编译时，生成的soapcpp2是只能在arm linux上运行的。

make[4]: Entering directory `/home/meng/git/gsoap-2.8/gsoap/wsdl'

../../gsoap/src/soapcpp2 -SC -pwsdl -I. -I../../gsoap/import ./wsdl.h

/bin/bash: ../../gsoap/src/soapcpp2: cannot execute binary file: Exec format error

make[4]: *** [wsdlC.cpp] Error 126

2.3.3 修改代码

修改config.h文件，删除最后一行的#define malloc rpl_malloc

否则编译会出错

`

2.3.4 修改makefile

修改gsoap/wsdl目录下的Makefile，删除下面2行(因为wsdl2h对其他库有依赖，并且我们也不需要arm版本的wsdl2h程序)：

wsdl2h$(EXEEXT): $(wsdl2h_OBJECTS) $(wsdl2h_DEPENDENCIES) $(EXTRA_wsdl2h_DEPENDENCIES)

#@rm -f wsdl2h$(EXEEXT)

#$(AM_V_CXXLD)$(wsdl2h_LINK) $(wsdl2h_OBJECTS) $(wsdl2h_LDADD) $(LIBS)

2.3.5 编译，安装

gsoap-2.8$ make

gsoap-2.8$ make install

在目录/usr/local/arm-linux下是编译好的gsoap库，注：我们没有编译出来arm linux版本的wadl2h。

2.4 编译arm-linux版calcserver.cgi

编译cgi版本的calcserver.cgi

calcserver$ arm-linux-gnueabihf-g++ -o calcserver.cgi calcserver.cpp soapC.cpp soapcalcService.cpp -lgsoap++ -DWITH_FASTCGI -L/usr/local/arm-linux/lib -I/usr/local/arm-linux/include

编译支持fastcgi版本的calcserver.cgi[5]

calcserver$ arm-linux-gnueabihf-g++ -o calcserver.cgi calcserver.cpp soapC.cpp soapcalcService.cpp /gsoap-source-path/gsoap/stdsoap2.cpp -DWITH_FASTCGI -I/usr/local/arm-linux/include -I/fcgi-lib-path/fcgi/include -L/fcgi-lib-path/fcgi/usr/lib -lfcgi

fcgi-lib-path - 这个指向arm linux版的fcgi库

gsoap-source-path - 这个指向gsoap的源码路径`

我们编译stdsoap2.cpp这个文件，而不去链接libsoap++.a

定义WITH_FASTCGI宏

2.5 配置lighttpd

如果编译的是cgi版本，直接把编译好的calcserver.cgi放到cig-bin目录下即可。

如果是fastcgi版本，需要修改lighttpd配置文件，增加如下内容(前提lighttpd已经配置好支持fastcgi了)：

fastcgi.server = (

"calcserver.cgi" =>

(( "socket" => "/tmp/fcgi.socket",

"check-local" => "disable",

"bin-path" => "/webSvr/web/cgi-bin/calcserver.cgi",

"max-procs" => 1,

))

)

3 参考文档