View source for How to use gSOAP with Qt for Web Service Client


[[Category:Developing_with_Qt]]
[[Category:HowTo]]


= 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 [http://sourceforge.net/projects/gsoap2/ gSOAP package].

gSOAP package contains pre-built tools in the '''gsoap/bin''' 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 <tt>wsdl2h</tt> on a .wsdl file to generate a .h file, then use <tt>soap2cpp</tt> on the generated .h file to generate .h and .cpp files to be included in your Qt project.
* Before using <tt>wsdl2h</tt> you have to modify the <tt>typemap.dat</tt> file, this file is present in <tt>gsoap/ws</tt> directory. Add a line in this file defining the namespace of your web service. Give any name to <tt>namespace</tt> and copy string from your .wsdl file following the tag.

<code><definitions targetNamespace=http://something></code>

Add this line to <tt>typemap.dat</tt> file:

<code>Anything ="http://something"</code>

* Now run <tt>wsdl2h</tt> on .wsdl and .xsd files (from command prompt)

<code>wsdl2h –s -t<path of typemap.dat> –o <name of generated .h file e.g chatpp.h> <path and name of .wsdl file></code>

(note .xsd file should be in same directory as .wsdl file)

* Then use <tt>soapcpp2</tt> on generated .h file (we assume that name of generated file is chatapp.h)

<code>soapcpp2 –i chatpp.h</code>

this will generate multiple files

<code>soapstub.h
soapH.h
soapC.cpp
soapchatappProxy.h
soapchatappProxy.cpp
chatapp.nsmap
soapchatappsetvice.h
soapchatappservice.cpp</code>

and an xml file for each method in defined in .wsdl file.

* now add

<code>soapstub.h
soapH.h
soapchatappProxy.h</code>

as headers in to your qt project and then add

<code>soapC.cpp
soapchatppProxy.cpp</code>

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

<code>LIBS += C:/NokiaQTSDK/mingw/lib/libws2_32.a</code>

* 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.''