最近换了个工作环境,现在在大望路这边上班,呵,刚上班接到的任务就是熟悉gsoap!废话少说,现在开始gSoap学习!
gSOAP
是一个夸平台的,用于开发
Web Service
服务端和客户端的工具,在
Windows
、
Linux
、
MAC OS
和
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's Guide,基本就能对gsoap有个全面的了解,通过阅读Sample里的例子程序深入。然后搜索网上其它一些文章,比如:
gSOAP简单多线程服务器程序
http://blog.chinaunix.net/u1/55091/showart_430965.html
纯c gSoap实现WebService http://hi.baidu.com/2sky2sea/blog/item/40ec5555680279c1b745ae9b.html
接下来我结合自己的实践与理解,讲讲VC用gsoap下编写webService和客户端程序,有不对的地方还请大家指正,谢谢。
我以网上出现的实现一个简单的加法函数为例,讲讲我在操作过程中遇到的问题。
一 服务器端
1.首先编写 add.h文件:
1
//
gsoap ns service name: add
2
//
gsoap ns service namespace:
http://localhost/add.wsdl
3
//
gsoap ns service location:
http://localhost
4
//
gsoap ns service executable: add.cgi
5
//
gsoap ns service encoding: encoded
6
//
gsoap ns schema namespace: urn:add
7
8
int
ns__add(
int
num1,
int
num2,
int
*
sum );
9
2.用gsoap/bin目录下的soapcpp2.exe程序,生成一些文件。可以把soapcpp2.exe拷贝到一add.h目录下,用
cmd执行soapcpp2.exe
add.h就可以,在这个目录下会自动生成许多将来有用的文件,如
add.namap,soapH.h,soapC.cpp,soapClient.cpp,soapServer.cpp等文件。
soapcpp2.exe可以带参数执行,具体执行soapcpp2.exe -h查看。
3.新建一个win32控制台工程,加入wsock32.lib库,将刚才生成的那些文件添加到工程中。然后编写webserver.cpp主程序:
#include
"
add.h
"
#include
"
add.nsmap
"
int
main(
int
argc,
char
*
argv[])
{
int
m, s;
/**/
/*
master and slave sockets
*/
struct
soap add_soap;
soap_init(
&
add_soap);
//
soap_set_namespaces(&add_soap, add_namespaces);
if
(argc
<
2
)
{
printf(
"
usage: %s <server_port> \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的文件也无须添加到工程
中。再重新编译应该就没有问题了,启动4567端口,在ie中输入localhost:4567,如果显示xml页面,说明程序已经启动。
二 对应的客户端
1。客户端程序代码如下:
#include
<
stdio.h
>
#include
<
stdlib.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等文件加入工程,编
译既可。我是直接在原先工程中加入一客户端代码,将webserver.cpp文件移除,并且将soapServer.cpp等server端需要的文件
移除,将soapClient.cpp等client端需要的cpp添加到工程,编译既可。
3.启动server程序,F5客户端程序,经测试正常。
三 遇到的问题
1.server端可以编译成CGI方式执行,而并不是绑定到某个端口,这种方式我没有实践。
if
(argc
<
2
)
//
no args: assume this is a CGI application
{
soap_serve(
&
soap);
//
serve request, one thread, CGI style
soap_destroy(
&
soap);
//
dealloc C++ data
soap_end(
&
soap);
//
dealloc data and clean up
}
2.在编译服务器及客户端程序时一开始对add.h生成的文件添加到工程,经常出现问题,需要自己不调试。特别是链接时段,server/client要
与其生成的文件相对应,server调用生成的soapserver.cpp,client调用生成的soapclient.cpp文件。
3.多线程方式,在windows下建议用pthread_win32库,这里给出多线程下的例子。
一 gSOAP需要的头文件:
//
gsoap ns service name: calc
//
gsoap ns service style: rpc
//
gsoap ns service encoding: encoded
//
gsoap ns service namespace:
http://127.0.0.1
:8089/calc.wsdl
//
gsoap ns service location:
http://127.0.0.1
:8089/cal
//
gsoap ns schema namespace: urn:calc
int
ns__add(
double
a,
double
b,
double
*
result);
int
ns__sub(
double
a,
double
b,
double
*
result);
int
ns__mul(
double
a,
double
b,
double
*
result);
int
ns__div(
double
a,
double
b,
double
*
result);
int
ns__pow(
double
a,
double
b,
double
*
result);
二 多线程服务器关键代码
#include
#include
"
calc.nsmap
"
#include
"
soapH.h
"
/**/
////////////////////////////////////////////////////////////////////////
/
///
宏与全局变量的定义
#define
BACKLOG (100)
#define
MAX_THR (10)
#define
MAX_QUEUE (1000)
pthread_mutex_t queue_cs;
//
队列锁
pthread_cond_t queue_cv;
//
条件变量
SOAP_SOCKET queue[MAX_QUEUE];
//
数组队列
int
head
=
0
, tail
=
0
;
//
队列头队列尾初始化
/**/
////////////////////////////////////////////////////////////////////////
//
////////////////////////////////////////////////////////////////////////
//
void
*
process_queue(
void
*
);
//
线程入口函数
int
enqueue(SOAP_SOCKET);
//
入队列函数
SOAP_SOCKET dequeue(
void
);
//
出队列函数
/**/
////////////////////////////////////////////////////////////////////////
//
//
线程入口函数
void
*
process_queue(
void
*
soap)
{
struct
soap
*
tsoap
=
(
struct
soap
*
)soap;
for
(;;)
{
tsoap
->
socket
=
dequeue();
if
(
!
soap_valid_socket(tsoap
->
socket))
{
break
;
}
soap_serve(tsoap);
soap_destroy(tsoap);
soap_end(tsoap);
}
return
NULL;
}
//
入队列操作
int
enqueue(SOAP_SOCKET sock)
{
int
status
=
SOAP_OK;
int
next;
pthread_mutex_lock(
&
queue_cs);
next
=
tail
+
1
;
if
(next
>=
MAX_QUEUE)
next
=
0
;
if
(next
==
head)
status
=
SOAP_EOM;
else
{
queue[tail]
=
sock;
tail
=
next;
}
pthread_cond_signal(
&
queue_cv);
pthread_mutex_unlock(
&
分享到:
相关推荐
gsoap使用方法及心得
代码使用VC++实现了单独的PTZ控制,代码量非常少,个人认为是目前我能看到的唯一使用 soap toolkit实现的PTZ控制代码。实现了海康IPC的PTZ控制。运行代码在控制台窗口输入m云台X轴移动,输入s云台停止,q退出。
介绍关于gsoap的使用方法及相关概念,内容很详细
linux下gsoap使用及移植 ,有例子,照着做就可以了
2.2 gSOAP文档翻译计划(1、介绍) 1.介绍 gSOAP编译工具提供了一个SOAP/XML 关于C/C++ 语言的实现,从而让C/C++语言开发web服务或客户端程序的工作变得轻松了很多。绝大多数的C++web服务工具包提供一组API函数...
简单的gsoap使用指南,包括部分代码.
带gsoap-2.8源码,基于服务器客户端的实例,带自动生成服务客户端代码的批处理程序,及如何使用。带自己学习参考的教程; 0.解压附件,soapInterface.bat所在路径不得含中文 空格 1.新建头文件 取soapInterface....
此文档为转载资源,项目中得到验证。上传用于以后使用。
根据wsdl使用gsoap生成的服务器和客户端
gsoap 使用http get post调用web api接口
gsoap,直接下载,调用函数即可,实现通讯
gsoap使用教程和soapui测试webservice接口使用教程,附上测试用的wsdl文件,有详细截图,一看就懂,抓紧下载查看吧!代码也在csdn上
gsoap2.8实现onvif协议
详细介绍演示了gsoap工具的安装过程和使用,首先的一个前提就是要在命令提示符下面尽享进行的!
gSOAP 开发手册,做好了目录,以及有些英文翻译
gsoap最新版本最新版本,C/C++调用Web Service需要用到soap库,一般使用的有gsoap和axis cpp两种实现,这里使用gsoap来调用。gsoap是sourceforge上的一个开源项目,目前版本是2.7.6c,使用简单,可以在 linxu、...
gsoap 中文文档 gsoap 中文文档 gsoap 中文文档 gsoap 中文文档
基于gSOAP编译工具的C++客户端调用C#服务器端WebService示例程序; gSOAP编译工具使用说明文档; gsoap_win32_2.7.6c压缩包
GSOAP工具可以在WIN和UNIX两个系统平台下运行,这就使我们的程序在跨平台上有了基础。工具的安装包可浏览其主页下载。本DEMO的开发使用的版本为gsoap_win32_2.7.9l,工具的运行环境是Windows系统。
gsoap