gSOAP服务开发指南V2._0.docVIP

作者：羊笑佺 审核人： - PAGE 14 - gSOAP服务开发指南 概述 gSOAP服务是基于gSOAP C++工具包开发的，支持SOAP协议的Web Services 服务。gSOAP工具包包含了工具和库。工具用于根据服务定义文件(.h文件或者.wsdl文件)生成服务框架，库与服务框架一起，负责完成SOAP协议的解析工作。 gSOAP服务利用HTTP WEB服务器作为前端，处理HTTP请求。HTTP WEB服务器与gSOAP服务之间通过FastCGI协议进行通讯。 目前，测试过的HTTP服务器包括Lighttpd/IBM HTTP Server。标准的J2EE Application Server通过jFastCGI包也可以作为前端HTTP服务器。目前测试过的J2EE Server包括WebLogic和WebSphere。 sysmanager.cgi sysmanager.cgi (fastcgi进程) HTTP服务器 order.cgi (fastcgi进程) Oracle Database 服务端开发 开发流程 下表列出了gSOAP服务的开发流程以及与Tuxedo服务开发流程的对比。可以看出，gSOAP与Tuxedo开发是相似的。 gSOAP服务 Tuxedo服务 1 定义服务方法(Service.h文件) 定义接口(.idl文件) 2 生成服务框架和WSDL(soapcpp2) 生成服务框架(idl -i *.idl) 3 补充服务实现(Service.cpp) 补充服务实现(_i.cpp) 4 编译服务(g++) 编译服务(buildobjserver) 5 部署服务 部署服务 定义服务方法 服务和方法通过C++头文件的形式来定义。 首先需要定义服务本身的一些属性，下面列出必须的属性： 服务名称(service name) 命名空间(service namespace) 服务位置(service location) 这些属性在头文件中以“//gsoap 命名空间前缀 属性名称 : 属性值”形式定义。 例如下面的代码： //File: soaservice.h //gsoap ns1 service name: SOAService //gsoap ns1 service namespace: urn:soaservice //gsoap ns1 service location: http://localhost/ws/soaservice 定义了命名空间前缀ns1的服务名称为SOAService，命名空间为urn:soaservice，位置为http://localhost/ws/soaservice。 接着定义服务中的方法。 方法返回值统一为int型，方法名称要求符合“命名空间前缀__方法名”的形式。输入输出参数支持简单类型，也支持struct结构。对于std::string类型的输入输出参数或者结构成员，需要写成xsd__string和xsd__string的形式(通过typedef将 xsd__string定义为std::string)，以便于gSOAP编译器在生成WSDL时，转换成xsd::string类型。 输出参数的类型后需要加。 例如下面的代码： typedef std::string xsd__string; struct ns1__npRequestRequest { xsd__string MessageID; xsd__string CommandCode; //…… }; struct ns1__npRequestResponse { xsd__string MessageID; //…… }; int ns1__npRequest( \ struct ns1__npRequestRequest r_input, \ struct ns1__npRequestResponse r_output); 定义了npRequest方法，输入参数为ns1__npRequestRequest类型的结构，输出参数为ns1__npRequestResponse类型的结构。 为了实现在一个程序中实现多个服务端，客户端共存，需要通过C++ namespace的方式将整个定义包含在一个命名空间中。即用namespace NamespaceName { … }将上面的整个定义包括起来。 完整的soaservice.h定义如下： namespace SOAService { //File: soaservice.h //gsoap ns1 service name: SOAService //gsoap ns1 service