gsoap使用心得【转】

gsoap使用方法及心得

 

gSOAP是一个夸平台的，用于开发WebService服务端和客户端的工具，在Windows、Linux、MACOS和UNIX下使用C和C++语言编码，集成了SSL功能。

 

下载地址：http://sourceforge.net/projects/gsoap2

官方网站：http://genivia.com/Products/gsoap/index.html

 

对于Windows平台下开发客户端，首先下载最新的gsoap_win32_2.7.6c.zip包，具体在以下地址：http://optusnet.dl.sourceforge.net/sourceforge/gsoap2/gsoap_win32_2.7.6c.zip

 

首先查看gsoap的User'sGuide，基本就能对gsoap有个全面的了解，通过阅读Sample里的例子程序深入。然后搜索网上其它一些文章，比如：

 

gSOAP简单多线程服务器程序：http://blog.chinaunix.net/u1/55091/showart_430965.html

 

纯c的gSoap实现WebService：http://hi.baidu.com/2sky2sea/blog/item/40ec5555680279c1b745ae9b.html

 

我以网上出现的实现一个简单的加法函数为例，讲讲我在操作过程中遇到的问题。

 

一、服务器端

 

1、首先编写 add.h文件：

//gsoap nsservice name: add

//gsoap nsservice namespace: http://localhost/add.wsdl

//gsoap nsservice location: http://localhost

//gsoap nsservice executable: add.cgi

//gsoap nsservice encoding: encoded

//gsoap nsschema namespace: urn:add

 

int ns__add(int num1, int num2, int* sum );

 

 

2、用gsoap/bin目录下的soapcpp2.exe程序，生成一些文件。

可以把soapcpp2.exe拷贝到一add.h目录下，用cmd执行soapcpp2.exeadd.h。

在这个目录下会自动生成许多将来有用的文件，如add.namap,soapH.h,soapC.cpp,soapClient.cpp,soapServer.cpp等文件。

soapcpp2.exe可以带参数执行，具体执行soapcpp2.exe-h查看。

 

3、新建一个win32控制台工程，加入wsock32.lib库，将刚才生成的那些文件添加到工程中。

 

然后编写webserver.cpp主程序：

 

#include

#include

#include "stdsoap2.h"

#include "add.h"

#include "add.nsmap"

int main(int argc, char*argv[])

{

int m, s;

struct soap add_soap;

soap_init(&add_soap);

//soap_set_namespaces(&add_soap,add_namespaces);

if (argc < 2)

{

printf("usage: %s /n",argv[0]);

exit(1);

}

else

{

m =soap_bind(&add_soap, NULL, atoi(argv[1]),100);

if (m < 0)

{

soap_print_fault(&add_soap,stderr);

exit(-1);

}

fprintf(stderr, "Socket connection successful:master socket = %d/n", m);

for ( ; ; )

{

s =soap_accept(&add_soap);

if (s < 0)

{

soap_print_fault(&add_soap,stderr);

exit(-1);

}

fprintf(stderr, "Socket connection successful:slave socket = %d/n", s);

soap_serve(&add_soap);//该句说明该server的服务

soap_end(&add_soap);

}

}

return 0;

}

 

 

//server端的实现函数与add.h中声明的函数相同，但是多了一个当前的soap连接的参数

 

int ns__add(struct soap *add_soap, int num1,int num2, int *sum)

{

*sum = num1 + num2;

return 0;

}

 

4、编译

编译这个程序，会提示错误，将gsoap_win32目录下stdsoap2.cpp，stdsoap2.h文件加入工程，重新编译如果还有错误，可能是你将add.h生成的文件添加入工程出错的原因。

实际上在编写server程序时，无须带Client的那些文件，还有带Lib的文件也无须添加到工程中。

调试成功之后，在cmd中执行gsoap.exe文件，并设定第一个参数为4567。在IE中输入http://localhost:4567，如果显示xml页面，说明程序已经启动。

 

 

二、客户端

 

1、  客户端程序代码如下:/

 

#include

#include

#include "stdsoap2.h"

#include "soapH.h"

#include "add.nsmap"

 

int add(const char* server, int num1, int num2,int *sum);

 

int main(int argc, char**argv)

{

int result = -1;

char*server="http://localhost:4567";

int num1 = 0;

int num2 = 0;

int sum = 0;

if( argc < 3 )

{

printf("usage: %s num1 num2 /n",argv[0]);

exit(0);

}

num1 = atoi(argv[1]);

num2 = atoi(argv[2]);

result = add(server, num1, num2,&sum);

if (result != 0)

{

printf("soap err,errcode = %d/n",result);

}

else

{

printf("%d+%d=%d/n", num1, num2, sum);

}

return 0;

}

 

int add(const char* server, int num1, int num2,int *sum)

{

struct soap add_soap;

int result = 0;

soap_init(&add_soap);

// soap_set_namespaces(&add_soap,add_namespaces);

//该函数是客户端调用的主要函数，后面几个参数和add.h中声明的一样，前面多了3个参数，函数名是接口函数名ns__add前面加上soap_call_

soap_call_ns__add( &add_soap, server, "",num1, num2, sum );

if(add_soap.error)

{

printf("soap error:%d,%s,%s/n", add_soap.error,*soap_faultcode(&add_soap), *soap_faultstring(&add_soap));

result =add_soap.error;

}

soap_end(&add_soap);

soap_done(&add_soap);

return result;

}

 

2、客户端程序既可以新建一个新的win32控制台程序，将刚才生成的nsmap,soapH.h,soapClient.h等文件加入工程，编译既可。需要注意，必须配置Lib文件

 

3、服务器与客户端的连调测试

(1)启动服务器端 gsoap.exe4567

(2)启动客户端   gsoap_client.exe1 2

显示的结果为：1+2=3