SOAP学习笔记（一）

来源：http://blog.sina.com.cn/s/blog_4c31626a010008s2.html

       最近开始学习gsoap的源码。从网上下了 gsoap_win32_2.7.9f的源码。gsoap由两个功能模块组成，分别对应wsdl2h和soapcpp2命令。wsdl2h的源码在wsdl目录下，而soapcpp2的源码在src目录下。wsdl2h是解析WSDL文件的模块，将输入的WSDL文件转换成H文件——确切的说是intermediate的文件，以soapcpp2可识别的格式记录WSDL解析得到的有用信息。soapcpp2则接着分析该H文件，生成Web应用的server和client代码。应用代码可以有两种形式：纯C代码和C++代码。

 

    由于是自己rebuild工程，所以没用gsoap自带的wsdl2h.exe和soapcpp2.exe。在VC6下创建gsoap工程又是一个code porting的过程。gsoap的源码生成用到了unix下的词法分析工具flex和语法分析工具bison。如果在Web业务上需要加密功能的话，还需要有OpenSSL和ZLib压缩库。使用cygwin中的flex.exe和bison.exe生成所需的代码。之后的code porting 过程比较简单，就不赘述了。

 

       生成wsdl2h.exe和soapcpp2.exe后，就可以使用gsoap来搭建简单的“C-S”的Web应用了。

       从SoapTest工具的官网下了个最简单的计算器服务的WSDL文件： calculator.wsdl。使用wsdl2h解析该文件：

 

       wsdl2h  -c -o calculator.h calculator.wsdl

 

       生成H文件calculator.h。-c参数表示生成纯C的应用代码。接着使用：

 

       soapcpp2  calculator.h

 

       生成最终的server和client的SOAP框架代码。SOAP框架代码既可以编译生成server和client的静态库，也可以直接编译到应用程序中。我用的是后者。

 

       对于SOAP框架代码的应用，由于SOAP框架代码已经实现了业务层以下的所有功能实现和封装，因此应用的代码只需要聚焦在业务层的实现上。在client端，需要编写代码：对gsoap生成的业务请求接口进行调用，传入参数，并取出返回的业务响应结果；在server端，则需要编写各项具体业务的功能代码，这些业务的接口原型已在框架代码中生成，只要实现其函数实体即可。

 

       在gsoap的samples目录中有一个calc例子和上面使用的calculator.wsdl业务功能十分相似，可以直接“拿来主义”，稍事修改就OK了。

       因为只在本机上做测试，因此客户端的连接地址直接使用“127.0.0.1”。编译生成服务器端程序calcserver.exe以及calcclient.exe。

       首先启动Web服务：

 

       calcserver 80

 

       其中80表示HTTP端口。然后启动客户端，请求3+5的结果：

 

       calcclient a 3 5

 

       其中a是add业务请求，3和5是add业务的传入参数。执行后返回：

 

       result = 8

 

       自此，基本完成了对gsoap的了解、应用和简单验证。因为项目的需要，可能需要吃透gsoap前端的WSDL解析功能，以后有时间再深入分析gsoap的源码咯^_^