c/c++的Soap应用

1. 关于soap

在许多项目中团队中,我们常常会听到这样的话:我们这里是用webservice交互的。而说话的场景往往就是交互对象双方比较异构,所谓异构、即双方是不同的开发语言、不同的运行环境等。比如常见的c/c++后台程序与java的web程序间的通信,当然这里的通信是网络通信,如果是一体化单机系统内,可能第一反应是JNI方式了。

异构体系间的通信,就是webservice的基本应用场景。而soap(simple object access protocal)则是webservice在实际操作中需要遵守的协议,webservice的其它关键元素还有:WSDL, http, xml等。

2. 适用情况

如前所述、在一个项目中不同开发体系间希望交互信息,同时不愿花大气力自己做通信框架,产品需求定位为:快捷开发、稳定有效,没有明显大并发的需求,那么webservice是一个很好的选择。

之所以排除大并发的应用场景,个人觉得大并发平台网络环境复杂,在接口伸缩性和业务结合度方面,一般都是公司内部封装通信框架更合适。另外webservice通信中携带的冗余信息太多也是一大诟病,所以大并发的场景,想想也算了。

3. C++ gsoap工具

Gsoap是c/c++在webservice开发中一个强大工具,c/c++er在做webservice开发一般都是用的这个利器。

从网上很容易找到gsoap的源码,以我下载的gsoap-2.8为例。如果不用特别的研究编译工具源码,那么下载后需要用的东西是两个地方:

1. 在\gsoap-2.8\gsoap\bin\win32目录下有两个编译工具:wsdl2h.exe和soapcpp2.exe。

wsdl2h.exe:用于将wsdl文件转换为c/c++使用的头文件。

soapcpp2.exe:用于将上述头文件转换为c/c++项目使用的基础代码。包括客户端代码、服务端代码、头文件的wsdl描述。

2. 在\gsoap-2.8\gsoap目录下有两个文件:stdsoap2.cpp和stdsoap2.h。这两个文件即为c++使用webservice通信的底层soap协议实现。

4. C++应用

对于C++来说,webservice就是一种RPC(Remote Procedure Call Protocol远程过程调用协议)方式,既然是RPC,通俗的说、就是本地C++需要用到异地环境的方法,那么本地与异地双方就有一个基本的方法列表,之后达到就像在调用本地方法一样的调用异地方法。由此引出C++在webservice开发的基本过程:

      C++服务端开发:

1)列出能够提供的方法接口,写入头文件;

2) 用gsoap的soapcpp2.exe编译工具将1)中头文件编译生成服务端代码;

3) 将2)中生成的代码引入到自己的服务端项目中,进行服务端业务开发,需要注意的是服务端必须实现1)中头文件定义的方法。

      c++客户端开发:

1) 如果有服务方提供的wsdl文件,则用gsoap提供的wsdl2h.exe工具生成头文件,然后同c++服务端开发的前两步一样,生成客户端代码;

如果C/S双方都是C++开发,那么可以不需要wsdl的“介绍”,直接在上述c++服务端开发2)中,同时生成客户端代码,拿到这里用即可。

2) 将上述gsoap框架下的客户端代码引入到自己的客户端项目中,就可以调用服务端方法了。

      归纳:

C++的webservice开发,如果自己玩,可以不需要wsdl,但如果与其它体系一起协同通信,就需要wsdl(网络服务描述语言)来描述头文件的那些方法列表。Soap协议使得通信双方不需要关心具体通信实现,双发维护好提供业务的方法即可。

Gsoap是一个开源的soap封装,从stdsoap2.cpp中可以看出其跨平台的实现,比如“#ifdef WIN32”这样的痕迹。stdsoap2.h中代码风格有值得学习的地方,比如条件预处理格式等,一个头文件和一个cpp就实现了soap的协议封装,短小精悍。\gsoap-2.8\gsoap\doc中文档介绍朴素简洁,建议以html方式查看,一目了然。

5. 简单例子

本例子通过服务端提供一个字符串置反的方法,运行后在本机通过SoapUI测试客户端调用。

      C++服务端:

服务端工程,根据前面所述C++服务端开发步骤,首先给出头文件reverse.h

int ns__reversestr(char *iStr, char **oStr);

然后就只有一个main.cpp

#include "soapService.h"

//服务方法的实现

int Service::reversestr(char *iStr, char **oStr)

{

if (NULL == iStr || NULL == oStr)

{

return this->error;

}

int strLen = strlen(iStr);

*oStr = (char*)soap_malloc(this, strLen + 1);

memset(*oStr, 0, strLen + 1);

char *pOutBuf = *oStr;

while (strLen-- > 0)

{

*(pOutBuf++) = *(iStr + strLen);

}

return this->error;

}

//服务入口,这里是最基本的服务形式

int main()

{

Service serv;

serv.serve();

int port = 80;  //服务端口,启用前先用netstat查看下该端口是否被占用

if (serv.run(port))

{

serv.soap_stream_fault(std::cerr);

exit(-1);

}

return 0;

}

      SoapUI测试:

c/c++的Soap应用

上一篇:Git 分支 (二)合并


下一篇:Linux架构之NFS共享存储1