C++中gSOAP的使用详解

什么是gSOAP

gSOAP是一个C语言开发的用于快速简便地创建Web服务的库。在使用gSOAP时，我们可以自动生成代码，这些代码可以用于在Web服务和客户端之间进行通信。gSOAP支持多种Web服务协议，包括SOAP和REST。此外，gSOAP还提供相关的工具，如WSDL编译器和XML解析器等。

gSOAP的安装

gSOAP的安装比较简单，只需执行以下命令：

wget https://sourceforge.net/projects/gsoap2/files/gsoap-2.8/gsoap_2.8.114.zip
unzip gsoap_2.8.114.zip && cd gsoap-2.8.114
./configure && make && sudo make install

安装完成后，我们就可以开始使用gSOAP了。

gSOAP的使用

创建Web服务

使用gSOAP创建Web服务的过程分为以下几步：

1. 在WSDL文件中定义Web服务的接口和数据类型。
2. 使用gSOAP的WSDL编译器生成相应的C头文件和源文件。
3. 实现Web服务的接口。

下面是一个使用gSOAP创建Web服务的示例。

首先，我们在一个名为HelloWorld的工作目录里创建一个名为HelloWorld.wsdl的WSDL文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<definitions name="HelloWorld">
   <types>
      <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
         <xsd:element name="String" type="xsd:string" />
      </xsd:schema>
   </types>
   <message name="SayHelloIn">
      <part name="name" type="xsd:string" />
   </message>
   <message name="SayHelloOut">
      <part name="greeting" type="xsd:string" />
   </message>
   <portType name="HelloWorldPortType">
      <operation name="SayHello">
         <input message="SayHelloIn" />
         <output message="SayHelloOut" />
      </operation>
   </portType>
   <binding name="HelloWorldBinding" type="HelloWorldPortType">
      <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" />
      <operation name="SayHello">
         <soap:operation soapAction="" />
         <input>
            <soap:body use="encoded" namespace="urn:HelloWorld" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
         </input>
         <output>
            <soap:body use="encoded" namespace="urn:HelloWorld" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
         </output>
      </operation>
   </binding>
   <service name="HelloWorldService">
      <port name="HelloWorldPort" binding="HelloWorldBinding">
         <soap:address location="http://localhost:8080/HelloWorld" />
      </port>
   </service>
</definitions>

在WSDL文件中，我们定义了一个HelloWorldPortType接口，该接口包含了一个名为SayHello的方法。该方法接收一个名为name的字符串参数，并返回一个名为greeting的字符串结果。

接下来，我们使用gSOAP的WSDL编译器生成C头文件和源文件。执行以下命令：

wsdl2h -o HelloWorld.h HelloWorld.wsdl
soapcpp2 -C HelloWorld.h

执行完这两条命令后，我们就可以开始实现HelloWorld的Web服务接口了。在此之前需要创建一个名为HelloWorld.cpp的C++源文件，内容如下：

#include "HelloWorld.nsmap"
#include "soapHelloWorldService.h"

int main(int argc, char** argv) {
    int m, s;
    struct soap soap;
    soap_init(&soap);
    m = soap_bind(&soap, NULL, 8080, 100);
    if (m < 0) {
        soap_print_fault(&soap, stderr);
        exit(-1);
    }
    fprintf(stderr, "HelloWorld SOAP service started\n");
    for (;;) {
        s = soap_accept(&soap);
        if (s < 0) {
            soap_print_fault(&soap, stderr);
            exit(-1);
        }
        fprintf(stderr, "-------- starting SOAP server process request\n");
        soap_serve(&soap);
        soap_end(&soap);
    }
    return 0;
}

int ns1__SayHello(struct soap* soap, char* name, char** greeting) {
    static char hello[256];
    sprintf(hello, "Hello, %s", name);
    *greeting = soap_strdup(soap, hello);
    return SOAP_OK;
}

在上面的代码中，我们启动了一个名为HelloWorldService的Web服务，监听在本机的8080端口。当有客户端连接时，我们就会调用ns1__SayHello函数，对客户端的请求进行处理。在这个例子中，我们简单地返回一个字符串，表示问候语。

调用Web服务

调用Web服务跟创建Web服务相比要简单得多。gSOAP提供了一个用于生成客户端代码的工具，我们只需要编写相应的C++代码即可。

下面是一个调用上面创建的HelloWorld Web服务的示例：

#include "soapHelloWorldService.h"
#include "HelloWorld.nsmap"

int main(int argc, char** argv) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s name\n", argv[0]);
        return -1;
    }
    struct soap soap;
    ns1__SayHello in;
    ns1__SayHelloResponse out;
    soap_init(&soap);
    soap_call_ns1__SayHello(&soap, "http://localhost:8080/HelloWorld", "", argv[1], &in, &out);
    printf("%s\n", out.greeting);
    soap_end(&soap);
    return 0;
}

在上面的代码中，我们调用了ns1__SayHello函数，向HelloWorld Web服务发送了一个名为“name”的问候，然后输出服务器返回的结果。

总结

gSOAP是一个十分强大的Web服务开发库，我们可以使用它来快速地创建和调用Web服务。本文以一个简单的HelloWorld Web服务示例介绍了gSOAP的使用。