gSOAP编译工具提供了一个SOAP/XML 关于C/C++ 语言的实现，从而让C/C++语言开发web服务或客户端程序的工作变得轻松了很多。绝大多数的C++web服务工具包提供一组API函数类库来处理特定的SOAP数据结构，这样就使得用户必须改变程序结构来适应相关的类库。与之相反，gSOAP利用编译器技术提供了一组透明化的SOAP API，并将与开发无关的SOAP实现细节相关的内容对用户隐藏起来。
gSOAP的编译器能够自动的将用户定义的本地化的C或C++数据类型转变为符合XML语法的数据结构，反之亦然。这样，只用一组简单的API就将用户从SOAP细节实现工作中解脱了出来，可以专注与应用程序逻辑的实现工作了。gSOAP编译器可以集成C/C++和Fortran代码（通过一个Fortran到C的接口），嵌入式系统，其他SOAP程序提供的实时软件的资源和信息；可以跨越多个操作系统，语言环境以及在防火墙后的不同组织。
gSOAP使编写web服务的工作最小化了。gSOAP编译器生成SOAP的代码来序列化或反序列化C/C++的数据结构。gSOAP包含一个WSDL生成器，用它
来为你的web服务生成web服务的解释。gSOAP的解释器及导入器可以使用户不需要分析web服务的细节就可以实现一个客户端或服务端程序。
下面是gSOAP的一些特点：
gSOAP编译器可以根据用户定义的C和C++数据结构自动生成符合SOAP的实例化代码。
gSOAP 支持 MIME (SwA) 和 DIME 附件包。
gSOAP是唯一支持DIME附件传输的工具包。它允许你在保证XML可用性的同时能够以最快的方式（流方式）传递近乎无大小限制的二进制数据 。
gSOAP 支持 SOAP-over-UDP。
gSOAP 支持 IPv4 and IPv6.
gSOAP 支持 SSL (HTTPS)。
gSOAP 支持 HTTP/1.0,HTTP/1.1 保持连接,分块传输及基本验证。
gSOAP 支持 SOAP 单向消息。
生成可以单独运行的web服务及客户端程序。
因为只需要很少内存空间，所以可以运行在类似Palm OS,Symbian,Pocket PC的小型设备中。
适用于以C或C++开发的web服务中。
跨平台：Windows,Unix,Linux,Mac OS X,Pocket PC,Palm OS,Symbian等。
支持序列化程序中的本地化C/C++数据结构。
编码的图像就可以在小内存设备（如PDA）中以DIME附件或其他方式传输。
支持C++单继承，动态绑定，重载，指针结构（列表、树、图、循环图，定长数组，动态数组，枚举，64位2进制编码及16进制编码）。
三相编组：1）分析指针，引用，循环数据结构；2）确定HTTP消息长度；3）将数据序列化位SOAP1.1编码方式或用户定义的数据编码方式。
双相编组：1）SOAP解释及编码；2）分解“forward”指针（例如：分解SOAP中的href属性）。
完整可定制的SOAP错误处理机制。
可定制的SOAP消息头处理机制，可以用来保持状态信息
2 gSoap2.2版与gSOAP 2.1版（或以前版本）的不同
如果你是从2.1版升级到2.2或以后版本，请注意这些变化。
3. gSoap2.x版与gSOAP 1.x版的不同
gSOAP2.0及之后的版本是在1.x版基础上重写的。gSOAP2.0之后的版本是线程安全的，但之前版本不是。gSOAP2.x版本中的主要文件已经重新
命名，以便与1.x版区分。
gSOAP 1.X gSOAP 2.X
soapcpp soapcpp2
soapcpp.exe soapcpp2.exe
stdsoap.h stdsoap2.h
stdsoap.c stdsoap2.c
stdsoap.cpp stdsoap2.cpp
境变量初始化。在2.x版中新增了3个函数来负责这些事情：
函数 解释
soap_init(struct soap *soap) 初始化环境变量（只需执行一次）
struct soap *soap_new() 定义并初始化环境变量并返回一个该变量的指针
int main()
{
struct soap soap;
...
soap_init(&soap); // 初始化环境变量
...
...
...
soap_end(&soap); // 清除环境变量
...
}
我们也可以像下面这样定义环境变量：
int main()
{
struct soap *soap;
...
soap = soap_new(); // 定义并初始化环境变量
if (!soap) // 如果不能定义，退出
...
...
...
soap_end(soap); // 清除环境变量
...
free(soap); // 释放环境变量空间
}
int main()
{
struct soap soap;
soap_init(&soap);
soap_serve(&soap);
}
或者像下面这样:
int main()
{
soap_serve(soap_new());
}
一个web服务可以用多线程技术来处理请求：
int main()
{
struct soap soap1,soap2;
pthread_t tid;
...
soap_init(&soap1);
if (soap_bind(&soap1,host,port,backlog) < 0) exit(1);
if (soap_accept(&soap1) < 0) exit(1);
pthread_create(&tid,NULL,(void*(*)(void*))soap_serve,(void*)&soap1);
...
soap_init(&soap2);
...
soap_end(&soap2);
...
pthread_join(tid,NULL); // 等待线程结束
soap_end(&soap1); // 释放环境变量
}
在上面的例子中，需要两个环境变量信息。而在1.x版本中，由于静态分配环境变量，多线程技术是不被允许的（只有一个线程可以用这个环
4 准备工作
要开始用gSOAP创建一个web服务应用,你需要:
一个C/C++编译器.
拥有根据操作系统平台创建的可执行的gSOAP的stdsoap2（windows下为stdsoap2.exe）编译器。
拥有根据操作系统平台创建的可执行的gSOAP的wsdl2h（windows下为wsdl2h.exe）WSDL解析器。
如果你要支持SSL（HTTPS）及压缩的话，可以安装OpenSSL及Zlib库。
gSOAP是独立开发包，不需要任何第三方的软件支持（除非你要用到OpenSSL及Zlib）。
与平台无关的gSOAP版本需要你下面的工具编译'soapcpp2'及'wsdl2h'文件：
一个C++编译器（用来编译'wsdl2h'WSDL解析器）。
Bison 或 Yacc
Flex 或 Lex
推荐使用Bison及Flex。
在软件包samples目录下有大量的开发实例。可以用'make'来编译这些例子。这些例子包含了gSOAP中的各个方面。其中，最简单的例子是
one-liners（samples/oneliners）。
5 快速指南
以直接用C/C++开始编写web服务及客户端程序而不需要了解SOAP协议的细节，但是由于我们在本节中使用了大量的实例来说明gSOAP与其他SOAP
实现的连接及通讯，所以了解一些SOAP及WSDL协议也是必需的。
5.1 如何使用gSOAP编译环境来编译SOAP客户端程序
、图等）时。幸运的是，gSOAP包中的'wsdl2h'WSDL解析器和'soapcpp2’存根及架构编译器能够将web服务客户端及服务端的开发工作自动化。
参见下面的命令：
$ wsdl2h -o quote.h
$ wsdl2h -c -o quote.h
更多关于WSDL解析器及其选项的细节信息，请参见8.2.10节。
端程序应用。
序列化这些数据的代码，以便存根例程可以将这些数据以XML的方式编码或解码。
官方网站
下面给出一个例子吧
wsdl2h -o outfile.h(为自己任意起的头文件） infile.wsdl（提供的wsdl文件）
如果用生成纯C的代码，需要加编译选项-c
wsdl2h -c -o outfile.h(为自己任意起的头文件） infile.wsdl（提供的wsdl文件）
如果用生成纯C的代码，需要加编译选项-c
wsdl2h -c -o outfile.h(为自己任意起的头文件） infile.wsdl（提供的wsdl文件）
作为服务端，需要的代码为：
soapC.cpp soapC.h soapServer.cpp soapStub.h stdsoap2.cpp stdsoap2.h stlvector.h WcmpServiceSOAP11Binding.nsmap（这个文件名根据outfile文件是不同的）
作为客户端，需要的代码为：
soapC.cpp soapC.h soapClient.cpp soapStub.h stdsoap2.cpp stdsoap2.h stlvector.h WcmpServiceSOAP11Binding.nsmap（这个文件名根据outfile文件是不同的）
soapC.cpp soapC.h soapServer.cpp soapStub.h stdsoap2.cpp stdsoap2.h stlvector.h WcmpServiceSOAP11Binding.nsmap（这个文件名根据outfile文件是不同的）
作为客户端，需要的代码为：
soapC.cpp soapC.h soapClient.cpp soapStub.h stdsoap2.cpp stdsoap2.h stlvector.h WcmpServiceSOAP11Binding.nsmap（这个文件名根据outfile文件是不同的）
将文件导入工程
编译的时候需要设置
还需要WSSOCK.LIB，因为底层是socket实现的
#include "stdafx.h" |
#include "soapH.h" |
#include <stdio.h> |
#include "calc.nsmap" |
|
using namespace std;
|
|
int main(int argc,char **argv) |
{ SOAP_SOCKET m,s; /* master and slave sockets */
|
struct soap soap;
|
soap_init(&soap);
|
if (argc < 2)
|
soap_serve(&soap); /* serve as CGI application */
|
else
|
{ m = soap_bind(&soap,atoi(argv[1]),100);
|
if (!soap_valid_socket(m))
|
{ soap_print_fault(&soap,stderr);
|
exit(-1);
|
} |
fprintf(stderr,"Socket connection successful: master socket = %d\n",m);
|
for ( ; ; )
|
{ s = soap_accept(&soap);
|
fprintf(stderr,"Socket connection successful: slave socket = %d\n",s);
|
if (!soap_valid_socket(s))
|
{ soap_print_fault(&soap,stderr);
|
exit(-1);
|
} |
soap_serve(&soap);
|
soap_end(&soap);
|
} |
} |
return 0;
|
} |
|
int __cdecl ns2__add(struct soap *soap,double a,double b,double &result){
|
result = a + b;
|
cout<<"the result is ---"<<result<<endl;
|
return SOAP_OK;
|
} |
|
int __cdecl ns2__sub(struct soap *soap, double &result){ |
result = a - b;
|
return SOAP_OK;
|
} |
|
int __cdecl ns2__mul(struct soap *soap, double &result){ |
result = a * b;
|
return SOAP_OK;
|
} |
|
int __cdecl ns2__div(struct soap *soap, double &result){ |
if (b)
|
result = a / b;
|
else
|
{ char *s = (char*)soap_malloc(soap,1024);
|
sprintf(s,"<error xmlns=\"http://tempuri.org/\">Can't divide %f by %f</error>",a,b);
|
return soap_sender_fault(soap,"Division by zero",s);
|
} |
return SOAP_OK;
|
} |
|
int __cdecl ns2__pow(struct soap *soap, double &result){ |
result = pow(a,b);
|
if (soap_errno == EDOM) /* soap_errno is like errno,but compatible with Win32 */
|
{ char *s = (char*)soap_malloc(soap,"Can't take the power of %f to %f",b);
|
sprintf(s,"<error xmlns=\"http://tempuri.org/\">Can't take power of %f to %f</error>",b);
|
return soap_sender_fault(soap,"Power function domain error",s);
|
} |
return SOAP_OK;
|
} |
已同样的方式导入客户端程序
#include "stdafx.h" |
#include "soapH.h" |
#include "calc.nsmap" |
|
//const char server[] = "http://websrv.cs.fsu.edu/~engelen/calcserver.cgi"; |
const char server[] = "http://localhost:8000";
|
|
int main(int argc,char* argv[])
|
{ |
struct soap soap;
|
double a,b,result;
|
if (argc < 4)
|
{ fprintf(stderr, "Usage: [add|sub|mul|div|pow] num num\n");
|
exit(0);
|
} |
soap_init1(&soap,SOAP_XML_INDENT);
|
a = strtod(argv[2],NULL);
|
b = strtod(argv[3],NULL);
|
switch (*argv[1])
|
{ case 'a':
|
soap_call_ns2__add(&soap,server,"",result);
|
break;
|
case 's':
|
soap_call_ns2__sub(&soap,result);
|
break;
|
case 'm':
|
soap_call_ns2__mul(&soap,result);
|
break;
|
case 'd':
|
soap_call_ns2__div(&soap,result);
|
break;
|
case 'p':
|
soap_call_ns2__pow(&soap,result);
|
break;
|
default:
|
fprintf(stderr,"UnkNown command\n");
|
exit(0);
|
} |
if (soap.error)
|
{ soap_print_fault(&soap,stderr);
|
exit(1);
|
} |
else
|
printf("result = %g\n",result);
|
soap_destroy(&soap);
|
soap_end(&soap);
|
soap_done(&soap);
|
return 0;
|
} |
启动gsoap服务
调用客户端程序，执行服务
同样的程序可以部署到linux或者unix中。
版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 [email protected] 举报，一经查实，本站将立刻删除。
