在C++中,一般使用gSOAP来实现客户端、服务端。然而,对小项目来说gSOAP太大了,也不太方便。我们完全可以自己实现SOAP协议,毕竟SOAP协议的本质就是:Http协议+XML。 文章C++中gSOAP的使用介绍了gSOAP的使用,本文就以它的服务端为例,实现一个SOAP客户端。这里需要使用下面两个库:cpp-httplib、tinyxml2。

在C++中,一般使用gSOAP来实现客户端、服务端。然而,对小项目来说gSOAP太大了,也不太方便。我们完全可以自己实现SOAP协议,毕竟SOAP协议的本质就是: Http协议+XML

文章 C++中gSOAP的使用 介绍了gSOAP的使用,本文就以它的服务端为例,实现一个SOAP客户端。这里需要使用下面两个库:

  • cpp-httplib :一个 C++11 单文件头文件跨平台、多线程“阻塞”的 HTTP/HTTPS 库,使用时 只需在项目中包含httplib.h文件
  • tinyxml2 :tinyXML-2 是一个简单、小巧、高效的 C++ XML 解析器,可以轻松集成到其他程序中, 用来代替tinyxml ,使用时 只需在项目中包含 tinyxml2.cpp 和 tinyxml2.h 文件
  • 库的使用方法可以参考以下文章或github:

  • cpp-httplib库简单原理,听说你还不会开源库?
  • TinyXML2 入门教程
  • 实现客户端

    一个SAOP客户端的主要工作流程有3步:构建请求数据的xml、执行Http协议的POST方法、解析响应数据的xml。

    准备xml文件

    准备请求数据、响应数据的xml文件,请求数据的xml文件在项目中作为模板使用,响应数据的xml文件仅用于开发参考不是项目必须的文件。
    请求数据的xml内容如下:

    <?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:ns="http://tempuri.org/ns.xsd">
      <SOAP-ENV:Body>
        <ns:add>
          <a>0</a>
          <b>0</b>
        </ns:add>
      </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

    响应数据的xml内容如下:

    <?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:ns="http://tempuri.org/ns.xsd">
     <SOAP-ENV:Body>
      <ns:addResponse>
       <result>0.0</result>
      </ns:addResponse>
     </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

    引入库文件

    头文件引用如下:

    #include "httplib.h"
    #include"tinyxml2.h" 
    #include <iostream>
    #include <string>
    using namespace std;
    using namespace tinyxml2;
    

    项目文件如下:

    构建请求数据的xml

    使用tinyxml的文档对象加载xml文件,设置文档对象的节点内容,然后返回xml内容,代码如下:

    string CreateReqXml_Add(int a, int b) 
        tinyxml2::XMLDocument doc;
        doc.LoadFile("addReqXML.xml");
        tinyxml2::XMLElement* pNode = doc.FirstChildElement("SOAP-ENV:Envelope")
            ->FirstChildElement("SOAP-ENV:Body")
            ->FirstChildElement("ns:add");
        pNode->FirstChildElement("a")->SetText(a);
        pNode->FirstChildElement("b")->SetText(b);
        XMLPrinter printer;
        doc.Print(&printer);
        return printer.CStr();
    

    执行Http协议的POST方法

    构建一个httplib的客户端对象,直接执行POST方法,代码如下:

    int a = 12;
    int b = 13;
    string strdata = CreateReqXml_Add(a, b);   
    httplib::Client cli("http://localhost:8080");   
    auto res = cli.Post("/", strdata, "text/xml; charset=utf-8");   
    

    注:httplib内部对socket使用了线程锁,可以在多线程中使用一个客户端对象执行Http方法

    解析响应数据的xml

    根据Http方法返回的Result对象判断方法是否成功,Result对象有operator bool() const { return res_ != nullptr; }重载可以直接判断,代码如下:

    if (res)
        cout << res->status << endl;
        cout << res->get_header_value("Content-Type") << endl;
        cout << res->body << endl;
        cout << "Result:" << ParseResXml_Add(res->body) << std::endl;
        cout << "error code: " << res.error() << std::endl;
    

    解析响应数据xml的方法如下:

    string ParseResXml_Add(string xmlStr) 
        tinyxml2::XMLDocument doc;
        doc.Parse(xmlStr.c_str(),xmlStr.length());
        string result= doc.FirstChildElement("SOAP-ENV:Envelope")
            ->FirstChildElement("SOAP-ENV:Body")
            ->FirstChildElement("ns:addResponse")
            ->FirstChildElement("result")->GetText();
        return result;
    

    测试客户端

    先启动服务端,在启动客户端的调试,结果如下:

    text/xml; charset=utf-8 <?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:ns="http://tempuri.org/ns.xsd"><SOAP-ENV:Body><ns:addResponse><result>25</result></ns:addResponse></SOAP-ENV:Body></SOAP-ENV:Envelope> Result:25
  • 使用项目文件(包含服务端程序) 提取码: 4qpm
  • cpp-httplib-master-20210826备份 提取码: n4yg
  • tinyxml2-master-20210921备份 提取码: yjv8
  •