BCB gsoap实例源码

/////////////////////////////////////////////////////////////////////////////////////// http://hi.baidu.com/songfeng163/blog/item/89ac27f7a3578f20720eecf3.html/ 一、引言 gSOAP是一个OpenSource的web服务开发工具，包括server/client通信和wsdl自动生成功能,能依据wsdl文件生成server和client代码，产生的代码小巧简洁不依赖其他xml解析库，很容易移植，大大减轻webservice程序员的工作量。它提供一种独特的SOAP/XML到C/C++ 语言绑定，以简化C或C++中SOAP/XML Web服务和客户机的开发。gSOAP工具包括一个WSDL生成器，用于为您的 Web 服务生成 Web 服务描述。WSDL importer 工具使SOAP客户机应用程序开发完全自动化。 gSoap大大简化了使用C/C++开发WEB Service流程，是C/C++开发人员开发WEB服务一种较佳选择。gSoap的安装以及开发文档请参见参考文献[1]、[2]和[3]，下面我们主要关注gSoap下Server端接口函数的数据传出。 二、单个传出参数 gSoap接口函数的返回值只能是int，是soap调用的结果，一般通过soap.error来判断soap的连接情况。接口函数的最后一个参数为传出参数，必须为引用或指针类型(注:传入参数为能为引用类型)。如下所示： int ns__add(struct soap *add_soap, int num1, int num2, int *sum)； 三、多个传出参数 如果需要传出多个参数，需要自己定义一个结构将返回项封装，然后以此结构体作为单个参数传出即可。如下所示： struct type_return{ int id; char *name; int age; } int ns__getInfo(struct soap *soap, int id, struct type_result *ret); 四、二进制数据传出 无论是axis c++还是gsoap，对复杂数据类型的支持都不是太好，再加上gsoap的.h文件中不能包含(#include)别的.h文件，可能不能生效，所以需要使用void数据类型，不指明数据类型，返回后再作处理。然而，gsoap不能对void数据类型进行串化(serialize)操作，除非使用union或struct分配实时类型信息。因此，当传出二进行数据时，需要使用xsd__base64Binary结构类型来操作。如下所示： struct xsd__base64Binary{ unsigned char *__ptr; int __size; }; 在使用上述结构时，可能需要使用soap_malloc()来进行内存分配，并分配__size值。 int ns__demoFunction(struct soap *soap,..., struct xsd__base64Binary *ret) { ... ret->__ptr = (unsigned char *)soap(soap, size); /*size为内存大小*/ ret->__size = size; memset(ret->__ptr, 0, size); memcpy(ret->__ptr, src_ptr, size); /*src_ptr为源数据块指针*/ ... return SOAP_OK; } 五、文件数据传出 Soap协议支持附件(Attachment)，gSoap支持MIME/DIME附件，我们可以使用这个特性来进行整个文件或大量的数据传出。gSoap附件操作与(四)中的二进制数据传出非常相近，同样使用struct xsd__base64Binary类型。这时不再重复，详细可参考文献[2]中的#13 MIME Attachments。 六、参考文献 1.官方网站 2.gSoap User Guide 3.构建WEB服务C/C++客户机 4.用C实现WebService ///////////////////////////////////////////////////////////////////////////////////////////// http://www.cppblog.com/woaidongmao/archive/2008/05/27/51312.aspx 1.1.1 gSOAP 1.1.1.1 简介 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服务的细节就能够实现一个客户端或服务端程式。 1.1.1.2 gSOAP+VC研发客户端 gSOAP是开放的C/C++源码的soap服务器实现，本章节简单介绍使用gSOAP研发2.2.1.3中的AXIS服务器的客户程式。 下载gSOAP工具的代码地址，当前最新版本是2.7.8c版本： http://sourceforge.net/project/showfiles.php?group_id=52781 解压缩本地目录，进入bin目录 根据wsdl生成头文档方式有以下几种： 生成C++代码 $ wsdl2h -o testClient.h http://localhost:8080/axis/services/HelloService?wsdl 生成C++代码，不是用STL $ wsdl2h -s -o testClient.h http://localhost:8080/axis/services/HelloService?wsdl 生成纯C代码 $ wsdl2h -c -o testClient.h http://localhost:8080/axis/services/HelloService?wsdl 本例使用C++代码（含STL）方式 生成客户端代码，使用如下命令（不带-C参数生成客户端和服务器代码） soapcpp2 -C –I..\import testClient.h 打开VC，创建一个Win32的控制台程式soapClient，"Project", Settings", selecｔ the "Link" tab (the project file needs to be selected in the file view) anｄ add "wsock32.lib。 把刚刚生成的以下代码添加到工程中去： soapStub.h soapH.h soapC.cpp soapClient.cpp soapClientLib.cpp 在main函数中写入代码soapClient.cpp： // soap.cpp : Defines the entry point for the console application. // #include "stdafx.h" #include "soapH.h" #include "HelloServiceSoapBinding.nsmap" int main(int argc, char* argv[]) { struct soap soap; std::string a="STS Corp."; int b=0; std::string result; if (argc < 3) { fprintf(stderr, "Usage: string num\n"); exit(0); } soap_init(&soap); a=argv[1]; b = atoi(argv[2]); DWORD begin= GetTickCount(); for (int i=0;i<1;i++) { soap_call_ns1__sayHello(&soap, "http://10.41.25.70:8080/axis/services/HelloService", "", a, b, result); if (soap.error) { soap_print_fault(&soap, stderr); exit(1); } else printf("result = %s\n", result.c_str()); b++; } DWORD end= GetTickCount(); printf("每秒处理%d个\n", 1*1000/(end-begin)); soap_destroy(&soap); soap_end(&soap); soap_done(&soap); system("pause"); return 0; } 编译完成后，直接以命令行方式运行程式soapClient “STS Corp.” 9 输出结果为result = Hello:“STS~~~~~~~~~~square=0，配置循环控制变量能够简单用于测试性能。 代码中使用soap_init2能够配置http1.1消息头的connection属性为keep-alive，当配置为keep-alive时，每秒交互能够达到360次以上，假如使用close方式，每秒交互大约200次以上。 发出的请求消息如下： POST /axis/services/HelloService HTTP/1.1 Host: 10.41.25.70:8080 User-Agent: gSOAP/2.7 Content-Type: text/xml; charset=utf-8 Content-Length: 478 Connection: close SOAPAction: "" <?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ns1="http://demo"><SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><ns1:sayHello><in0>STS Corp.</in0><in1>9</in1></ns1:sayHello></SOAP-ENV:Body></SOAP-ENV:Envelope> 响应消息： HTTP/1.1 200 OK Server: Apache-Coyote/1.1 Content-Type: text/xml;charset=utf-8 Date: Tue, 29 Aug 2006 10:36:45 GMT Connection: close <?xml version="1.0" encoding="utf-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><soapenv:Body><ns1:sayHelloResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="http://demo"><sayHelloReturn xsi:type="xsd:string">Hello:STS Corp.~~~~~~~~~~square=81</sayHelloReturn></ns1:sayHelloResponse></soapenv:Body></soapenv:Envelope> 1.1.1.3 gSOAP+VC研发服务器 gSOAP是开放的C/C++源码的soap服务器实现，能够参考gSOAP包中的帮助文档，本文档略。