CPP-网络/通信：gsoap 的教程和使用

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.8 c 版本：

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 包中的帮助文档，本文档略。