How to use gSOAP with Qt for Web Service Client
[toc align_right="yes" depth="3"]
Overview
gSOAP is a portable development toolkit for C and C++ XML Web services and XML data bindings. It supports XML auto-serialization of C/C++ data. Includes WSDL/XSD schema binding tools, stub/skeleton compiler, Web server, SOAP/XML/MIME streaming, XML-RPC. Here is how to use it to build a web service client in Qt.
Preparation
- Download and unzip the "gSOAP package":http://sourceforge.net/projects/gsoap2/.
gSOAP package contains pre-built tools in the <code>gsoap/bin</code> directory.
- <code>wsdl2h</code> schema importer
- <code>soap2cpp</code> stub/skeleton generator.
You require <code>.wsdl</code> and <code>.xsd</code> files of the web service to generate a c++ stub.
Modify your project
- First use <code>wsdl2h</code> on a .wsdl file to generate a .h file, then use <code>soap2cpp</code> on the generated .h file to generate .h and .cpp files to be included in your Qt project.
- Before using <code>wsdl2h</code> you have to modify the <code>typemap.dat</code> file, this file is present in <code>gsoap/ws</code> directory. Add a line in this file defining the namespace of your web service. Give any name to <code>namespace</code> and copy string from your .wsdl file following the tag.
<definitions targetNamespace=http://something&gt;<code>
Add this line to <code&gt;typemap.dat&lt;/code&gt; file:
Anything =”http://something”
- Now run <code>wsdl2h</code> on .wsdl and .xsd files (from command prompt)
wsdl2h –s -t&lt;path of typemap.dat&gt; –o <name of generated .h file e.g chatpp.h&gt; <path and name of .wsdl file&gt;<code>
(note .xsd file should be in same directory as .wsdl file)
* Then use <code&gt;soapcpp2&lt;/code&gt; on generated .h file &#40;we assume that name of generated file is chatapp.h&amp;#41;
soapcpp2 –i chatpp.h
this will generate multiple files
soapstub.h<br />soapH.h<br />soapC.cpp<br />soapchatappProxy.h<br />soapchatappProxy.cpp<br />chatapp.nsmap<br />soapchatappsetvice.h<br />soapchatappservice.cpp
and an xml file for each method in defined in .wsdl file.
- now add
soapstub.h<br />soapH.h<br />soapchatappProxy.h
as headers in to your qt project and then add
soapC.cpp<br />soapchatppProxy.cpp
as source
- add include path of yor generated file in .pro file of your qt project or simply copy all of generated files to your project directory. Also add path of “libws2_32.a” in your .pro file I my case it is as under
LIBS += C:/NokiaQTSDK/mingw/lib/libws2_32.a
- also add stdsoap2.h and stdsoap2.cpp from gsoap directory as header and source in your project.
- now include chatapp.nsmap and chatappProxy.h in your main.cpp.
- make an object of chatappProxy and use it to communicate with webservice.
above method worked for me while using gsoap with NokiaQtSDk on windows xp.