C++实现一个简单的SOAP客户端

为了实现一个简单的SOAP客户端，我们需要按照以下步骤进行操作：

步骤一：安装必要的库和工具

SOAP是一种基于XML的Web服务协议，我们需要用到的是SOAP库。在C++中，我们有很多不同的SOAP库可供选择，比如gSOAP、Apache Axis C++等等。在这里，我们以gSOAP为例进行说明。

1. 下载并安装gSOAP库，可以从官网http://www.cs.fsu.edu/~engelen/soap.html获取。
2. 安装好gSOAP后，在cmd命令行中输入wsdl2h检查是否安装成功，如果有相应输出则表示安装成功。

步骤二：编写WSDL文件

在进行SOAP客户端编写前，我们需要先编写一个WSDL文件（Web Service Description Language）。WSDL是一种XML格式的文件，用来描述Web服务的位置、操作等信息。下面是一个简单的WSDL文件示例：

<definitions xmlns="http://schemas.xmlsoap.org/wsdl/"
             xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:xsd="http://www.w3.org/2001/XMLSchema"
             targetNamespace="http://example.com/Sample/SOAP/Service">

  <message name="AddRequest">
    <part name="a" type="xsd:int"/>
    <part name="b" type="xsd:int"/>
  </message>

  <message name="AddResponse">
    <part name="result" type="xsd:int"/>
  </message>

  <portType name="SampleSOAPServicePortType">
    <operation name="Add">
      <input message="tns:AddRequest"/>
      <output message="tns:AddResponse"/>
    </operation>
  </portType>

  <binding name="SampleSOAPServiceBinding" type="tns:SampleSOAPServicePortType">
    <soap12:binding style="document" 
      transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="Add">
      <soap12:operation soapAction="http://example.com/Sample/SOAP/Service/Add"/>
      <input>
        <soap12:body use="literal"/>
      </input>
      <output>
        <soap12:body use="literal"/>
      </output>
    </operation>
  </binding>

  <service name="SampleSOAPService">
    <port name="SampleSOAPServicePort" binding="tns:SampleSOAPServiceBinding">
      <soap12:address location="http://example.com/Sample/SOAP/Service"/>
    </port>
  </service>

</definitions>

步骤三：生成代码文件

生成C++代码的方式有两种：wsdl2h和soapcpp2。

3.1 使用wsdl2h

wsdl2h是gSOAP库提供的工具，可以将WSDL文件转换成C++的头文件。使用方法如下：

wsdl2h -c -o hello.h hello.wsdl

其中，-c参数表示生成C++的代码，-o参数指定生成的头文件名，hello.wsdl是我们刚才编写的WSDL文件名。

3.2 使用soapcpp2

soapcpp2是gSOAP库提供的工具，可以将C++的头文件转换成客户端和服务器的SOAP源代码。使用方法如下：

soapcpp2 -C hello.h

该命令将根据hello.h生成客户端的代码。

步骤四：编写客户端程序

下面是一个简单的SOAP客户端程序：

#include "soapH.h"
#include "HelloSOAPService.nsmap"

int main()
{
    struct soap soap;
    HelloWorldReq req;
    HelloWorldRes res;

    soap_init(&soap);
    soap_default_HelloWorldReq(&soap, &req);
    soap_default_HelloWorldRes(&soap, &res);
    req.name = "John";

    if (soap_call_ns1__HelloWorld(&soap, "", "", &req, &res) == SOAP_OK)
    {
        printf("Result: %s\n", res.result.c_str());
    }
    else
    {
        soap_print_fault(&soap, stderr);
    }

    soap_destroy(&soap);
    soap_end(&soap);
    soap_done(&soap);

    return 0;
}

1. 首先，声明一个soap结构体，它是gSOAP库提供的重要数据结构。
2. 然后，声明一个请求结构体HelloWorldReq和一个响应结构体HelloWorldRes，它们分别对应WSDL文件中的helloWorldRequest和helloWorldResponse消息。
3. 接下来，对soap、HelloWorldReq和HelloWorldRes进行了初始化。
4. 然后，将req结构体中的值设置为请求的参数。
5. 最后，使用soap_call_ns1__HelloWorld函数调用SOAP服务，并通过res结构体返回响应结果，如果调用成功则输出结果，否则输出SOAP协议中的错误信息。

示例一：调用阿里云API

下面是一个调用阿里云API的SOAP客户端程序：

#include "soapH.h"
#include "alidayu.nsmap"

int main()
{
    struct soap soap;
    AliDayuReq req;
    AliDayuRes res;

    const char* appkey = "your_appkey";
    const char* secret = "your_secret";
    const char* url = "http://gw.api.taobao.com/router/rest";

    soap_init(&soap);
    soap_default_AliDayuReq(&soap, &req);
    soap_default_AliDayuRes(&soap, &res);
    req.app_key = appkey;
    req.sign = secret;
    req.format = "json";
    req.method = "alibaba.aliqin.fc.sms.num.send";
    req.v = "2.0";
    req.partner_id = "";
    req.timestamp = soap_time(&soap, NULL, 0);

    ns1__RequestParamType* param = soap_new_ns1__RequestParamType(&soap);
    param->param_key = "test";
    param->param_value = "test";
    ns1__RequestBodyType* body = soap_new_ns1__RequestBodyType(&soap);
    body->__sizeParamList = 1;
    body->__union_RequestParamTypeParamList = (union ns1__RequestParamType_ParamList *)soap_malloc(&soap, sizeof(*body->__union_RequestParamTypeParamList));
    body->__union_RequestParamTypeParamList->RequestParamType_obj = param;
    req.body = body;

    if (soap_call_ns1__AliDayu(&soap, url, "", &req, &res) == SOAP_OK)
    {
        printf("Result: %s\n", res.body.c_str());
    }
    else
    {
        soap_print_fault(&soap, stderr);
    }

    soap_destroy(&soap);
    soap_end(&soap);
    soap_done(&soap);

    return 0;
}

其中，AliDayuReq和AliDayuRes分别对应阿里云API的请求和响应参数，使用方式类似于示例一。

示例二：调用国家天文台WebService服务

下面是一个调用国家天文台WebService服务的SOAP客户端程序：

#include "soapH.h"
#include "astro.nsmap"

int main()
{
    struct soap soap;
    MoonReq req;
    MoonRes res;

    soap_init(&soap);
    soap_default_MoonReq(&soap, &req);
    soap_default_MoonRes(&soap, &res);
    req.year = 2020;
    req.month = 7;

    if (soap_call_ns1__Moon(&soap, "http://webservices.nextbus.com/service/publicXMLFeed?command=routeConfig&a=rutgers", "", &req, &res) == SOAP_OK)
    {
        printf("Result: %s\n", res.result.c_str());
    }
    else
    {
        soap_print_fault(&soap, stderr);
    }

    soap_destroy(&soap);
    soap_end(&soap);
    soap_done(&soap);

    return 0;
}

其中，MoonReq和MoonRes分别对应国家天文台WebService服务的请求和响应参数，使用方式类似于示例一。需要注意的是，这里的SOAP服务地址是示例地址，需要根据具体情况修改。